Capgo と GitHub の統合: ガイド

Capgo と GitHub アクション を組み合わせて、__CAPGO_KEEP_0__ アプリの更新を簡素化します。ここで、この統合の価値をご覧ください: Capacitor CI/CD のコストを $26,100 まで削減することができます。5 年間で、AppFlow と比較して

• 迅速な更新__CAPGO_KEEP_1__ アプリの迅速な更新を実現します。 __CAPGO_KEEP_1__.
• __CAPGO_KEEP_1__: __CAPGO_KEEP_0__を即時更新する。95%のユーザーが24時間以内に更新を受け取る。
• セキュアなデプロイ: エンドツーエンドの暗号化により、更新は安全です。
• ストリーミングされたワークフロー: GitHub リポジトリに直接自動ビルドおよびデプロイを行います。

クイックオーバー

1. 要件: GitHub アカウント、 Capgo アカウント (月額 $12 から)、Capacitor プロジェクト、 Node.js.
2. セットアップ: インストール Capgo CLI と npx @capgo/cli init, GitHub アクションを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 Pipelining

セットアップ要件

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

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

__CAPGO_KEEP_0__アクションの統合には、必要なアカウントとツールを用意する必要があります。

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

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

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の要件を満たす必要があります。

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

料金

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

リポジトリを設定する方法はこちらです。

• リポジトリ構造: 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 のデプロイ GitHub Actions を使用して 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:

Managing Secret Keys

To ensure secure deployments, you need to manage your secret keys properly. GitHub Actions offers an encrypted secrets management system for this purpose.

Steps to Set Up Secure Authentication:

1. Access Repository Settings
   Go to your repository’s settings and find the “Secrets and variables” section under the “Security” tab.

2. Add Capgo Credentials
   Save your Capgo authentication token as a repository secret. Name it CAPGO_TOKEN.

3. Reference Secrets in Workflows
   Use your stored secrets in the workflow by referencing them like this: ${{ secrets.CAPGO_TOKEN }}.

Capgo Commands in Workflows

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

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

デプロイ用コマンド

ここでは、更新をビルド、バージョン、デプロイするための重要なコマンドを紹介します。

デプロイプロセスを自動化するには、コマンドを組み合わせて次のように使用してください。

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のチャンネルシステムでは、異なるステージ用に別々のデプロイパスを作成できます。

エラーソリューション

Here are some common integration issues and how to address them:

1. Authentication Failures

CAPGOのトークンを確認してください。GitHubのシークレットに有効期限切れの場合は、再生成して正常な認証を保証します。

2. Build Errors

デプロイ先環境の要件に合ったビルド設定を確認してください。

「CapgoのOTA更新を生産環境でCapgoのユーザーに展開しました。5000人以上のユーザーが正常に動作しています。ほとんどのユーザーは、@CapgoにOTAが展開された後、数分以内に最新の状態になります。」 [1]

3. Version Conflicts

バージョン管理をセマンティックバージョニングで行い、バージョンを適切にインクリメントして、デプロイ時にコンフリクトを防ぎましょう。

Maintenance Tips

• __CAPGO_KEEP_0__の分析ツールを使用して、更新の成功率を監視してください。 Capgo __CAPGO_KEEP_1__
• 自動更新で問題が発生する可能性のある更新に対して、自動ロールバックを有効にします。
• テスト プル リクエスト (PR) を使用して、チャネル セレクターでより良い制御を実現します。
• 最新の Capgo CLI コマンドでワークフローを最新の状態に保ちます。

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

まとめ

主なポイント

Capgo の GitHub Actions の統合により、Capgo アプリのデプロイメントプロセスが簡素化され、開発チームに大きな利益をもたらします。 Capacitor アプリ, delivering major benefits to development teams. With an 82% global success rate for updates and 95% of active users receiving updates within 24 hours [1]このソリューションは、更新の 82% のグローバル成功率と、24 時間以内に更新を受け取るアクティブユーザーの 95% を誇ります。

以下の機能が特に目立っています。

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

これらの機能により、よりカスタマイズされたソリューションと改善されたパフォーマンスが可能になる。これらについては、以下で詳しく説明する。

高度な戦略

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_KEEP_1__アクションの統合:ガイド Capgo Integration with GitHub Actions: Guide 暗号化 に接続してください。暗号化の実装詳細については、 暗号化 を参照してください。 コンプライアンス Capgo セキュリティ スキャナー Capgo セキュリティ スキャナー用製品ワークフロー Capgo セキュリティ Capgo セキュリティ用製品ワークフロー Capgo トラスト センター Capgo トラスト センター用製品ワークフロー