Capgo と GitHub の統合:ガイド

Capgo と GitHub Actions __CAPGO_KEEP_0__ Capacitor コストを削減

• : 5 年間で CI/CD コストを $26,100 まで削減することができます。高速な更新 : 95% のユーザーが 24 時間以内に更新を受け取ることができます。.
• セキュアな展開: エンドツーエンドの暗号化により、更新は安全です。
• フローStreamlined Workflow
• AppFlow: GitHubで自動ビルドとデプロイを実行します。

Quick Overview

1. Requirements: GitHubアカウント、 Capgoアカウント (月額$12から)、Capacitorプロジェクト、 Node.js.
2. Setup: インストール Capgo CLI を使用して npx @capgo/cli init, GitHub ActionsをYAMLワークフローで設定します。
3. 展開: 以下のコマンドを使用して npx @capgo/cli deploy を 自動更新を.
4. テスト: 生産環境よりも先にベータ版、ステージング版などテストチャンネルに展開してテストする。

例のワークフロー (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パイプライン

セットアップ要件

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

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

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

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

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

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

capgoのcliの__CAPGO_KEEP_2__ツールを使用してcapgoをcliプロジェクトにインストールする必要があります。 [1]

「npx @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__ init してください！」—マーティン・ドナディュー氏、__CAPGO_KEEP_3__の創設者

GitHub Repository Setup

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

__CAPGO_KEEP_0__ リポジトリをCI/CD統合用に__CAPGO_KEEP_1__と準備する必要があります。

ワークフローを追加する前に、リポジトリが必要なシークレット、ブランチ保護、デプロイトリガーを備えていることを確認してください。

• Capgo plans start at $12/month.
• __CAPGO_KEEP_0__のプランは月額12ドルから始まります。
• 同じプランにはOTA更新と月に約15回のネイティブビルドが含まれます。

追加のビルド分数はクレジット単位で分単位で請求されます。

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

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

GitHub Actions Workflow Setup

__CAPGO_KEEP_0__ Capgo deployments GitHub のアクションを使用して、CI/CD プロセスを簡素化します。

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

ワークフロー ファイルを作成するには、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:

シークレットキー管理

GitHubアクションは、シークレットキーの管理を暗号化して安全に実行するために、暗号化されたシークレットキーマネージャーシステムを提供します。

セキュアな認証をセットアップする手順:

1. リポジトリ設定にアクセス
   リポジトリの設定に移動し、「Security」タブの下の「Secrets and variables」セクションで「__CAPGO_KEEP_0__ クレデンシャル」を追加

2. 「__CAPGO_KEEP_0__ クレデンシャル」を保存 「Capgo 認証トークン」をリポジトリシークレットとして保存。名前を
   Save your Capgo authentication token as a repository secret. Name it CAPGO_TOKEN.

3. ワークフローで保存したシークレットを参照して使用する
   「__CAPGO_KEEP_0__ コマンド」をワークフローで使用する ${{ secrets.CAPGO_TOKEN }}.

「Capgo」環境がセットアップされたら、自動デプロイを実行するために「__CAPGO_KEEP_1__」、「__CAPGO_KEEP_2__」コマンドを統合する

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

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

Add the following step to your workflow to install the 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__

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アクションワークフローをテストするには、専用の Capgoテストチャンネルを使用できます。この機能により、更新が公開される前に検証することができます。

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

Capgoのチャンネルシステムは、異なるステージ用に別々のデプロイパスを作成するのを支援します:

エラーソリューション

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

1. 認証失敗

CAPGO_TOKENのGitHubシークレット内を確認してください。有効期限が切れていた場合は、再生成して認証のスムーズな実行を保証してください。

2. ビルドエラー

ビルド設定を、展開環境の要件に合わせてください。

「CapgoのOTA更新を生産環境でCapgoのユーザーに展開しました。Capgoのユーザーがほぼ全員、CapgoのOTAが展開された後で数分以内に最新の状態に更新されました。」 [1]

3. バージョン間の競合

バージョン管理を適切に行うことで、展開時に競合が発生するのを防ぎましょう。

メンテナンスのヒント

• 「__CAPGO_KEEP_0__の分析ツールを使用して、更新の成功率を監視することができます。 Capgo analytics プルリクエスト（PR）をテストする際に、チャネルセレクターを使用することで、より制御が可能になります。
• 最新の__CAPGO_KEEP_0__ __CAPGO_KEEP_1__コマンドを使用して、ワークフローを最新の状態に保ちましょう。
• 優先度の高い展開では、__CAPGO_KEEP_0__のエラートラッキング機能を利用して、潜在的な問題を早期に発見することができます。問題が発生した場合、ロールバック機能を使用して、安定したバージョンに戻ることができます。これにより、障害が最小限に抑えられ、展開が順調に進むことができます。
• Keep your workflow updated with the latest Capgo CLI commands.

For high-priority deployments, take advantage of Capgo’s error tracking to spot potential issues early. If something goes wrong, the rollback feature allows you to revert to a stable version quickly, minimizing disruption. These practices will help keep your deployments running smoothly as you move closer to production.

結果

主なポイント

CapgoのGitHubアクションとの統合により、 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を節約できます。: Capgoでエンドツーヘンドの暗号化を使用すると、更新が安全に配信され、Capgoのチャンネルシステムを使用すると、制御されたステージドロールアウトが可能になります。

These features pave the way for more tailored solutions and improved performance, explored further below.

高度な戦略

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.

Keep going from Capgo Integration with GitHub Actions: Guide

__CAPGO_KEEP_1__と連携して進めましょう Capgo Integration with GitHub Actions: Guide __CAPGO_KEEP_0__を使用している場合 __CAPGO_KEEP_0__と連携して進めましょう セキュリティとコンプライアンスの計画を行う場合に接続する 暗号化 暗号化の実装詳細 Capgo Security Scanner for the product workflow in Capgo Security Scanner, Capgo セキュリティ スキャナー Capgo セキュリティ スキャナーにおける製品ワークフローに接続してください Capgo の信頼センター 製品ワークフローについての Capgo の信頼センター。