Capgo Integration with GitHub Actions: Guide

Capgo と GitHub Actions CapgoとCapacitorを組み合わせると、 Capacitor アプリを簡単にアップデートできます。ここでは、この統合の価値を説明します。

• コスト削減: 5年間で最大26,100ドルを削減するCI/CDコスト AppFlow.
• 高速アップデート: 95%のユーザーが24時間以内にアップデートを受け取る
• 安全なデプロイ安全なアップデートを保証するエンドツーエンド暗号化が完了しました。
• ストリーミングされたワークフロー自動ビルドとデプロイを直接あなたの GitHub リポジトリで実行します。

クイックオーバー

1. 要件あなたの GitHub アカウント Capgo アカウント (¥12/月から)、Capgo プロジェクト (from $12/month), Capacitor project, セットアップ.
2. : インストール__CAPGO_KEEP_0__ __CAPGO_KEEP_1__ Capgo CLI と npx @capgo/cli init, GitHub Actions を YAML ワークフローで設定します。
3. デプロイメント: npx @capgo/cli deploy コマンド を.
4. 自動化テスト

::

name: Capgo Deploy  
on:  
  push:  
    branches:  
      - main  

jobs:  
  deploy:  
    runs-on: ubuntu-latest  
    steps:  
      - uses: actions/checkout@v6  
      - uses: actions/setup-node@v3  
        with:  
          node-version: '24'  
      - name: Install Dependencies  
        run: npm install  
      - name: Deploy to Capgo  
        run: npx @capgo/cli deploy  
        env:  
          CAPGO_TOKEN: ${{ secrets.CAPGO_TOKEN }}  

テストチャネル (例: ベータ版、ステージング) から生産用にデプロイします。

GitHub Actions この統合により、迅速、安全、かつコスト効率の高いアプリケーション更新が可能になります。これは、Agile 開発チームにとって理想的なものです。

セットアップ要件

CapgoとCapgo Actionsの統合 GitHubとGitHub Actionsの統合には、必要なツールと設定を準備することが含まれます。

必要なツールとアカウント

以下のアカウントとツールが必要です:

これらの設定が完了したら、Capgo をプロジェクトに追加して自動化されたライブアップデートを実行できます。

追加 Capgo あなたのプロジェクトに

To integrate Capgo, install it in your Capacitor project using its CLI tool. According to Martin Donadieu, founder of Capgo:

“npx @capgo/cli init してください！” [1]

このコマンドはプラグインと必要な依存関係を設定します。

GitHub Repository Setup

Prepare your GitHub repository to meet the requirements for CI/CD integration with Capgo.

価格

Capgo プランは月額 12 ドルから始まります。

• Capgo plans start at $12/month.
• __CAPGO_KEEP_0__
• 分数単位でクレジットを通じて課金される追加ビルド分数。

ここでは、リポジトリの設定方法を紹介します。

• リポジトリ構造: Organize your repository with separate directories for source code, assets, and configuration files to keep everything clean and manageable.
• 環境構成: 開発、ステージング、生産環境を分離し、適切なアクセス制御とセキュリティ対策を実施してください。
• アクセス管理: リポジトリの権限設定を慎重に実施してください。 Capgo統合 を実施しながら、セキュリティを維持してください。

これらの手順を実施することで、GitHub Actionsワークフローに準備が整い、次のセクションで説明するようにワークフローを設定できます。

GitHub Actionsワークフロー設定

自動化 Capgo の GitHub を使用して CI/CD プロセスを streamline する

ワークフロー ファイルの作成

リポジトリのディレクトリ内に YAML ファイルを作成してください。 ここに例があります。 .github/workflows この構成により、安全で自動化されたデプロイが保証されます。 ファイルを設定したら、ワークフローに適切なトリガーを選択してください。

name: Capgo Deploy
on:
  push:
    branches:
      - main
  workflow_dispatch:

jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v6
      - uses: actions/setup-node@v3
        with:
          node-version: '24'
      - name: Install Dependencies
        run: npm install
      - name: Build App
        run: npm run build
      - name: Deploy to Capgo
        run: npx @capgo/cli deploy
        env:
          CAPGO_TOKEN: ${{ secrets.CAPGO_TOKEN }}

ワークフロー トリガー オプション

__CAPGO_KEEP_0__ Actions を使用すると、ワークフローが実行されるタイミングをカスタマイズできます。 以下のトリガー オプションがあります。

GitHub Actions allows you to customize when workflows run. Here are some trigger options:

シークレット キー管理

To ensure secure deployments, you need to manage your secret keys properly. GitHub Actions offers an encrypted secrets management system for this purpose.

安全な認証の設定手順:

1. リポジトリ設定にアクセス
   リポジトリの設定にアクセスし、セキュリティタブの「シークレットと変数」セクションに移動してください。

2. 追加 Capgo Credentials
   Save your Capgo authentication token as a repository secret. Name it CAPGO_TOKEN.

3. ワークフロー内でシークレットを参照
   ワークフロー内で保存したシークレットを参照するには、次のように記述してください。 ${{ secrets.CAPGO_TOKEN }}.

Capgo Commands in Workflows

Once your GitHub Actions environment is set up, you can automate deployments by integrating Capgo CLI commands.

Capgo CLIをインストールする

ワークフローに次のステップを追加して、Capgo CLIをインストールする

steps:
  - name: Install Capgo CLI
    run: npm install -g @capgo/cli
  - name: Initialize Capgo
    run: npx @capgo/cli init

CLIの認証

CLIを安全に認証する CAPGO_TOKEN:

- name: Authenticate Capgo CLI
  run: npx @capgo/cli login
  env:
    CAPGO_TOKEN: ${{ secrets.CAPGO_TOKEN }}

デプロイコマンド

アップデートをビルド、バージョン、デプロイするための主なコマンド

自動化されたデプロイメントプロセスを実行するには、以下のコマンドを組み合わせて使用します。

steps:
  - name: Build and Deploy
    run: |
      npx @capgo/cli build
      npx @capgo/cli version ${{ github.ref_name }}
      npx @capgo/cli deploy
    env:
      CAPGO_TOKEN: ${{ secrets.CAPGO_TOKEN }}

この設定により、ワークフローが実行されるたびに、自動的にビルド、バージョン、デプロイが行われます。 GitHub のシークレット管理システムは、プロセス全体でクレデンシャルを安全に管理します。

テストと修正

テストワークフローを実行する

GitHub アクションワークフローをテストするには、専用の GitHub チャンネルを使用できます。 Capgo testing channel __CAPGO_KEEP_0__ のチャンネルシステムは、異なるステージ用に別々のデプロイパスを作成するのに役立ちます:

- name: Test Build Deployment
  run: |
    npx @capgo/cli build
    npx @capgo/cli deploy --channel beta
  env:
    CAPGO_TOKEN: ${{ secrets.CAPGO_TOKEN }}

Capgo’s channel system helps you create separate deployment paths for different stages:

エラーソリューション

エラー解決

1. 認証エラー

CAPGOのGitHubを確認してください。有効期限が切れていた場合は、再生成して正常な認証を確保してください。

2. ビルドエラー

環境に適合したビルド設定を確保してください。

「私たちはCapgoのOTAアップデートを生産環境に展開し、5,000人以上のユーザーに展開しました。@Capgoに展開した後、ほぼすべてのユーザーが数分以内に最新バージョンにアップデートされていました。」 [1]

3. バージョンコンフリクト

セマンティックバージョニングに従い、バージョンを適切にインクリメントして、展開時にコンフリクトを防ぎましょう。

メンテナンスのヒント

• __CAPGO_KEEP_0__の分析ツールを使用して、更新の成功率を監視してください。 Capgo analytics プルリクエスト（PR）をテストする際は、チャンネルセレクターを使用して、より制御が可能になります。
• __CAPGO_KEEP_0__
• __CAPGO_KEEP_0__
• 最新のCapgo CLIコマンドでワークフローを最新の状態に保つ。

高優先度のデプロイメントでは、Capgoのエラー追跡機能を利用して、潜在的な問題を早期に発見することができます。何か問題が生じた場合、ロールバック機能を使用して、安定したバージョンに戻ることができます。これにより、デプロイメントの混乱を最小限に抑えることができます。これらの慣行は、プロダクションに近づくにつれて、デプロイメントを順調に進めるのに役立ちます。

結論

主なポイント

CapgoのGitHubアクションとの統合により、Capgoアプリのデプロイメントプロセスが簡素化されます。 Capacitorアプリ、開発チームに大きな利益をもたらすデプロイメントプロセスです。更新の成功率は82％、24時間以内に更新を受け取るアクティブユーザーの割合は95％と、効率性が高いこのソリューションは、世界中で注目を集めています。 [1]ここでは、以下のような特徴があります:

自動ワークフロー

• : __CAPGO_KEEP_0__アクションでワークフローを直接設定することで、外部のCI/CDホスティングが必要なくなり、運用コストが削減されます。代替のAppFlowと比較すると、5年間で約$26,100のコスト削減が可能です。: By configuring workflows directly in GitHub Actions, there’s no need for external CI/CD hosting. This approach cuts operational costs, saving about $26,100 over five years compared to alternatives like AppFlow [1].
• __CAPGO_KEEP_0__アプリ：アップデートは即時で、アプリストアの遅延を回避できます。
• 強力なセキュリティ：エンドツーエンドの暗号化により、更新が安全に配信されます。Capgoのチャンネルシステムは、制御されたステージドロールアウトを可能にします。

これらの機能は、よりカスタマイズされたソリューションと改善されたパフォーマンスを実現することを可能にします。これらについては、以下で詳しく説明します。

高度な戦略

CapgoとGitHubアクションズ統合の最大限の利用を得るには、以下の高度な戦術を調べることが推奨されます。

• カスタムAPIワークフロー：CapgoのパブリックAPIを使用して、チームの特定のニーズに合わせたデプロイワークフローを設計できます。これにより、ホワイトラベルエクスペリエンスと既存ツールとのシームレスな統合が可能になります。 [1].
• チャンネルベースのリリース：Capgoのチャンネル機能を使用して、ステージドおよび制御されたアップデートを実現します。
• 最適化されたパフォーマンス：Capgoのパーティアルアップデートを使用して、帯域幅の使用を最小限に抑え、更新を高速化します。750のプロダクションアプリで23.5百万のアップデートが配信されました [1]、システムは大規模な需要を処理する能力を証明しました。

For even better results, consider using Capgo’s self-hosting options or custom API setups. Check earlier sections for detailed setup and testing instructions to fully implement these strategies.

Keep going from Capgo Integration with GitHub Actions: Guide

CapgoのインテグレーションとGitHub Actions:ガイドを使用している場合 Capgo Integration with GitHub Actions: Guide Encryption Encryptionの実装詳細について Compliance Complianceの実装詳細について Capgoのセキュリティスキャナー Capgo Security Scanner for the product workflow in Capgo Security Scanner, Capgo セキュリティ Capgo セキュリティの製品ワークフローについて Capgo 信頼のセンター Capgo 信頼のセンターの製品ワークフローについて