Capgo と GitHub Actions の連携ガイド

Capgo と GitHub アクション連携により、アプリへのアップデート配信をよりシンプルに Capacitor します。この連携が注目されるべき理由:

コスト削減: 5年間で最大26,100ドルのCI/CDコストを削減 AppFlow.
高速アップデート: 95%のユーザーが24時間以内にアップデートを受信。即時プッシュ
セキュアなデプロイ: エンドツーエンド暗号化により、アップデートの安全性を確保。
ワークフローの最適化: GitHub リポジトリ内でビルドとデプロイを自動化

概要

要件: GitHub アカウント、 Capgo アカウント (月額12ドルから)、Capacitor プロジェクト、 Node.js.
セットアップ: インストール Capgo CLI を使用して npx @capgo/cli init、YAML ワークフローで GitHub Actions を設定します。
デプロイ「capgo bundle upload」などのコマンドを使用します npx @capgo/cli deploy まで更新の自動化.
テスト本番環境の前に、テストチャネル（例: beta, staging）にデプロイします。

ワークフローの例 (YAML):

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 アクションチュートリアル - 基本概念とCI/CDパイプライン

GitHub アクション

セットアップ要件

Capgo の統合 GitHub Actions との統合には、必要なツールと設定の準備が必要です。

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

以下のアカウントとツールが準備できていることを確認してください：

要件	目的	詳細
GitHub アカウント	バージョン管理 & CI/CD	リポジトリにアクセスできるアクティブなアカウント
Capgo アカウント	Live Update の管理	プランは月額12ドルから
Capacitor プロジェクト	アプリ開発	統合できる状態の動作するプロジェクト
Node.js	ランタイム環境	最新のLTSバージョン推奨

これらが揃ったら、自動ライブアップデートのために Capgo をプロジェクトに追加できます。

プロジェクトへの Capgo 追加

Capgo Live Update ダッシュボードインターフェース

Capgo を統合するには、CLI ツールを使用して Capacitor プロジェクトにインストールします。Capgo の創設者である Martin Donadieu によると：

「npx @capgo/cli init を実行するだけで完了です！」 [1]

このコマンドにより、プラグインと必要な依存関係がセットアップされます。

GitHub リポジトリのセットアップ

Capgo との CI/CD 連携に必要な要件を満たすよう、GitHub リポジトリを準備します。

ワークフローを追加する前に、OTA リリースプロセスに必要な secrets、ブランチ保護、デプロイトリガーがリポジトリに設定されているか確認してください。

料金プラン

Capgo のプランは月額 $12 からです。
同プランには OTA アップデートと、月間約 15 回の Native Build が含まれています。
追加のビルド時間は、クレジットで分単位に課金されます。

リポジトリのセットアップ手順は以下の通りです：

リポジトリ構成: ソース code、アセット、設定ファイルを別々のディレクトリに整理し、クリーンで管理しやすい状態を保ちます。
環境設定: 開発、ステージング、本番用の環境を明確に分け、適切なアクセス制御とセキュリティ対策を講じてください。
アクセス管理：セキュリティを維持しつつ、許可を付与するためにリポジトリの権限を慎重に設定します Capgo の統合セキュリティを維持しながら。

これらの手順により、次のセクションで説明する GitHub Actions ワークフローに対応したプロジェクトの準備が整います。

GitHub Actions ワークフローの設定

あなたの Capgo デプロイを GitHub Actions を使用して自動化し、CI/CD プロセスを効率化します。

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

リポジトリの .github/workflows ディレクトリにYAMLファイルを作成することから始めます。例:

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 }}

この設定により、安全で自動化されたデプロイが実現します。ファイルを設定したら、ワークフローに適したトリガーを選択してください。

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

GitHub Actionsでは、ワークフローの実行タイミングをカスタマイズできます。トリガーオプションの例:

トリガーの種類	ユースケース	設定
Pushイベント	codeの変更時にデプロイ	特定のブランチにcodeがpushされると実行
手動ディスパッチ	オンデマンド更新	ワークフローを手動で開始できます
スケジュール	定期リリース	設定した間隔でデプロイを実行します
プルリクエスト	アップデートのテスト	メインブランチへのマージ前に変更内容をテストします

シークレットキーの管理

安全なデプロイを実現するには、シークレットキーを適切に管理する必要があります。GitHub Actionsには、そのための暗号化されたシークレット管理システムが備わっています。

安全な認証設定の手順:

リポジトリ設定にアクセス
リポジトリの設定を開き、「Security」タブ内の「Secrets and variables」セクションを探します。
追加 Capgo 認証情報
Capgo の認証トークンをリポジトリのシークレットとして保存します。名前を付けます。 CAPGO_TOKEN.
ワークフローでのシークレット参照
保存したシークレットをワークフロー内で次のように参照して使用します: ${{ secrets.CAPGO_TOKEN }}.

ワークフローでの Capgo コマンド

GitHub Actions 環境を設定したら、Capgo CLI コマンドを組み込んでデプロイを自動化できます。

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 }}

デプロイコマンド

アップデートのビルド、バージョン管理、デプロイを行う主要なコマンドは次のとおりです:

コマンド	目的	使用例
`build`	生成します本番環境対応のバンドル	`npx @capgo/cli build`
`deploy`	アップデートを Capgo にプッシュします	`npx @capgo/cli deploy`
`version`	アップデートのバージョンを設定します	`npx @capgo/cli version 1.2.0`

デプロイプロセス全体を自動化するには、次のようにコマンドを組み合わせます:

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 Actionsワークフローを使用してテストできます Capgo テストチャネル。これにより、本番環境に反映する前に更新を検証できます。

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

Capgo のチャネルシステムにより、異なるステージごとに個別のデプロイパスを作成できます：

チャンネル	目的	ターゲット層
ベータ	リリース前テスト	社内チーム
ステージング	QA検証	テストユーザー
本番	ライブデプロイ	すべてのユーザー

エラーの解決策

統合でよくある問題と対処法は次のとおりです：

1. 認証失敗

GitHub の Secrets にある CAPGO_TOKEN を確認してください。期限切れなら、認証をスムーズに行うために再生成してください。

2. ビルドエラー

ビルド設定がデプロイ環境の要件を満たしているか確認してください。

「5,000人以上のユーザーがいる本番環境で、Capgo のOTAアップデートをロールアウトしました。非常にスムーズに動作しており、@Capgo にOTAがデプロイされてから数分以内に、ほぼ全ユーザーが最新の状態になっています。」 [1]

3. バージョン競合

デプロイ時の競合を防ぐため、セマンティックバージョニングに従って適切にバージョンを上げてください。

メンテナンスのコツ

使用する Capgo アナリティクスで、アップデートの成功率を監視します。
問題を引き起こす可能性のあるアップデートには、自動ロールバックを有効にしてください。
チャネルセレクターを使用してプルリクエスト（PR）をテストし、より良い制御を実現します。
ワークフローを最新の Capgo CLI コマンドに更新してください。

優先度の高いデプロイでは、Capgo のエラートラッキングを活用して、潜在的な問題を早期に発見しましょう。問題が発生した場合、ロールバック機能により安定したバージョンに素早く戻すことができ、影響を最小限に抑えられます。これらの実践により、本番環境への移行に伴い、デプロイがスムーズに実行されるようになります。

まとめ

ハイライト

CapgoのGitHub Actionsとの統合により、デプロイプロセスが簡素化されます Capacitor アプリ。開発チームに大きなメリットをもたらします。グローバルでの更新成功率は82%、アクティブユーザーの95%が24時間以内に更新を受け取れます [1]。このソリューションは、その効率性で際立っています。

主な特長は以下の通りです：

自動化されたワークフロー：GitHub Actionsでワークフローを直接設定できるため、外部のCI/CDホスティングは不要です。AppFlowなどの代替手段と比較して、5年間で約26,100ドルの運用コスト削減が見込めます [1].
高速なデプロイ：アプリストアの遅延を回避し、更新を即座にプッシュできます。
強力なセキュリティ：エンドツーエンドの暗号化により、更新が安全に配信されます。また、Capgoのチャネルシステムにより、段階的なロールアウトを制御できます。

これらの機能により、よりきめ細かなソリューションとパフォーマンスの向上が可能になります。以下で詳しく見ていきましょう。

高度な戦略

Capgo と GitHub Actions の統合から最大限の効果を得るために、これらの高度な戦術を検討してください。

カスタム API ワークフロー：Capgo のパブリック API を活用し、チームのニーズに合ったデプロイワークフローを設計します。これにより、ホワイトラベル体験や既存ツールとのシームレスな統合が可能になります。 [1].
チャネルベースのリリース：Capgo のチャネル機能を活用して段階的かつ制御された更新を行い、デプロイプロセスを最適化します。
最適化されたパフォーマンス：Capgo の部分更新を活用して帯域幅の使用量を削減し、更新速度を向上させます。750の本番アプリで2,350万回の更新が配信されました。 [1]大規模な需要に対応できることが実証されています。

さらに良い結果を得るには、Capgo のセルフホスティングオプションやカスタム API セットアップを検討してください。これらの戦略を完全に実装するには、詳細なセットアップとテスト手順を以前のセクションで確認してください。

Capgo と GitHub Actions の統合：ガイドから続けます

使用している場合 Capgo と GitHub Actions の連携ガイド セキュリティとコンプライアンスを計画するには、これを以下と連携させてください暗号化暗号化の実装詳細についてコンプライアンスコンプライアンスの実装詳細について Capgo セキュリティスキャナー Capgo Security Scanner のプロダクトワークフローについて Capgo のセキュリティ Capgo Security のプロダクトワークフロー向け、および Capgo トラストセンター Capgo Trust Center のプロダクトワークフロー向け。