メインコンテンツにスキップ

CapgoのCapgoとGitHubの統合:ガイド

CapgoのCapgoをGitHubアクションと統合して、効率的な、安全な、コストの効率的なアプリケーションアップデートを実現し、開発ワークフローを向上させます。

CapgoのCapgoとGitHubの統合:ガイド

CapgoのCapgo Capgoの__CAPGO_KEEP_0__と__CAPGO_KEEP_1__の統合:ガイド GitHub Actions __CAPGO_KEEP_0__ Capacitor __CAPGO_KEEP_0__

  • アプリを簡単にアップデートすることができます。お金を節約する : 5年間でCI/CDコストを$26,100削減することができます。.
  • 迅速なアップデート: 24時間以内に95%のユーザーがアップデートを受け取ることができます。
  • 安全なデプロイ: 終端から終端までの暗号化により、更新は安全です。
  • ワークフローを簡素化するを自動化して、直接あなたのGitHubリポジトリでビルドとデプロイを実行します。

クイックオーバー

  1. 要件GitHubアカウント Capgoアカウント (1か月あたり$12)、Capacitorプロジェクト Node.js.
  2. セットアップインストール Capgo CLInpx @capgo/cli init, GitHubアクションをYAMLワークフローで設定してください。
  3. デプロイメント: 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__ アクション

GitHub Actions

セットアップ要件

Integrating Capgo with GitHub Actions involves setting up the necessary tools and configurations.

Capgoの

GitHub Actionsとの統合

必要なツールと設定 必要なツールとアカウント 確認する必要があるもの
GitHub Account 目的 詳細
Capgo Account ライブ更新の管理 月額 12 ドルからプランを始めます
Capacitor プロジェクト アプリ開発 統合に適した機能的なプロジェクト
Node.js 実行環境 最新の LTS バージョンが推奨されます

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

追加 Capgo コンテキスト:Capgo UI から長い文字列 (親キー `submitting_a_pr_to_capgo`) の HTML テキスト フラグメント。ページ/エリア:Capgo マーケティング ウェブサイト。役割:ウェブサイト コピー。見つかった場所:contributing.astro ページ。Capgo の製品/ブランド名と開発者用語を完全に保持します。メッセージ キー `submitting_a_pr_to_capgo` (Capgo への PR 提出)。

Capgo Live Update Dashboard Interface

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更新と1か月あたり約15回のネイティブビルドが含まれます。
  • 追加のビルド分数は、クレジットを通じて1分あたり請求されます。

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

  • リポジトリ構造: 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の 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:

使用シナリオ コンテキスト:Capgoのソリューションマーケティングページ。役割:短いUIラベルまたはナビゲーションアイテム。見られる場所:ページソリューション/コルダボアイトオカシトリテーブル( Solutions Cordova To Capacitor Ai Table Use Case )。 設定
Push イベント Deploy on code changes 特定のブランチにcodeがプッシュされたときに有効
手動起動 オンデマンドの更新 __CAPGO_KEEP_0__ Actionsのワークフローを手動で開始することができます
スケジュール タイムリリース 定期的にデプロイを実行
プルリクエスト テストの更新 メインブランチにマージする前に変更をテスト

シークレットキー管理

GitHub Actionsは、シークレットキーを安全に管理するために暗号化されたシークレット管理システムを提供します。

CapgoとGitHub Actionsの統合のためのガイド

  1. セキュアな認証の設定手順
    リポジトリの設定にアクセス

  2. リポジトリの設定にアクセスして、セキュリティタブの「シークレットと変数」セクションを見つけてください。 Capgo Credentials
    Save your Capgo authentication token as a repository secret. Name it CAPGO_TOKEN.

  3. Capgoの認証情報を保存してください。リポジトリのシークレットとして保存してください。名前を付けます
    ワークフローのシークレットを参照 ${{ 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

CapgoのCLIへの認証

CLIをセキュアに認証する CAPGO_TOKEN:

- name: Authenticate Capgo CLI
  run: npx @capgo/cli login
  env:
    CAPGO_TOKEN: ${{ secrets.CAPGO_TOKEN }}

デプロイコマンド

__CAPGO_KEEP_0__のビルド、バージョン管理、およびアップデートの処理に必要な重要なコマンドは以下のとおりです。

コマンド 目的 使用例
build __CAPGO_KEEP_0__用のビルド用パッケージを生成する __CAPGO_KEEP_0__にアップデートをプッシュする npx @capgo/cli build
deploy Capgoのバージョンを設定する npx @capgo/cli deploy
version デプロイプロセスを自動化するには、コマンドを組み合わせて使用します。 npx @capgo/cli version 1.2.0

__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 アクションズワークフローをテストするには、専用の GitHub テストチャンネルを使用できます。 Capgo testing channel__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’s channel system helps you create separate deployment paths for different stages:

目的 対象読者 ベータ
プレリリーステスト ステージ 内部チーム
実稼動 QA検証 テストユーザー
本番 ライブ展開 全ユーザー

エラーソリューション

以下は、CapgoとGitHub Actionsの統合に関する一般的な問題と解決策です。

1. 認証エラー

CAPGOトークンを確認してください。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.

Capgo

まとめ

主なポイント

CapgoのGitHubアクションとの統合により、 Capacitorアプリ、開発チームに大きな利益をもたらすデプロイプロセスの簡素化が実現します。アップデートのグローバル成功率82%、24時間以内にアップデートを受け取るアクティブユーザーの95%を誇り、効率性でこの解決策は他に比べると際立っています。 [1]以下の機能が特に注目されています:

自動ワークフロー

  • : __CAPGO_KEEP_0__アクションでワークフローを直接設定することで、外部のCI/CDホスティングが必要なくなり、運用コストが削減され、AppFlowなどの代替手段と比較して5年間で約$26,100を節約できます。: 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のエンドツーヘンドの暗号化により、更新は安全に配信されます。 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.

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から続けてCapgoとGitHubの統合ガイド

Capgoを使用している場合 Capgoから続けてCapgoとGitHubの統合ガイド __CAPGO_KEEP_0__と__CAPGO_KEEP_1__の統合ガイドを使用して、セキュリティとコンプライアンスの計画を行う セキュリティ セキュリティの実装詳細については、 コンプライアンス コンプライアンスの実装詳細については、 Capgo セキュリティ スキャナー Capgo セキュリティ スキャナーの製品ワークフロー Capgo セキュリティ Capgo セキュリティの製品ワークフロー Capgo の信頼の中心 Capgo の信頼の中心の製品ワークフローについて。

Capacitor アプリのリアルタイム更新

When a web-layer bug is live, ship the fix through Capgo instead of waiting days for app store approval. Users get the update in the background while native changes stay in the normal review path.

ウェブ層のバグが生じた場合、__CAPGO_KEEP_0__ を使用して修正を配信するのではなく、数日間待ってアプリストアの承認を待つのではなく、ユーザーはバックグラウンドで更新を受け取り、ネイティブの変更は通常のレビュー経路を通じて保持される。

コンテキスト: Capgo マーケティング ウェブサイト。役割: サポートする説明文またはメタ説明文。見つかった場所: コンポーネント GetStarted.astro。Capgo の製品/ブランド名と開発者用語をそのまま保存する。メッセージキー `instant_updates_for_capacitor_apps_description` (Instant Updates For Capacitor Apps Description)。

マーティンから人間のサポート

Capgo gives you the best insights you need to create a truly professional mobile app.