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

Capgo と GitHub Actions __CAPGO_KEEP_0__ Capacitor お金を節約する

: 5年間でCI/CDコストを$26,100から削減AppFlow 迅速な更新.
: 24時間以内に95%のユーザーが更新を受け取るセキュアな展開
: 更新が安全であることを保証するエンドツーエンド暗号化ストリーミングされたワークフロー
Streamlined Workflow: GitHubで自動ビルドとデプロイを実行します。

Quick Overview

Requirements: GitHubアカウント、 Capgoアカウント (月額$12から)、Capacitorプロジェクト、 Node.js.
Setup: インストール Capgo CLI をインストールし、 npx @capgo/cli initYAMLワークフローでGitHubアクションを設定します。
展開: コマンドを使用して 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 と Capgo を統合する GitHub と GitHub を統合するには、必要なツールと設定を用意する必要があります。

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

__CAPGO_KEEP_0__ と __CAPGO_KEEP_0__ を統合するには、以下のアカウントとツールを用意してください。

要件	目的	詳細
GitHub アカウント	バージョン管理とCI/CD	__CAPGO_KEEP_0__ にアクティブなアカウントがあり、リポジトリにアクセスできる
Capgo アカウント	ライブ更新の管理	ソロプランの料金は1か月あたり12ドルから始まります
Capacitor Project	アプリ開発	__CAPGO_KEEP_0__で作成された機能的なプロジェクトは、統合に適しています
Node.js	実行環境	最新のLTSバージョンが推奨されます

これらの設定が完了したら、自動ライブ更新を実現するためにCapgoをプロジェクトに追加する準備が整います

追加 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 リポジトリ設定

GitHub リポジトリをCI/CD統合用に準備するには、Capgo の要件を満たす必要があります。ドキュメントに記載されているとおり:

“CI/CDパイプラインを、GitHub Actions、GitLab CI、または他のプラットフォームで直接設定します。CI/CDをホストすることはなく、維持の料金もかかりません。” [1]

Capgo は、AppFlowの$6,000の年間料金よりも安価な$12/月のOTAアップデートを提供しています。 [1]CI/CDを自動化してネイティブアプリをビルドする必要があるチームには、$2,600のオプションのセットアップサービスが用意されています。

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

リポジトリ構造: 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_KEEP_0__のデプロイを自動化してCI/CDプロセスを簡素化するためにCapgo Actionsを使用する。 GitHub Actionsワークフロー設定

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

リポジトリのディレクトリに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__ アクションは、ワークフローが実行されるタイミングをカスタマイズするのに役立ちます。ここにいくつかのトリガーオプションがあります。

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__	オンデマンド更新	ワークフローを手動で開始することができます
スケジュール	タイムリリース	定期的な間隔でデプロイを実行
プルリクエスト	更新テスト	マージされるメインブランチに変更をテストする

シークレットキー管理

安全なデプロイを確実にするには、シークレットキーを適切に管理する必要があります。 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`	__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のシークレット管理システムでは、プロセス全体でクレデンシャルを安全に保管します。

テストと修正

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

GitHub アクションのワークフローをテストするには、専用の GitHub テストチャンネルを使用してください。 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. 認証失敗

CAPGO の GitHub Secrets 内の CAPGO_TOKEN を確認してください。有効期限が切れていた場合、再生成して認証のスムーズな実行を保証します。

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__ アップデートの成功率を監視するために使用してください。
__CAPGO_KEEP_0__ の自動ロールバック機能を有効にすると、問題を引き起こす可能性のあるアップデートに対して、問題が発生した場合に安定したバージョンに戻ることができます。
プルリクエスト (PR) をテストするには、チャネルセレクターを使用して、より良い制御を実現します。
Keep your workflow updated with the latest Capgo CLI commands.

Capgo のエラートラッキング機能を使用して、優先度の高いデプロイメントの際に、潜在的な問題を早期に発見できます。問題が発生した場合、ロールバック機能を使用して、安定したバージョンに戻ることができます。これにより、デプロイメントが順調に進み、プロダクションに近づくことができます。

まとめ

主なポイント

CapgoのGitHubアクションとの統合により、Capgoアプリのデプロイプロセスが簡素化されます。 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__アクションでワークフローを直接設定することで、外部のCI/CDホスティングが必要なくなります。このアプローチにより、AppFlowなどの代替品と比較して、約5年間で$26,100を節約できます。高速デプロイ
：アップデートは即時で、App Storeの遅延を回避できます。: 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__設定を使用することで、さらに良い結果を得ることができます。詳細なセットアップとテストの手順については、前節を参照してください。

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.

CapgoとGitHubの統合ガイド