GitHub Actions × Antigravity CI/CD 自動化ガイド — AI でパイプラインを構築・運用する

ソフトウェア開発において、CI/CD（継続的インテグレーション/継続的デリバリー）パイプラインの構築と運用は不可欠なプロセスです。しかし、GitHub Actions のワークフロー YAML を一から書くのは煩雑で、設定ミスによるビルド失敗やデプロイ事故も珍しくありません。Google Antigravity の AI エージェントを活用すれば、CI/CD パイプラインの設計・生成・デバッグを大幅に効率化できます。ここではAntigravity と GitHub Actions を組み合わせた実践的な自動化ワークフローを詳しく解説します。

GitHub Actions の基本概念をおさらい

GitHub Actions は、GitHub リポジトリ上でイベント駆動の自動化ワークフローを実行するためのプラットフォームです。プッシュ、Pull Request の作成、スケジュール実行など、さまざまなトリガーに応じて、ビルド、テスト、リント、デプロイといった処理を自動的に実行できます。

ワークフローは .github/workflows/ ディレクトリに配置される YAML ファイルとして定義されます。1 つのリポジトリに複数のワークフローを持つことが可能で、それぞれが異なるイベントやジョブを担当します。

Antigravity はこの YAML ファイルの生成と管理を AI で支援し、開発者がインフラの設定に費やす時間を削減します。

Antigravity で GitHub Actions ワークフローを生成する

エージェントへの指示方法

Antigravity のチャットインターフェースから、自然言語で CI/CD パイプラインの要件を伝えるだけで、適切なワークフロー YAML を生成できます。たとえば、以下のような指示が有効です。

「Node.js プロジェクト用の CI パイプラインを作成して。main ブランチへの PR 時にテストとリントを実行し、マージ後に Cloudflare Pages へデプロイする」

この指示に対し、Antigravity のエージェントはプロジェクト構成を分析し、適切なワークフローを生成します。

生成されるワークフローの例

name: CI/CD Pipeline
 
on:
  pull_request:
    branches: [main]
  push:
    branches: [main]
 
jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: '20'
          cache: 'npm'
      - run: npm ci
      - run: npm run lint
      - run: npm test
 
  deploy:
    needs: test
    if: github.event_name == 'push' && github.ref == 'refs/heads/main'
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: '20'
          cache: 'npm'
      - run: npm ci
      - run: npm run build
      - uses: cloudflare/wrangler-action@v3
        with:
          apiToken: ${{ secrets.CLOUDFLARE_API_TOKEN }}
          accountId: ${{ secrets.CLOUDFLARE_ACCOUNT_ID }}
          command: pages deploy ./out --project-name=my-project

Antigravity は単にテンプレートを出力するのではなく、プロジェクトの package.json やディレクトリ構造を読み取り、実際のプロジェクトに即したワークフローを生成します。

実践的なワークフローパターン

パターン 1: マルチ環境デプロイ

開発環境、ステージング環境、本番環境への段階的デプロイを自動化するパターンです。Antigravity に「ステージングと本番の 2 段階デプロイを設定して」と指示すると、環境変数の切り替えや承認フローを含むワークフローが生成されます。

jobs:
  deploy-staging:
    if: github.ref == 'refs/heads/develop'
    environment: staging
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - run: npm ci && npm run build
      - run: npx wrangler pages deploy ./out --project-name=my-project-staging
 
  deploy-production:
    if: github.ref == 'refs/heads/main'
    environment: production
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - run: npm ci && npm run build
      - run: npx wrangler pages deploy ./out --project-name=my-project

パターン 2: PR プレビューデプロイ

Pull Request ごとにプレビュー環境を自動作成するパターンも、Antigravity が得意とするワークフローです。レビュアーが実際の動作を確認しながらコードレビューできるため、フィードバックの質が向上します。

on:
  pull_request:
    types: [opened, synchronize]
 
jobs:
  preview:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - run: npm ci && npm run build
      - uses: cloudflare/wrangler-action@v3
        with:
          apiToken: ${{ secrets.CLOUDFLARE_API_TOKEN }}
          command: pages deploy ./out --project-name=my-project --branch=${{ github.head_ref }}
      - uses: actions/github-script@v7
        with:
          script: |
            github.rest.issues.createComment({
              issue_number: context.issue.number,
              owner: context.repo.owner,
              repo: context.repo.repo,
              body: '🚀 Preview deployed!'
            })

パターン 3: 自動テストとコードカバレッジ

テスト結果とカバレッジレポートを PR にコメントとして自動投稿するワークフローです。Antigravity はテストフレームワークを自動検出し、適切な設定を生成します。

jobs:
  test-coverage:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: '20'
      - run: npm ci
      - run: npm test -- --coverage --coverageReporters=json-summary
      - uses: davelosert/vitest-coverage-report-action@v2
        if: always()

Antigravity エージェントによるワークフローのデバッグ

GitHub Actions のワークフローが失敗した場合、従来はログを手動で確認し、YAML の設定ミスを探す必要がありましました。Antigravity では、失敗したワークフローのログを AI エージェントに渡すことで、原因の特定と修正案の提示を自動で行えます。

エージェントに「GitHub Actions のビルドが失敗しました。ログを分析して原因を特定して」と指示すると、以下のような分析を行います。

まず、エラーメッセージの解析から始まります。Node.js のバージョン不一致、依存関係のインストール失敗、環境変数の未設定など、よくある原因を特定します。次に、修正案の提示として、具体的な YAML の変更箇所をコード付きで示します。

さらに、Antigravity は過去のビルド履歴を学習し、繰り返し発生するエラーパターンを検知して予防策を提案することも可能です。

セキュリティとシークレット管理

CI/CD パイプラインでは、API トークンやデプロイキーなどの機密情報を安全に管理する必要があります。Antigravity のエージェントは、ワークフロー生成時にハードコードされたシークレットを検出し、GitHub Secrets の使用を自動的に推奨します。

シークレットの設定手順

GitHub リポジトリの Settings から Secrets and variables、Actions と進み、必要なシークレットを登録します。Antigravity は必要なシークレット一覧を自動的にリストアップし、設定漏れを防ぎます。

ワークフロー YAML では ${{ secrets.SECRET_NAME }} の形式でシークレットを参照します。Antigravity が生成するワークフローでは、この形式が自動的に適用されるため、セキュリティリスクを最小限に抑えられます。

環境ごとのシークレット管理

ステージング環境と本番環境で異なるシークレットが必要な場合、GitHub の Environment 機能を活用します。Antigravity は環境の概念を理解し、環境ごとに適切なシークレットを参照するワークフローを生成します。

Gemini CLI との連携による高度な自動化

Google が提供する Gemini CLI は、google-github-actions/run-gemini-cli アクションを通じて GitHub Actions との公式連携をサポートしています。これにより、PR の自動コードレビュー、Issue のトリアージ、コード品質分析を CI/CD パイプラインに組み込めます。

Antigravity のエージェントを使って Gemini CLI 連携ワークフローを生成することで、AI を活用した高度な自動化が実現します。

jobs:
  ai-review:
    runs-on: ubuntu-latest
    permissions:
      contents: read
      pull-requests: write
    steps:
      - uses: actions/checkout@v4
      - uses: google-github-actions/run-gemini-cli@v1
        with:
          prompt: "Review this PR for code quality, security issues, and best practices."

Antigravity ワークフロー機能との統合

Antigravity には独自のワークフロー機能があり、.antigravity/workflows/ ディレクトリにワークフロー定義を配置することで、エディタ内から直接ワークフローを実行できます。この機能と GitHub Actions を組み合わせることで、ローカル開発からクラウドデプロイまでの一貫した自動化が可能になります。

Antigravity のチャットやエディタ内でワークフローのインテントを自動認識し、適切なワークフローをトリガーする仕組みも備えています。たとえば「デプロイして」と入力するだけで、事前に定義したデプロイワークフローが起動します。

ベストプラクティス

CI/CD パイプラインを効果的に運用するためのポイントをまとめます。

キャッシュを活用してビルド時間を短縮しましょう。actions/cache や actions/setup-node の cache オプションを使うことで、依存関係のインストール時間を大幅に削減できます。Antigravity が生成するワークフローにはこれらの最適化が自動的に含まれます。

マトリックスビルドで複数の環境を同時にテストしましょう。Node.js のバージョン 18、20、22 での並列テストや、複数 OS でのクロスプラットフォームテストを設定できます。

ワークフローの実行時間を監視し、不必要なジョブの実行を避けましょう。paths フィルターや paths-ignore を使って、変更されたファイルに関連するジョブだけを実行するようにします。