Bitbucket Pipelines 連携

code の変更をプッシュするたびに、Capgo Live Updates を使用してアプリのアップデートを自動デプロイできるよう、Bitbucket Pipelines と連携させましょう。このガイドでは、ビルド、テスト、デプロイの自動化ワークフローのセットアップ方法を解説します。

前提条件

Bitbucket Pipelines との連携を設定する前に、以下が準備されていることを確認してください：

• リポジトリを含む Bitbucket アカウント
• アプリが設定済みの Capgo アカウント
• プロジェクトでNode.jsと npm/yarnが設定済みであること

Bitbucket Pipelines のセットアップ

ステップ 1: リポジトリ変数の設定

まず、Bitbucket リポジトリに必要な変数を設定します：

1. Bitbucket リポジトリに移動し、
2. 以下に移動します： リポジトリ設定 → Pipelines → リポジトリ変数
3. 以下の変数を追加してください：

変数名	値	Secured
CAPGO_TOKEN	Capgo API トークン	✅ はい

ヒント

Capgo API トークンはこちらから取得: console.capgo.app/apikeys. アプリIDはすでに設定済みです。 capacitor.config.ts ファイル。

シンプル

mainブランチへのpushごとに本番環境へデプロイする基本設定:

# bitbucket-pipelines.yml - Simple Configuration
image: node:22

pipelines:
  branches:
    main:
      - step:
          name: Build and Deploy to Production
          script:
            - npm ci
            - npm run test
            - npm run build
            - npm install -g @capgo/cli
            - npx @capgo/cli bundle upload --apikey $CAPGO_TOKEN --channel production
          artifacts:
            - dist/**

詳細設定

フィーチャーブランチへのデプロイ

レビューとテストのために、フィーチャーブランチをテストチャンネルへデプロイします：

# Feature branch deployment
pipelines:
  branches:
    feature/*:
      - step:
          name: Deploy Feature Branch
          script:
            - npm ci
            - npm run test
            - npm run build
            - BRANCH_NAME=$(echo $BITBUCKET_BRANCH | sed 's/[^a-zA-Z0-9-]/-/g')
            - CHANNEL_NAME="feature-$BRANCH_NAME"
            - npm install -g @capgo/cli
            - npx @capgo/cli channel add $CHANNEL_NAME --apikey $CAPGO_TOKEN || true
            - npx @capgo/cli bundle upload --apikey $CAPGO_TOKEN --channel $CHANNEL_NAME
          artifacts:
            - dist/**

ヒント

Channelsでのテストフィーチャーチャンネルにデプロイした後、その特定のチャンネルを使用するように設定することで、アプリ内でアップデートをテストできます。詳細については アプリでのチャネル設定.

暗号化の利用

以下を使用している場合 Capgoの暗号化機能を使用する場合、プライベートキーをCI/CD環境に安全に保存する必要があります。

完了後、 暗号化キーの設定 ローカルでプライベートキーをBitbucketの変数に追加します：

# Display your private key content (copy this output)
cat .capgo_key_v2

この内容を次のように追加します： CAPGO_PRIVATE_KEY Bitbucketリポジトリの変数（Securedに設定）として登録し、パイプラインで使用します：

# Deploy with encryption
- step:
    name: Deploy to Capgo with Encryption
    script:
      - npm install -g @capgo/cli
      - npx @capgo/cli bundle upload --apikey $CAPGO_TOKEN --key-data-v2 "$CAPGO_PRIVATE_KEY" --channel production

注意

セキュリティのベストプラクティス:

• 以下のファイルは絶対に .capgo_key_v2 バージョン管理にコミットしないでください
• 秘密鍵はCI/CDのセキュアなシークレット管理にのみ保存してください
• 環境ごとに別のキーを使用する

マルチチャネル設定

複数のデプロイチャネルのセットアップと管理について詳しくは、 Channelsのドキュメント.

複数の環境とプルリクエストへのデプロイを含む、完全な設定手順:

# bitbucket-pipelines.yml - Advanced Multi-Channel Configuration
image: node:22

definitions:
  steps:
    - step: &build-step
        name: Build Application
        script:
          - npm ci
          - npm run test
          - npm run build
        artifacts:
          - dist/**

    - step: &deploy-step
        name: Deploy to Capgo
        script:
          - npm install -g @capgo/cli
          - npx @capgo/cli bundle upload --apikey $CAPGO_TOKEN --channel $CHANNEL_NAME

pipelines:
  branches:
    main:
      - step:
          <<: *build-step
      - step:
          <<: *deploy-step
          name: Deploy to Production
          deployment: production
          trigger: manual
          script:
            - export CHANNEL_NAME=production
            - npm install -g @capgo/cli
            - npx @capgo/cli bundle upload --apikey $CAPGO_TOKEN --channel $CHANNEL_NAME

    develop:
      - step:
          <<: *build-step
      - step:
          <<: *deploy-step
          name: Deploy to Development
          deployment: development
          script:
            - export CHANNEL_NAME=development
            - npm install -g @capgo/cli
            - npx @capgo/cli bundle upload --apikey $CAPGO_TOKEN --channel $CHANNEL_NAME

  pull-requests:
    '**':
      - step:
          <<: *build-step
      - step:
          name: Deploy PR to Test Channel
          script:
            - CHANNEL_NAME="pr-$BITBUCKET_PR_ID"
            - npm install -g @capgo/cli
            - npx @capgo/cli channel add $CHANNEL_NAME --apikey $CAPGO_TOKEN || true
            - npx @capgo/cli bundle upload --apikey $CAPGO_TOKEN --channel $CHANNEL_NAME
          artifacts:
            - dist/**

マルチ環境パイプライン

ステージング環境と本番環境を伴う複雑なデプロイシナリオの場合：

# Multi-environment pipeline
image: node:22

pipelines:
  branches:
    main:
      - step:
          name: Build
          script:
            - npm ci
            - npm run test
            - npm run build
          artifacts:
            - dist/**
      - step:
          name: Deploy to Staging
          deployment: staging
          script:
            - npm install -g @capgo/cli
            - npx @capgo/cli bundle upload --apikey $CAPGO_TOKEN --channel staging
      - step:
          name: Deploy to Production
          deployment: production
          trigger: manual
          script:
            - npm install -g @capgo/cli
            - npx @capgo/cli bundle upload --apikey $CAPGO_TOKEN --channel production

    develop:
      - step:
          name: Build and Deploy to Development
          script:
            - npm ci
            - npm run test
            - npm run build
            - npm install -g @capgo/cli
            - npx @capgo/cli bundle upload --apikey $CAPGO_TOKEN --channel development
          artifacts:
            - dist/**

ブランチベースのデプロイ戦略

ブランチごとに適切なチャンネルへ自動デプロイ：

# Dynamic channel deployment
image: node:22

definitions:
  scripts:
    - script: &determine-channel |
        if [ "$BITBUCKET_BRANCH" = "main" ]; then
          export CHANNEL_NAME="production"
        elif [ "$BITBUCKET_BRANCH" = "develop" ]; then
          export CHANNEL_NAME="staging"
        else
          export CHANNEL_NAME="development"
        fi
        echo "Deploying to channel: $CHANNEL_NAME"

pipelines:
  default:
    - step:
        name: Build and Deploy
        script:
          - npm ci
          - npm run test
          - npm run build
          - *determine-channel
          - npm install -g @capgo/cli
          - npx @capgo/cli bundle upload --apikey $CAPGO_TOKEN --channel $CHANNEL_NAME
        artifacts:
          - dist/**

パイプラインの並列実行

並列ステップでビルド時間を最適化：

# Parallel execution pipeline
image: node:22

pipelines:
  branches:
    main:
      - parallel:
          - step:
              name: Run Tests
              script:
                - npm ci
                - npm run test
          - step:
              name: Lint Code
              script:
                - npm ci
                - npm run lint
      - step:
          name: Build Application
          script:
            - npm ci
            - npm run build
          artifacts:
            - dist/**
      - step:
          name: Deploy to Production
          deployment: production
          script:
            - npm install -g @capgo/cli
            - npx @capgo/cli bundle upload --apikey $CAPGO_TOKEN --channel production

セキュリティのベストプラクティス

リポジトリ変数

1. セキュアな変数・ API トークンは必ずセキュアに設定してください
2. 環境変数・ 必要に応じてデプロイ専用の変数を使用してください
3. アクセス制御・ リポジトリへのアクセスは権限を持つチームメンバーに限定してください
4. トークンのローテーション：Capgo API トークンを定期的にローテーションしてください

デプロイ環境

セキュリティ向上のため、デプロイ環境を設定してください：

# Deployment with environment restrictions
pipelines:
  branches:
    main:
      - step:
          name: Deploy to Production
          deployment: production
          trigger: manual
          script:
            - npm install -g @capgo/cli
            - npx @capgo/cli bundle upload --apikey $CAPGO_TOKEN --channel production

モニタリングと通知

Slack 連携

パイプラインに Slack 通知を追加してください：

# Pipeline with Slack notifications
pipelines:
  branches:
    main:
      - step:
          name: Build and Deploy
          script:
            - npm ci
            - npm run test
            - npm run build
            - npm install -g @capgo/cli
            - npx @capgo/cli bundle upload --apikey $CAPGO_TOKEN --channel production
          after-script:
            - |
              if [ $BITBUCKET_EXIT_CODE -eq 0 ]; then
                curl -X POST -H 'Content-type: application/json' \
                  --data '{"text":"✅ Capgo deployment successful for '$BITBUCKET_BRANCH'"}' \
                  $SLACK_WEBHOOK_URL
              else
                curl -X POST -H 'Content-type: application/json' \
                  --data '{"text":"❌ Capgo deployment failed for '$BITBUCKET_BRANCH'"}' \
                  $SLACK_WEBHOOK_URL
              fi

メール通知

Bitbucketの標準機能、または外部サービスを使用して、メール通知を設定します：

# Email notification step
- step:
    name: Send Notification
    script:
      - |
        curl -X POST \
          -H "Content-Type: application/json" \
          -d '{
            "to": "team@yourcompany.com",
            "subject": "Capgo Deployment Status",
            "body": "Deployment of '$BITBUCKET_BRANCH' completed with status: '$BITBUCKET_EXIT_CODE'"
          }' \
          $EMAIL_SERVICE_URL
    condition:
      result: [successful, failed]

トラブルシューティング

よくある問題

「Capgo CLI not found」でパイプラインが失敗する場合：

# Debug CLI installation
- step:
    name: Debug CLI
    script:
      - npm install -g @capgo/cli
      - which capgo || echo "Capgo CLI not found"
      - npx @capgo/cli --version

認証エラー：

# Verify token configuration
- step:
    name: Debug Auth
    script:
      - |
        if [ -z "$CAPGO_TOKEN" ]; then
          echo "CAPGO_TOKEN is not set"
          exit 1
        fi
        echo "Token length: ${#CAPGO_TOKEN}"

ビルドアーティファクトが見つからない場合：

# List build outputs
- step:
    name: Debug Build
    script:
      - ls -la dist/
      - find dist/ -type f -name "*.js" -o -name "*.html"

パイプラインのデバッグ

問題のトラブルシューティングにデバッグ情報を追加してください：

# Debug pipeline
pipelines:
  branches:
    main:
      - step:
          name: Debug Information
          script:
            - echo "Branch: $BITBUCKET_BRANCH"
            - echo "Commit: $BITBUCKET_COMMIT"
            - echo "Build: $BITBUCKET_BUILD_NUMBER"
            - env | grep BITBUCKET_ | sort
      - step:
          name: Build and Deploy
          script:
            - npm ci
            - npm run test
            - npm run build
            - npm install -g @capgo/cli
            - npx @capgo/cli bundle upload --apikey $CAPGO_TOKEN --channel production

パイプラインのバリデーション

パイプラインのバリデーションを有効にして、設定エラーを未然に防ぎましょう：

# Enable pipeline validation
options:
  docker: true
  size: 2x

pipelines:
  branches:
    main:
      - step:
          name: Validate Pipeline
          script:
            - echo "Pipeline validation successful"
      - step:
          name: Build and Deploy
          script:
            # ... deployment steps

次のステップ

• 詳しく知る チャンネル 異なるデプロイ環境を管理するには
• 詳しく見る カスタムストレージ 高度なデプロイシナリオ向け
• セットアップ 暗号化 セキュアなデプロイ向け
• 設定 アップデートの動作 アップデートの適用方法をカスタマイズするために

Bitbucket Pipelinesとの連携により、Capgoのデプロイを自動化し、モバイルアプリユーザーへ一貫性のある信頼性の高いアップデートを提供できます。

Bitbucket Pipelines連携から続ける

使用している場合 Bitbucket Pipelines 連携 CI/CD自動化を計画するには、次と連携してください Capgo での CI/CD 設定 Capgo CI/CDでのプロダクトワークフローについては、 Capgo Native Build Capgo Native Buildsでのプロダクトワークフローについては、 Capgo インテグレーション Capgo インテグレーションでのプロダクトワークフロー向けに、 CI/CD 連携 CI/CD Integrationの実装詳細については、 GitHub Actions 連携 GitHub Actions Integrationの実装詳細については。