Capgo Integration with GitHub Actions: Guide

Capgo そして GitHub Actions __CAPGO_KEEP_0__ Capacitor アップデートのデプロイを簡素化することができます。

• Capgoお金を節約する CI/CDコストを削減することで、5年間で26,100ドルを節約できます。.
• AppFlow迅速なアップデート
• 95%のユーザーが24時間以内にアップデートを受け取ることができます。セキュアなデプロイ
• エンドツーエンドの暗号化により、安全なアップデートが保証されます。: GitHubで自動ビルドとデプロイを直接行うことができます。

Quick Overview

1. Requirements: GitHubアカウント Capgoアカウント (1か月あたり$12から)、Capacitorプロジェクト Node.js.
2. セットアップ: インストール Capgo CLI と npx @capgo/cli init, YAMLワークフローでGitHubアクションを設定する
3. デプロイ: Live updates product page のコマンド npx @capgo/cli deploy を使用して を.
4. 自動化テスト

: 生産環境に先駆けて、ベータ版、ステージング版など、テストチャンネルにデプロイ:

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

例のワークフロー (YAML)

GitHub Actions __CAPGO_KEEP_0__ Actions

セットアップ要件

CapgoのCapgo CapgoのGitHubアクションの統合

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

Capgoの統合に必要なアカウントとツール

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:

“Run npx @capgo/cli init それ！” [1]

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

GitHub Repository Setup

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

Capgoリポジトリには、CI/CD統合用に必要なシークレット、ブランチ保護、デプロイトリガーが必要です。OTAリリースプロセス用に。

料金

• Capgo plans start at $12/month.
• 同じプランには、OTA更新と約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 Actions Workflow Setup

Capgo Actionsワークフロー設定 Capgo deployments 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:

シークレットキーを管理する

安全なデプロイを確実にするために、シークレットキーを適切に管理する必要があります。GitHub Actionsは、暗号化されたシークレットキーマネジメントシステムを提供します。

__CAPGO_KEEP_0__ セキュアな認証の設定手順:

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 Actions 環境を設定した後、__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 をインストールします。

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 アクションズワークフローをテストするには、専用の 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:

エラーソリューション

ここでは、一般的な統合問題と対処方法について説明します。

1. 認証失敗

CAPGO_TOKENをGitHubシークレット内で確認してください。有効期限が切れていた場合、再生成して認証を円滑にするようにしてください。

2. ビルドエラー

ビルド構成を、展開環境の要件と一致させること。

「私たちはCapgoのOTAアップデートを生産環境に展開し、5000人以上のユーザーに提供しました。私たちは、OTAがCapgoに展開された後、ほぼすべてのユーザーが数分以内に最新の状態に更新されていることを確認しています。」 [1]

3. バージョン間の競合

バージョンを適切にインクリメントし、セマンティックバージョニングに従うことで、展開時に競合を防ぐことができます。

メンテナンスのヒント

• 「__CAPGO_KEEP_0__の分析」を使用して、更新の成功率を監視する。 Capgo analytics チャネルセレクターを使用して、プルリクエストをテストすることで、より良い制御が可能になる。
• __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アプリ、開発チームに大きな利益をもたらすデプロイプロセスの簡素化が実現します。アップデートのグローバル成功率82％、24時間以内にアップデートを受け取るアクティブユーザーの95％を誇り、効率性でこの解決策は他にない [1]以下の主な機能があります:

自動ワークフロー

• : __CAPGO_KEEP_0__アクションでワークフローを直接設定することで、外部のCI/CDホスティングが必要なくなり、運用コストが約$26,100で5年間で削減される: 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].
• : アプリストアの遅延を回避して、即時アップデートが可能強固なセキュリティ
• Strong Security: Capgoのエンドツーエンド暗号化により、更新は安全に配信されます。 Capgoのチャンネルシステムは、制御されたステージドロールアウトを可能にします。

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

Advanced Strategies

To get the most out of your Capgo and GitHub Actions integration, explore these advanced tactics:

• Custom API Workflows: CapgoのパブリックAPIを使用して、チームの特定のニーズに合わせたデプロイワークフローを設計できます。この機能により、白ラベルエクスペリエンスと既存ツールとのシームレスな統合が可能になります。 [1].
• Channel-Based Releases: Capgoのチャンネル機能を使用して、ステージドおよび制御された更新を実現し、デプロイプロセスを最適化します。
• Optimized Performance: Capgoのパーティアルアップデートを使用して、帯域幅使用量を削減し、更新を高速化します。750のプロダクションアプリケーションを通じて、23.5百万の更新を配信した結果、システムは大規模な要求に対応する能力を証明しました。 [1]For even better results, consider using __CAPGO_KEEP_0__’s self-hosting options or custom __CAPGO_KEEP_1__ setups. Check earlier sections for detailed setup and testing instructions to fully implement these strategies.

Capgoの自主ホスティングオプションまたはカスタムAPIセットアップを使用することで、さらなる改善を実現できます。詳細なセットアップおよびテスト手順については、前節を参照してください。

Keep going from Capgo Integration with GitHub Actions: Guide

Capgoを使用している場合 Capgo Integration with GitHub Actions: Guide Capgoを使用してセキュリティと法的合致性を計画する場合、Cloudflareに接続します 暗号化 暗号化の実装詳細 法的合致性 法的合致性の実装詳細 Capgo Security Scanner for the product workflow in Capgo Security Scanner, Capgo Security for the product workflow in Capgo Security, and Capgo 信頼の中心 Capgo の製品ワークフローについての信頼の中心。