Capacitor CI/CD パイプライン設定ガイド

もっと速いアプリ更新を最小限の手間で実現できますか？ アプリのCI/CDパイプラインを Capacitor 構築することで、ビルド、テスト、デプロイが自動化され、時間の節約とエラーの削減につながります。導入によって得られるメリットは以下の通りです：

Live Update: App Storeの審査を待たずに即座にアップデートを配信。ユーザーの95%が24時間以内に更新を受け取れます。
パイプラインの要点: ブランチのアクティビティをトリガーとしたビルドの自動化（main, staging, feature/*）に加え、ステージングと本番用の環境を個別に定義します。
Capgo 統合: Capgo を使用して、安全で暗号化されたアップデートのデプロイや、アップデートチャネルの管理、パフォーマンスの監視を行います。
お手頃な料金プラン: 月額$12から。Live Update、アナリティクス、月間約15回のNative Buildが含まれます。

Capacitor の CI/CD パイプラインを活用すれば、ワークフローを簡素化し、効率を高め、アプリを常に最新の状態にシームレスに保つことができます。それでは、詳細を見ていきましょう。

セットアップ要件

前提条件

以下のツールがインストールおよび設定されていることを確認してください：

Node.js LTS, Capacitor CLI、および Git
お好みの CI プラットフォームのアカウント（例： GitHub アクション, GitLab CI、または Jenkins)
ある Capgo アカウント Live Update 管理用

準備が整ったら、CIプラットフォーム上でビルドのトリガーとステップを定義します。

Appflow を CICD パイプラインに統合する

パイプライン設定の手順

前提条件が完了したので、次はパイプラインのトリガーと環境設定を行います。

ビルドのトリガーとステップ

特定のブランチのアクティビティに基づいて、ビルドを自動実行する CI/CD パイプラインを設定します。設定方法は以下の通りです。

ブランチのトリガー:
- 使用するのは main 本番用ビルド用。
- 使用するのは staging テスト用。
- 使用するのは feature/* 開発作業用。
ビルドステップ:
- 必要な依存関係をすべてインストールします。
- code の品質を確保するためにユニットテストを実行します。
- アプリケーションのWebアセットをビルドします。
- モバイルまたはデスクトッププラットフォーム用のネイティブバイナリを生成します。
- ビルドをテスト環境にデプロイして、さらに検証を行います。

環境設定

管理を容易にし、セキュリティを確保するために、ステージング用と本番用の環境設定ファイルを分けて定義します。設定例は以下の通りです：

# staging.env
ENVIRONMENT=staging
API_ENDPOINT=https://api-staging.example.com
LIVE_UPDATES_ENABLED=true

# production.env
ENVIRONMENT=production
API_ENDPOINT=https://api.example.com
LIVE_UPDATES_ENABLED=true

API のキーや証明書などの機密データは、CIプラットフォームのシークレット管理システムに安全に保存してください。これにより、パイプラインの機能性とセキュリティを両立できます。

Capgo 統合ガイド

Capgo Live Update ダッシュボードインターフェース

ビルドとデプロイのステージを設定したら、次は Capgo を統合しましょう。これにより、App Storeの審査待ちを回避して、アプリに直接ライブアップデートをプッシュできます。

Capgo のセットアップ手順

CI/CDパイプラインの準備ができたら、以下の手順に従ってプロジェクトに Capgo を追加してください：

まず、以下をインストールします： Capgo CLI:

npx @capgo/cli init

次に、以下のコマンドを実行します：

アプリのビルド: npm install && npm run build
アップデートのデプロイ: npx @capgo/cli deploy
アップデートのロールバック: npx @capgo/cli rollback

以下は、アップデートをデプロイするための GitHub Actions ジョブの例です：

- name: Deploy to Capgo
  run: |
    npm install @capgo/cli
    npx @capgo/cli deploy
  env:
    CAPGO_TOKEN: ${{ secrets.CAPGO_TOKEN }}

Capgo の主な特徴

Capgo を Capacitor アプリに導入することで、以下のようなメリットが得られます：

安全で効率的なアップデート：暗号化された差分アップデートにより、安全な配信を確保しつつペイロードサイズを削減します。
チャネル管理：ステージングや本番用のチャネルを作成し、アップデートの展開を制御できます。
分析ダッシュボード: アップデートの成功率を追跡し、詳細なインサイトでユーザーの利用状況をモニタリングします。

Capgo の料金プラン

Capgo では、さまざまなニーズに合わせた柔軟なプランを提供しています：

SOLO: 月額 $12 (1,000 MAU、ストレージ 2 GB、帯域幅 50 GB)
MAKER: 月額 $33 (10,000 MAU、ストレージ 5 GB、帯域幅 500 GB)
TEAM: 月額 $83 (100,000 MAU、ストレージ 10 GB、帯域幅 2,000 GB)
PAYG: 月額 $249から。カスタムスケーリング、API へのアクセス、カスタムドメインのオプションがあります。

現在、Capgo は 1,900 以上のアプリで本番稼働しており、継続的なデプロイメントにおける信頼できる選択肢となっています。 [1].

パイプライン管理

ステータス追跡

アプリの品質を維持し、ユーザー体験を向上させるには、パイプラインを常に監視することが不可欠です。CI/CDプラットフォームを活用して、以下の項目に関する自動アラートを設定しましょう：

ビルドステータスとデプロイの進捗
アップデート成功率
ユーザー利用メトリクス
エラーレポートとクラッシュログ

これらのアラートを明確なドキュメントと組み合わせることで、スムーズな監視と迅速な問題解決が可能になります。

ドキュメントガイド

優れたドキュメントは、チーム内の認識を統一し、運用を円滑にします。ドキュメントには以下の内容を含めるようにしてください：

パイプライン設定ビルドトリガー、環境変数、セキュリティ設定などの詳細。
アップデート手順: デプロイ手順、ロールバック方法、およびアップデートチャネルの管理.
モニタリング設定: アラート設定、メトリクス追跡、および問題発生時の対応方法。
コンプライアンスガイドライン: プラットフォーム固有のルール、アップデート制限、およびその他の要件。

すべてのドキュメントをバージョン管理に含め、パイプラインの変更に合わせて更新してください。問題発生時に時間を節約できるよう、一般的なエラーのトラブルシューティング手順も記載しておきましょう。

プラットフォームのガイドライン

Capgo のチャネルシステムを活用して Apple と Android のアップデートポリシーに従い、スムーズでコンプライアンスを遵守したリリースを実現しましょう：

ベータテスト: 少人数のユーザーグループにアップデートをリリース変更内容を検証するために。
ステージドロールアウト：アップデートを段階的にリリースし、問題を早期に発見します。
緊急修正：問題が発生した際は、ワンクリックで迅速にアップデートをロールバックできます。

概要

セットアップ手順の概要

開始するには、CLI のインストール、ビルドと環境変数の設定、シークレットの保護、モニタリングの有効化、そしてアップデートのデプロイが必要です。このプロセスはモニタリングやロールバックツールとシームレスに連携し、ダウンタイムを最小限に抑えてアプリの稼働を維持します。

CI/CDのメリット

セットアップと成果の関係を見ると、Capgo がいかに効率を高めるかが分かります。アップデートは わずか24時間以内にユーザーの95%に到達します。さらに、Capgo の料金は $12/月、月額 500ドル以上を請求する従来のサービスと比較して、圧倒的なコストメリットを提供します。現在、Capgo は 1,900以上のプロダクションアプリ [1].

をサポートしています。Capacitor CI/CD Pipeline Setup Guide の続きはこちら

以下を使用している場合： Capacitor CI/CD パイプライン設定ガイド CI/CD 自動化を計画するには、次と接続します： Capgo による CI/CD Capgo CI/CD のプロダクトワークフロー向けに、 Capgo Native Build Capgo Native Builds のプロダクトワークフロー向けに、 Capgo 連携一覧 Capgo Integrations のプロダクトワークフロー向けに、 CI/CD 連携 CI/CD Integration の実装詳細向け、および GitHub Actions 連携 GitHub Actions Integration の実装詳細については。