dbt platformのCI ジョブをGitHub Actionsを用いて実行してみた

【処理フロー】
1. 開発者が main ブランチへ PR を作成
2. GitHub Actions が PR イベントを検知
3. dbt platform API に CI ジョブのトリガーリクエストを送信
4. dbt platform が CI ジョブを実行（Slim CI + Deferral）

# =============================================================================
# dbt Cloud CI Job Trigger
#
# 概要:
#   mainブランチへのPR作成・更新時にdbt Cloud CI jobをAPIでトリガーする
#   ネイティブGit統合が利用できない環境向けのワークフロー
#
# CI jobのAPIトリガーに必要なパラメータ:
#   - cause          : トリガー理由（ログ・追跡用の任意テキスト）
#   - git_sha        : チェックアウトするコミットSHA（PRのHEADコミット）
#   - github_pull_request_id : PR番号（integer）。state:modified+やdeferralに必要
#
# 注意事項:
#   - git_sha と git_branch は同時に指定できない（400エラーになる）
#   - github_pull_request_id がないとCI job固有の機能（Slim CI、deferral）が動作しない
#
# 必要なGitHub Secrets:
#   - DBT_CLOUD_API_TOKEN  : dbt Cloudのservice token（推奨）
#   - DBT_CLOUD_ACCOUNT_ID : dbt CloudのアカウントID
#   - DBT_CLOUD_JOB_ID     : トリガーするCI jobのID
#   - DBT_CLOUD_HOST       : dbt CloudのホストURL（任意。未設定時はhttps://cloud.getdbt.com）
# =============================================================================
name: dbt Cloud CI Job Trigger

on:
  pull_request:
    branches:
      - main
    types: [opened, synchronize, reopened, ready_for_review]

jobs:
  trigger-dbt-ci:
    runs-on: ubuntu-latest

    steps:
      - name: Trigger dbt Cloud CI job
        env:
          DBT_CLOUD_TOKEN: ${{ secrets.DBT_CLOUD_API_TOKEN }}
          DBT_ACCOUNT_ID: ${{ secrets.DBT_CLOUD_ACCOUNT_ID }}
          DBT_JOB_ID: ${{ secrets.DBT_CLOUD_JOB_ID }}
          DBT_CLOUD_HOST: ${{ secrets.DBT_CLOUD_HOST }}
        run: |
          set -euo pipefail

          if [ -z "${DBT_CLOUD_HOST:-}" ]; then
            DBT_CLOUD_HOST="https://cloud.getdbt.com"
          fi

          REQUEST_BODY=$(jq -n \
            --arg cause "Triggered from GitHub Actions: repo=${GITHUB_REPOSITORY}, pr=${{ github.event.pull_request.number }}, sha=${{ github.event.pull_request.head.sha }}" \
            --arg git_sha "${{ github.event.pull_request.head.sha }}" \
            --argjson github_pull_request_id ${{ github.event.pull_request.number }} \
            '{cause: $cause, git_sha: $git_sha, github_pull_request_id: $github_pull_request_id}')

          echo "Request Body:"
          echo "$REQUEST_BODY"

          HTTP_CODE=$(curl --silent --output response.json --write-out "%{http_code}" \
            --request POST \
            --url "${DBT_CLOUD_HOST}/api/v2/accounts/${DBT_ACCOUNT_ID}/jobs/${DBT_JOB_ID}/run/" \
            --header "Content-Type: application/json" \
            --header "Authorization: Token ${DBT_CLOUD_TOKEN}" \
            --data "$REQUEST_BODY" \
          )

          echo "HTTP Status: $HTTP_CODE"
          echo "Response:"
          cat response.json

          if [ "$HTTP_CODE" -ge 400 ]; then
            exit 1
          fi

my-dbt-project/
├── .github/
│   └── workflows/
│       └── dbt_cloud_ci.yml    # ここに配置
├── my_dbt_project/
│   ├── models/
│   ├── macros/
│   └── dbt_project.yml
└── ...