読み込み中

Claude CodeをCI/CDパイプライン内で非対話的に実行し、長時間稼働するエージェントが安全に動作するよう実行をサンドボックス化し、MCP統合を通じてデプロイメントを公開し、エージェントが実際に必要とする前にロールバック経路を予行演習しておきます。

何が変わるのか

従来型AIネイティブ
パイプラインは決定論的なスクリプトを実行し、判断が必要なものはすべて人間を待ちます。たとえば、不安定なテストのトリアージ、変更履歴の作成、ビルドが壊れた理由の解明などです。デプロイメントとロールバックは、人間がプレッシャーの中で従うランブックです。Claudeは判断が必要なステップについて、スコープ付きの認証情報を持つサンドボックス内でパイプライン内を非対話的に実行します。デプロイメントツールはMCPを通じてエージェントに公開されるため、変更を書いてテストしたワークフローが、それを出荷し、ロールバックすることもできます。これは組織が環境ごとに定めるゲートの内側で行われます。

はじめに

  • 前提条件: PRレビューループ内のAIと、承認ゲートとしてのフックです。自動化がそれらを通じて何かを加速させる前に、ゲートが存在していなければならないためです。
  • インフラストラクチャ: claude-code-actionがインストールされたCIプラットフォーム、またはclaude -pを呼び出せる任意のランナー。APIを通じたモデルアクセス、あるいはトラフィックを組織のクラウド契約内に留める必要がある場合はAmazon Bedrock、Microsoft Foundry、またはVertex AI。デプロイメント対象のためのMCPサーバー。常設の本番認証情報を持たないエージェントジョブ用のサンドボックスプロファイル。

実行方法

  1. プラットフォームエンジニアは読み取り専用の判断ステップから始めます。パイプラインジョブでclaude -pを使用して、失敗したビルドをトリアージしたり、不安定なテストを要約したり、変更履歴の草稿を作成したりします。
  2. lintの修正、生成されたドキュメントの更新、@claudeメンションによるレビューコメントへの対応といったジョブについて、既存のゲートの背後に書き込みステップを追加します。エージェントが書き込むものはすべて、ブランチ保護を通じてPRとして届き、エージェントがmainにプッシュする経路は存在しません。
  3. 実行はサンドボックス化されます。エージェントジョブは、短命でスコープ付きのトークンを持つネットワークポリシーの下でコンテナ内で実行され、デフォルトでは本番認証情報を保持しません。
  4. デプロイメントをMCPを通じて公開します。デプロイ、ステータス、ロールバックはツールとなり、環境ごとにスコープが設定されるため、エージェントのデプロイメント権限は、認証情報付きのシェルスクリプトではなく許可リストになります。
  5. 環境ごとに自律性を段階化します。開発環境では、エージェントは自由にデプロイします。本番環境では、エージェントがリリースを準備し、リリースマネージャーがそれを承認し、フックが本番ゲートを強制します。ステージングはその中間に位置します。
  6. ロールバックは、パイプライン内で最も予行演習された経路であるべきで、エージェントが実行できる単一のコマンドであり、ステージングで定期的に実行されるものです。ループを閉じるプレイ(ステージ6:維持)は、コントロールバンドが破られたときにこのロールバックを呼び出すため、事前に実証されていなければなりません。

実際の様子

パイプラインステップ:

yaml
- name: Triage failed build
  if: failure()
  run: >
    claude -p "Read the build log at out/build.log. Identify the most
    likely cause, say whether the failure looks flaky or real, and write a
    three-line summary for the PR thread." >> triage.md

この例の残りの部分は、保険会社の顧客ポータルで、デプロイメントがツールとして公開され、環境ごとに1つのMCPサーバーがあります。MCPツールを許可するルールは、サーバーとツールの名前を指定しますが、ツールの引数は指定しません。そのため、環境ごとに別々のサーバーを用意することで、許可リストがステージングと本番を区別できるようになります。サーバーはプロジェクトの.mcp.jsonで設定されます:

json
{
  "mcpServers": {
    "deploy-dev": {
      "type": "http",
      "url": "https://deploy.example.com/mcp/dev",
      "headers": { "Authorization": "Bearer ${DEPLOY_DEV_TOKEN}" }
    },
    "deploy-staging": {
      "type": "http",
      "url": "https://deploy.example.com/mcp/staging",
      "headers": { "Authorization": "Bearer ${DEPLOY_STAGING_TOKEN}" }
    },
    "deploy-prod": {
      "type": "http",
      "url": "https://deploy.example.com/mcp/prod",
      "headers": { "Authorization": "Bearer ${DEPLOY_PROD_TOKEN}" }
    }
  }
}

すべてのサーバーは同じ3つのツールを提供します:

ツール入力戻り値
releaseversion、本番環境ではticketもロールアウトが完了した時点でのリリースID
statusなし最後のリリースから5分後まで待機し、その後その時間帯の各エンドポイントの5xxレートを返す
rollbackなし再び稼働中のバージョン

ステージングジョブはmainへのプッシュで実行され、ステージングサーバーの3つのツールのみを事前承認し、他は承認しません。ステージングトークンのみを保持しているため、他の2つのサーバーは有効なトークンを得られず、ジョブを拒否します。これがステージングジョブのパイプラインステップです:

yaml
- name: Release to staging and roll back if it is unhealthy
  env:
    ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
    DEPLOY_STAGING_TOKEN: ${{ secrets.DEPLOY_STAGING_TOKEN }}   # no other environment's token
  run: >
    claude -p "Release version ${{ github.sha }} of the claims portal to staging,
    then call status. If the 5xx rate on any endpoint is over 1%, roll back.
    Finish with three lines for the release notes: what you released, what status
    reported, and whether you rolled back."
    --allowedTools "mcp__deploy-staging__release,mcp__deploy-staging__status,mcp__deploy-staging__rollback"
    --permission-mode dontAsk >> release-notes.md

dontAskモードでは、Claude Codeは本来プロンプトを出すはずの呼び出しをすべて拒否するため、リストに載っていないデプロイメントツールは拒否され、ジョブは回答を待つことがありません。

releaseツールに対する1つのPreToolUseフックが、環境ごとに判断を下します。これは承認ゲートとしてのフックのプレイで記述されており、3つの段階を提供します:

環境許可リスト上のツールreleaseに何が起こるか誰が承認するか
開発release、status、rollbackフックが許可する誰も承認しない
ステージングrelease、status、rollbackフックが確認を求める、またはmain上のパイプラインから許可するエンジニア、または承認済みのマージ
本番status、rollbackフックが許可しない限り拒否される変更チケットを通じたリリースマネージャー

本番環境では、dontAskモードでもPreToolUseフックが承認する呼び出しは実行されるため、releaseが許可リストから外れている状態では、フックのallowだけが通過する唯一の方法です。したがって本番環境はフェイルクローズします。フックが実行に失敗した場合、リリースは拒否されるためです。rollbackは事前に承認されたランブックであるため、許可リストに残ります。

ランナーがallowManagedHooksOnlyを含む管理設定を持つ場合、フックは管理設定内で定義されていなければならず、allowManagedMcpServersOnlyの場合はサーバーが管理された許可リストに載っていなければなりません。

ガバナンス上の考慮事項

統治原則は、エージェントが本番ゲートまでは行動できるが、それを通過することはできないということです。以下のコントロールがこの原則を強制します。

  • ブランチ保護は、エージェントが書き込むものすべてをPRに変換し、mainへの直接経路を持たせません。
  • 本番デプロイフックは、指名されたリリースマネージャーが承認するまでリリースをブロックします。各非対話的な実行はエージェント自身のアイデンティティの下で動作するため、パイプラインログはエージェントが行ったことと、それをトリガーしたエンジニアが行ったことを区別します。
  • 環境ごとの権限段階は、ゲートに至るまでにエージェントがどれだけのことを行えるかを設定します。

測定方法

  • 先行指標: 人間を呼び出すことなくトリアージされたパイプライン失敗の割合。CI/CDパイプラインログから取得します。
  • 遅行指標: DevOps Research and Assessment(DORA)指標。これはCIシステムとデプロイメントツールが既に出力しているものです。