Capgo と GitHub の統合ガイド

Capgo そして GitHubアクション一緒にアップデートの展開を簡素化します。 Capacitor アプリケーション。ここでは、この統合の価値をご覧いただける理由があります。

お金を節約する5年間で、CI/CDコストを$26,100削減することができます。 AppFlow.
高速更新即時更新
: 24時間以内に95%のユーザーが更新を受け取ることができます。安全な展開
: 更新が安全であることを保証するエンドツーワンエンドの暗号化が行われます。自動ビルドとデプロイを GitHub リポジトリ内で直接自動化することができます。

: __CAPGO_KEEP_0__ リポジトリで直接ビルドと展開を自動化できます。

概要: GitHub アカウント, : Capgo アカウント、（1,200円/月から）、Capacitorプロジェクト、 Node.js.
セットアップインストール Capgo CLI と npx @capgo/cli init、YAMLワークフローで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 Actions の統合 GitHub と GitHub Actions の統合には、必要なツールと設定を設定することが含まれます。

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

以下のアカウントとツールが用意されていることを確認してください:

要件	目的	目的
GitHub アカウント	バージョン管理 & CI/CD	リポジトリへのアクセス権を持つ有効なアカウント
Capgo アカウント	ライブアップデートの管理	プランは 1 か月あたり 12 ドルから
Capacitor プロジェクト	アプリケーション開発	統合に適した機能のあるプロジェクト
Node.js	ランタイム環境	最新のLTSバージョンが推奨されます

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

追加 Capgo コンテキスト:Capgo UIの長い文字列から取り出されたHTMLテキストフラグメント (親キー `submitting_a_pr_to_capgo`). ページ/エリア:Capgoのマーケティングウェブサイト。役割:ウェブサイトのコピー。見られる場所:contributing.astroページ。Capgoの製品/ブランド名と開発者用語を厳密に保存してください。

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

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]

“npx @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__ init してください！”

GitHub リポジトリの設定

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

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

料金

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

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

リポジトリ構造: Organize your repository with separate directories for source code, assets, and configuration files to keep everything clean and manageable.
環境構成:開発、ステージング、プロダクション用に異なる環境を作成し、適切なアクセス制御とセキュリティ対策を実施してください。
アクセス管理: 仓庫の権限を慎重に設定してください。 Capgo integration 安全性を維持しながら

These steps will ensure your project is ready for the GitHub Actions workflow, which will be outlined in the next section.

GitHub GitHub Actions ワークフロー設定

自動化して Capgo deployment using GitHub Actions to streamline your CI/CD process.

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

まず、リポジトリのディレクトリ内に 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 アクションは、ワークフローが実行されるタイミングをカスタマイズできるようにします。以下のトリガオプションがあります。

トリガタイプ	用途	Configuration
設定	Capgoでcodeに変更をデプロイする	code の変更をデプロイ
__CAPGO_KEEP_0__ が特定のブランチにプッシュされたときにアクティブ	マニュアルディスパッチ	オンデマンドアップデート
Schedule	リリースのタイミング	定期的なデプロイ
プルリクエスト	更新のテスト	メインブランチにマージする前に変更をテストする

シークレットキー管理

シークレットキーを適切に管理することで、安全なデプロイを確保できます。 GitHub Actionsは、暗号化されたシークレット管理システムを提供しています。

安全な認証を設定する手順:

リポジトリ設定へのアクセス
リポジトリの設定に移動し、セキュリティタブの「シークレットと変数」セクションに移動してください。
追加 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 }}

デプロイメントコマンド

アップデートをビルド、バージョン、デプロイするための重要なコマンドを以下に示します。

コマンド	目的	Usage Example
`build`	生成します生産環境に適したパッケージ	`npx @capgo/cli build`
`deploy`	Capgoは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 }}

This setup ensures that your updates are automatically built, versioned, and deployed whenever the workflow runs. GitHub’s secret management system keeps your credentials safe throughout the process.

テストと修正

テストワークフロー実行

GitHub Actions ワークフローをテストするには、専用の Capgo テストチャンネル.__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のチャンネルシステムにより、異なるステージ用に別々のデプロイパスを作成できます。

チャンネル	目的	対象
ベータ	プレリリーステスト	内部チーム
ステージング	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_KEEP_0__ OTA更新を生産環境で +5000 のユーザーに展開しました。私たちは、非常に滑らかな動作を実現し、@__CAPGO_KEEP_1__ への OTA の展開後、ほぼすべてのユーザーが数分以内に最新バージョンにアップデートされました」という報告がありました。

バージョンコンフリクト

シーケンスバージョニングに従ってバージョンを適切にインクリメントしてください。デプロイメント中のコンフリクトを防ぐようにしてください。

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

優先順位の高いデプロイメントでは、Capgo のエラー追跡機能を利用して、潜在的な問題を早期に発見することができます。何かが不正に動作したら、ロールバック機能を使用して、安定したバージョンに戻ることができます。これにより、プロダクションに近づくにつれて、デプロイメントが順調に進むことが保証されます。

まとめ

主なポイント

CapgoのGitHubアクションとの統合により、 Capacitor__CAPGO_KEEP_1__ [1]、この解決策は効率性で際立っています。

以下の主な機能があります:

自動ワークフロー: GitHub Actionsでワークフローを直接設定することで、外部のCI/CDホスティングが必要なくなり、運用コストが約$26,100で5年間で削減されます。代替のAppFlowと比較して。 [1].
高速の展開: アプリストアの遅延を回避して、即時でアップデートをプッシュできます。
強固なセキュリティ: 終端から終端までの暗号化により、更新が安全に配信され、Capgoのチャンネルシステムにより、制御されたステージドロールアウトが可能です。

これらの機能は、以下の詳細でさらに探索できるように、よりカスタマイズされた解決策と改善されたパフォーマンスの道を開いています。

高度な戦略

: CapgoとGitHub Actionsの統合を最大限に活用するには、以下の高度な戦術を探索してください。

カスタムAPIワークフロー: Capgoの公開APIを使用して、チームのニーズに合わせたデプロイワークフローを設計します。この機能により、白ラベルエクスペリエンスと既存ツールとのシームレスな統合が可能になります。 [1].
チャンネルベースのリリース: Capgoのチャンネル機能を使用して、段階的で制御されたアップデートを実施し、デプロイプロセスを最適化します。
パフォーマンスの最適化: Capgoの部分アップデートを利用して、帯域幅の使用量を削減し、更新を高速化します。750のプロダクションアプリケーションを通じて、23.5万回のアップデートを実施した結果、システムは大規模な要求に対応する能力を証明しました。 [1]システムは大規模な要求を処理する能力を証明した。

Keep going from Capgo Integration with API Actions: Guide

If you are using Capgo Integration with GitHub Actions: Guide

to plan security and compliance, connect it with __CAPGO_KEEP_0__ Capgo と GitHub の統合ガイド __CAPGO_KEEP_0__と__CAPGO_KEEP_1__の統合ガイド Encryption __CAPGO_KEEP_0__ 法的適合性 __CAPGO_KEEP_0__ Capgo セキュリティスキャナー Capgo セキュリティスキャナーの製品ワークフロー Capgo セキュリティ Capgo セキュリティの製品ワークフロー Capgo トラストセンター Capgo トラストセンターの製品ワークフロー