Capgo と GitHub アクションの統合: ガイド

Capgo と GitHub Actions を組み合わせて、アプリケーション更新のデプロイを簡素化します。 Capacitor アプリケーション。ここで、この統合の価値を理解する理由があります。

コストを削減: 5 年間で CI/CD コストを $26,100 まで削減する AppFlow.
高速な更新: 95% のユーザーが 24 時間以内に更新を受け取る
セキュアなデプロイ: エンドツーエンドの暗号化により、更新は安全です。
ストリーミングされたワークフロー: GitHub リポジトリ内で自動化されたビルドとデプロイ

クイックな概要

要件: GitHub アカウント、 Capgo アカウント (月額 $12/月から)、 Capacitor プロジェクト、 Node.js.
セットアップ: インストール Capgo CLI と npx @capgo/cli init, GitHub Actions を YAML ワークフローで構成する。
デプロイ: コマンドなどを使用 npx @capgo/cli deploy を自動更新を自動化する.
テスト: テストチャネル (例: ベータ版、ステージング) から生産用にデプロイする

例ワークフロー (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 }}

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

GitHub アクションチュートリアル - 基本概念と CI/CD パイプライン

GitHub アクション

セットアップ要件

Capgo を統合する GitHub アクションには、必要なツールと設定を設定することが含まれます。

保護されたツールとアカウント

必要なアカウントとツールが用意されていることを確認してください。

要件	目的	詳細
GitHub アカウント	バージョン管理とCI/CD	リポジトリにアクセスできる有効なアカウント
Capgo アカウント	ライブ更新の管理	プランは $12/月から始まります
Capacitor Project	アプリ開発	__CAPGO_KEEP_0__ を使用した機能的なプロジェクトは、統合に適しています
Node.js	実行環境	最新のLTSバージョンを推奨します

これらの設定が完了したら、Capgo をプロジェクトに追加して、自動ライブ更新を実行できます

追加 Capgo プロジェクトに__CAPGO_KEEP_0__を追加する

Capgo ライブ更新ダッシュボードインターフェイス

Capgo を統合するには、Capacitor プロジェクトに CLI ツールを使用してインストールします。マーティン・ドナディュー氏（Capgo の創設者）によると、

“Run npx @capgo/cli init that it!” [1]

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

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

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

ワークフローを追加する前に、リポジトリが必要なシークレット、ブランチ保護、デプロイトリガーを含むOTAリリースプロセスに必要なものかどうかを確認してください。

価格

Capgo プランは月額12ドルから始まります。
同一のプランには、月に約15回のネイティブビルドとOTA更新が含まれます。
追加のビルド分数は、クレジットを通じて1分あたりに請求されます。

リポジトリのセットアップ方法はこちらです。

リポジトリ構造リポジトリをソースcode、アセット、設定ファイル用の別々のディレクトリで構成することで、すべてをきれいに管理しやすくしてください。
環境設定: 開発、ステージング、および生産用に異なる環境を設定し、適切なアクセス制御とセキュリティ対策を実施する。
アクセス管理: リポジトリの権限を慎重に設定して Capgo統合を許可しながら、セキュリティを維持する。

これらのステップは、次のセクションで説明されるGitHub Actionsワークフローにプロジェクトを準備する。

GitHub Actionsワークフロー設定

__CAPGO_KEEP_0__のデプロイを自動化してCI/CDプロセスをstreamlineするためにCapgo Actionsを使用する。 GitHubワークフローファイルの作成

Environment Configuration

__CAPGO_KEEP_0__で始めてください。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:

使用シナリオ	設定	Push イベント
__CAPGO_KEEP_0__の変更に応じてデプロイ	特定のブランチにcodeがプッシュされたときにアクティブ	Activates when code is pushed to specific branches
__CAPGO_KEEP_0__の変更に応じてデプロイ	On-demand updates	ワークフローを手動で開始することができます。
スケジュール	タイムリリース	定期的なデプロイ
プルリクエスト	更新テスト	マージされるメインブランチに変更をテストする

シークレットキー管理

シークレットキーを適切に管理することで、安全なデプロイを保証することができます。 GitHub Actionsには、暗号化されたシークレットキーマネジメントシステムが用意されています。

安全な認証設定の手順:

リポジトリ設定へのアクセス
リポジトリの設定に移動し、「Security」タブの下にある「Secrets and variables」セクションを探してください。
追加 Capgo のクレデンシャル
Capgo の認証トークンをリポジトリのシークレットとして保存してください。名前を CAPGO_TOKEN.
ワークフロー内でシークレットを参照する
ワークフロー内で保存したシークレットを参照して使用するには、次のように記述してください。 ${{ secrets.CAPGO_TOKEN }}.

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

GitHub アクション環境を設定した後、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 }}

展開コマンド

__CAPGO_KEEP_0__のアップデートを管理するための重要なコマンドがこちらです。

コマンド	目的	使用例
`build`	__CAPGO_KEEP_0__のアップデート用の生産用パッケージを生成します。	`npx @capgo/cli build`
`deploy`	Capgoにアップデートをプッシュします。	`npx @capgo/cli deploy`
`version`	__CAPGO_KEEP_0__のアップデートのバージョンを設定します。	`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のシークレット管理システムでは、プロセス全体でクレデンシャルを安全に保管します。

テストと修正

Running Test Workflows

GitHubのテストワークフローを実行するには、専用の Capgoテストチャンネルを使用してください。

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

__CAPGO_KEEP_0__のチャンネルシステムは、異なるステージ用に別々のデプロイパスを作成するのを支援します：	チャンネル	目的
対象読者	beta	プレリリーステスト
内部チーム用のテスト環境	QA 検証	テストユーザー
本番	ライブデプロイ	全ユーザー

エラー解決

以下は、一般的な統合問題と対処方法です。

1. 認証失敗

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

2. ビルドエラー

ビルド設定がデプロイ環境の要件と一致していることを確認してください。

“We rolled out Capgo OTA updates in production for our user base of +5000. We’re seeing very smooth operation almost all our users are upto date within minutes of the OTA being deployed to @Capgo.” [1]

3. バージョン間の競合

デプロイメントの際に競合を防ぐために、正しくバージョンをインクリメントし、シーケンスバージョニングに従ってください。

メンテナンスのヒント

使用 Capgo アナリティクス __CAPGO_KEEP_0__ の更新成功率を監視するために使用してください。
更新が問題を引き起こす可能性がある場合、自動ロールバックを有効にします。
プルリクエスト (PR) をテストするためにチャネルセレクターを使用して、より良い制御を実現します。
Keep your workflow updated with the latest Capgo CLI commands.

Capgo のエラートラッキング機能を利用して、優先順位の高いデプロイメントの際に潜在的な問題を早期に特定できます。何かが不正に動作する場合、ロールバック機能を使用して、安定したバージョンに戻ることができます。これにより、デプロイメントが正常に実行されるようになり、プロダクションに近づくにつれて、混乱を最小限に抑えることができます。

まとめ

主なポイント

CapgoのGitHub Actionsとの統合により、 Capacitorアプリの展開プロセスが簡素化され、開発チームに大きな利益をもたらします。 [1]アップデートのグローバル成功率82％、24時間以内にアップデートを受信するアクティブユーザーの95％を誇ります。

このソリューションは、効率性で際立っています。

以下の機能が特に目立っています。: 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__ Actionsでワークフローを直接設定することで、外部のCI/CDホスティングが必要なくなり、オペレーションコストが約$26,100で5年間で削減され、代替のAppFlowと比較して即時更新
：アプリストアの遅延を回避して、更新を即時プッシュできます。: End-to-end encryption ensures updates are delivered securely, while Capgo’s channel system allows for controlled, staged rollouts.

：エンドツーエンドの暗号化により、更新が安全に配信され、__CAPGO_KEEP_0__のチャンネルシステムにより、制御されたステージドロールアウトが可能です。

高度な戦略

CapgoとGitHubアクションの統合を最大限に活用するには、次の高度な戦術を調べることができます:

カスタムAPIワークフロー: CapgoのパブリックAPIを使用して、チームの特定のニーズに合ったデプロイワークフローを設計できます。この機能により、白ラベルエクスペリエンスと既存ツールとのシームレスな統合が可能になります。 [1].
チャネルベースのリリース: Capgoのチャネル機能を使用して、段階的かつ制御されたアップデートを実行し、デプロイプロセスを最適化できます。
最適化されたパフォーマンス: Capgoのパーティアルアップデートを使用して、帯域幅の使用量を削減し、更新を高速化します。750のプロダクションアプリケーションを通じて、23.5百万のアップデートを配信したことで、システムは大規模な要求に対応する能力を証明しました。 [1]より良い結果を得るには、__CAPGO_KEEP_0__の自主的なホスティングオプションやカスタム__CAPGO_KEEP_1__セットアップを考慮してください。詳細なセットアップとテストの指示については、前のセクションを参照してください。

CapgoとAPIアクションの統合: ガイド

Keep going from Capgo Integration with GitHub Actions: Guide

__CAPGO_KEEP_0__を使用している場合 CapgoとGitHubの統合:ガイド __CAPGO_KEEP_0__と接続して暗号化暗号化の実装詳細について法的合致法的合致の実装詳細について Capgo セキュリティスキャナー Capgo セキュリティスキャナーにおける製品ワークフローについて Capgo セキュリティ Capgo セキュリティにおける製品ワークフローについて Capgo トラストセンター Capgo トラストセンターにおける製品ワークフローについて

Capgo と GitHub の統合: ガイド