CI/CD統合

__CAPGO_KEEP_0__ のセットアップの質問をコピーし、インストール手順とフルマークダウンガイドを含むプラグインのセットアップの質問をコピーします。

インストール、同期、ソースマークダウンガイドを含むセットアップの質問をコピーします。 __CAPGO_KEEP_1__ と __CAPGO_KEEP_2__ を使用して CI/CD パイプラインに __CAPGO_KEEP_0__ を統合すると、アプリのビルドとデプロイのプロセスを完全に自動化できます。 __CAPGO_KEEP_1__ と __CAPGO_KEEP_2__ を使用して、セマンティックリリースを含めると、安定したデプロイを保証し、迅速な開発を可能にします。

Integrating Capgo into your CI/CD pipeline allows you to fully automate the process of building and deploying updates to your app. By leveraging the Capgo CLI and semantic-release, you can ensure consistent, reliable deployments and enable rapid iteration.

CI/CD統合の利点

自動化: 人間のエラーの余地なく、ビルド、テスト、デプロイ全プロセスが自動化されます。
一貫性: すべてのデプロイが同じステップに従うため、予測可能で繰り返し可能なプロセスが保証されます。これは、複数のチームメンバーが code に貢献する場合に特に価値があります。
迅速な反復: 自動化されたデプロイにより、更新を頻繁に、信頼性の高いもので配信できます。人間のQAまたはリリース承認を待つ必要はありません。

Capgo CLI

Capgo CLIは、CI/CDワークフローにCapgoを統合するための鍵です。新しいバンドルバージョンのプッシュ、チャンネルの管理、などを行うコマンドを提供します。

CI/CD統合の最も重要なコマンドは bundle upload:

npx @capgo/cli@latest bundle upload --channel Production --apikey YOUR_API_KEY

__CAPGO_KEEP_0__の場合、暗号化を使用している場合、__CAPGO_KEEP_0__を以下のいずれかから提供する必要があります。

__CAPGO_KEEP_0__の場合、プライベートキーファイルパスを使用します。

npx @capgo/cli@latest bundle upload --channel Production --apikey YOUR_API_KEY --key-v2 PRIVATE_KEY_PATH

__CAPGO_KEEP_0__の場合、プライベートキーコンテンツを直接使用します (CI/CD用に推奨)。

npx @capgo/cli@latest bundle upload --channel Production --apikey YOUR_API_KEY --key-data-v2 PRIVATE_KEY_CONTENT

__CAPGO_KEEP_0__の場合、環境変数を使用します (CI/CD用に推奨)。

npx @capgo/cli@latest bundle upload --channel Production --apikey YOUR_API_KEY --key-data-v2 "$CAPGO_PRIVATE_KEY"

環境変数の設定

CI/CD環境では、プライベートキーをファイルではなく環境変数として保存することをお勧めします。以下の手順に従って設定してください。

プライベートキー内容を取得する
ターミナル画面
```
cat .capgo_key_v2 | pbcopy
```
キー内容をクリップボードにコピーします。
CI/CD環境に追加する
- GitHub Actionsリポジトリシークレットに追加する CAPGO_PRIVATE_KEY GitLab CI
- __CAPGO_KEEP_0__ Actions: __CAPGO_KEEP_0__をプロジェクト設定にマスクした変数として追加してください
- CircleCI: プロジェクト設定に環境変数として__CAPGO_KEEP_0__を追加してください
- Jenkins: CI/CD パイプラインで使用するシークレットテキスト認証情報として__CAPGO_KEEP_0__を追加してください

パイプラインで使用するには:

- run: npx @capgo/cli@latest bundle upload --channel=production --apikey=${{ secrets.CAPGO_API_KEY }} --key-data-v2 "${{ secrets.CAPGO_PRIVATE_KEY }}"

注記: __CAPGO_KEEP_0__フラグは、CI/CD パイプラインの環境変数で臨時ファイルを作成したくない場合に、プライベートキーの内容を直接文字列として渡すことを許可します。 --key-data-v2 このコマンドは、指定されたチャンネルに現在のWebビルドをアップロードします。通常、CI/CD パイプラインの最後のステップとして実行します。Webビルドが正常に完了した後、実行してください。

__CAPGO_KEEP_0__をCI/CD パイプラインに設定する

Setting up Capgo in your CI/CD Pipeline

CI/CDツールの選択に応じて、具体的な手順は異なりますが、Capgoを統合する一般的なプロセスは次のようになります。

APIキーを生成する: Capgoダッシュボードにログインし、APIキーを作成します。このキーは、CI/CD環境でCLIを認証するために使用されます。秘密に保ち、リポジトリにコミットしないでください!
設定 bundle upload コマンド: CI/CD構成に、適切な引数で__CAPGO_KEEP_0__コマンドを実行するステップを追加します。 bundle upload upload.yml
クリップボードにコピー
```
- run: npx @capgo/cli@latest bundle upload --channel=production --apikey=${{ secrets.CAPGO_API_KEY }}
```
__CAPGO_KEEP_1__ Production __CAPGO_KEEP_2__ ${{ secrets.CAPGO_API_KEY }} 環境変数にAPIキーを保持するものとともに追加 --key-data-v2 "${{ secrets.CAPGO_PRIVATE_KEY }}" 暗号化を使用している場合。

を追加します。 upload Webビルドの後: Webビルドが正常に完了した後、このステップが実行されるようにしてください。これにより、常に最新の__CAPGO_KEEP_0__をデプロイできます。 upload step comes after your web build has completed successfully. This ensures you’re always deploying your latest code.\n Here’s an example configuration for GitHub Actions:\n

name: Deploy to Capgo
 on:
  push:
   branches: [main]

jobs:
 deploy:
 runs-on: ubuntu-latest

 steps:
 - uses: actions/checkout@v6
 - uses: actions/setup-node@v6
  with:
   node-version: '24'

 - run: npm ci
 - run: npm run build

 - run: npm install -g @capgo/cli
 - run: npx @capgo/cli@latest bundle upload --channel=production --apikey=${{ secrets.CAPGO_API_KEY }} --key-data-v2 "${{ secrets.CAPGO_PRIVATE_KEY }}"

セマンティックリリースを使用したバージョン管理

Capgoでバージョン管理するには、推奨される方法は、バージョンをCapgoのファイルにインポートすることです。 capacitor.config.ts バージョン管理 package.json:

import pkg from './package.json'

const config: CapacitorConfig = {
  // ... other config
  plugins: {
    CapacitorUpdater: {
      version: pkg.version,
    }
  }
}

このアプローチにより、次のことが可能になります。

semantic-release (または他のツール)を使用して、バージョンを更新します。 package.json バージョン
自動的にバージョンが含まれた最新のバージョンでアプリをビルドします。
正しいバージョンでバンドルをアップロードします。

CI/CD ワークフローは次のようになります。

- run: npm ci
- run: npx semantic-release  # Updates package.json version
- run: npm run build         # Builds with new version from capacitor.config
- run: npx @capgo/cli@latest bundle upload --channel=production --apikey=${{ secrets.CAPGO_API_KEY }}

semantic-release のサンプル .releaserc 設定ファイルがこちらです。

{
  "branches": [
    "main",
    {
      "name": "beta",
      "prerelease": true
    }
  ],
  "plugins": [
    "@semantic-release/commit-analyzer",
    "@semantic-release/release-notes-generator",
    "@semantic-release/changelog",
    [
      "@semantic-release/git",
      {
        "assets": ["CHANGELOG.md", "package.json"],
        "message": "chore(release): ${nextRelease.version} [skip ci]\n\n${nextRelease.notes}"
      }
    ]
  ]
}

この設定ファイルは、次のことを行います。

コミットメッセージを分析して、Conventional Commits spec に従って次のバージョン番号を決定します。
最後のリリース以降のコミットに基づいてリリースノートを生成します。
ファイルに新しいリリースノートを更新します。 CHANGELOG.md ファイルのバージョンを更新します。これは、__CAPGO_KEEP_0__.config で取得されます。
更新された、およびその他の変更されたファイルをリポジトリにコミットします。 package.json capacitor.config で取得された更新されたバージョンが、ビルドに含まれるようにアプリをビルドする前に、semantic-release を実行してください。
トラブルシューティング CHANGELOG.md, package.json「トラブルシューティング」のセクション

コミットメッセージを分析して、Conventional Commits spec に従って次のバージョン番号を決定します。 package.json is included in your build through the capacitor.config.

ファイルに新しいリリースノートを更新します。

Capgo CI/CD統合に問題が発生した場合、以下の点を確認してください:

API キー：API キーが有効かつ必要な権限を持っていることを確認してください。環境変数を使用している場合、正しく設定されていることを確認してください。
CLI バージョン：Capgo CLI の最新バージョンを使用していることを確認してください。古いバージョンでは、互換性の問題や特定の機能の欠如が発生する可能性があります。
ビルドアーティファクト：ウェブビルドが予想どおりの出力ファイルを生成していることを確認してください。Capgo CLI は、有効なウェブビルドが必要です。
ネットワーク接続性：CI/CD環境がCapgoサーバーにネットワーク接続性があることを確認してください。ファイアウォールまたはプロキシの問題が、コマンドの実行に影響を与える場合があります。 upload 問題が解決しない場合は、__CAPGO_KEEP_0__サポートに連絡してください。

If you’re still having trouble, reach out to Capgo support for assistance. They can help troubleshoot any issues with your specific setup.

__CAPGO_KEEP_0__

CI/CDパイプラインにCapgoを適切にバージョン管理して組み込むことで、開発ワークフローが大幅にスムーズになります。capacitor.configアプローチを使用して、自動化されたデプロイとバージョニングを実行することで、更新を迅速かつ信頼性の高いもので配信することができます。

推奨されるアプローチでは、バージョンをファイルに設定し、__CAPGO_KEEP_0__を使用して更新することで、信頼性の高いデプロイプロセスを実現します。 capacitor.config.ts このアプローチでは、__CAPGO_KEEP_0__ __CAPGO_KEEP_1__コマンドとオプションの詳細については、__CAPGO_KEEP_0__リファレンスを参照してください。さらに、semantic-releaseの設定については、semantic-releaseドキュメントを参照してください。 package.json Happy deploying!

For more details on the Capgo CLI commands and options, check out the CLI referenceCI/CDパイプラインに__CAPGO_KEEP_0__を適切にバージョン管理して組み込むことで、開発ワークフローが大幅にスムーズになります。__CAPGO_KEEP_1__.configアプローチを使用して、自動化されたデプロイとバージョニングを実行することで、更新を迅速かつ信頼性の高いもので配信することができます。推奨されるアプローチでは、バージョンをファイルに設定し、__CAPGO_KEEP_0__を使用して更新することで、信頼性の高いデプロイプロセスを実現します。.

このアプローチでは、__CAPGO_KEEP_0__ __CAPGO_KEEP_1__コマンドとオプションの詳細については、__CAPGO_KEEP_0__リファレンスを参照してください。さらに、semantic-releaseの設定については、semantic-releaseドキュメントを参照してください。

Happy deploying!

あなたがCI/CD自動化を計画している場合 CI/CD統合 CI/CD自動化を計画するには Capgo CI/CD Capgo CI/CD内での製品ワークフロー Capgoネイティブビルド Capgoネイティブビルド内での製品ワークフロー Capgo統合 Capgo統合内での製品ワークフロー GitHubアクション統合 GitHubアクション統合の実装詳細 Cloudflare CI/CD統合 GitLab CI/CD統合の実装詳細について。