buildkite

Buildkite — CI/CD

セットアップ

buildkite ラッパーは初回実行を自動検出し、scripts/setup を起動します。

ビルド操作

# List recent builds for a pipeline
buildkite build list --pipeline SLUG

# View build details
buildkite build view BUILD_NUMBER --pipeline SLUG

# Trigger a new build
buildkite build create --pipeline SLUG --branch main --message "Deploy"

# Rebuild a failed build
buildkite build rebuild BUILD_NUMBER --pipeline SLUG

# Cancel a running build
buildkite build cancel BUILD_NUMBER --pipeline SLUG

ジョブとログの操作

# List jobs for a build
buildkite job list --build BUILD_NUMBER --pipeline SLUG

# View job log output
buildkite job log JOB_ID

# Download build artifacts
buildkite artifacts download --build BUILD_NUMBER --pipeline SLUG

パイプライン操作

# List all pipelines
buildkite pipeline list

# View pipeline configuration
buildkite pipeline view SLUG

失敗のデバッグワークフロー

ビルドが失敗した場合は、次の手順に従います。

1. 失敗したビルドを検索します： buildkite build list --pipeline SLUG --state failed

2. ビルドの詳細を表示して、失敗したジョブを確認します： buildkite build view BUILD_NUMBER --pipeline SLUG

3. 失敗したジョブのログを取得します： buildkite job log JOB_ID

4. 利用可能な場合は、アーティファクト（テストレポートなど）をダウンロードします： buildkite artifacts download --build BUILD_NUMBER --pipeline SLUG

詳しいデバッグパターンについては、references/build-debugging.md を読み込んでください。

出力規約

• buildkite はデフォルトで JSON を出力します。表示または抽出するには、jq にパイプで渡してください。
• 直接コマンドで対応していない REST API エンドポイントには、buildkite api を使用します。
• 例：buildkite api /v2/organizations/ORG/pipelines | jq '.[].slug'

リファレンスファイル

リファレンス	読み込むタイミング
references/bk-commands.md	bk CLI コマンドの完全なリファレンスが必要な場合
references/build-debugging.md	ビルドの失敗を詳しくデバッグする場合
references/troubleshooting.md	認証エラー、CLI エラー、レート制限が発生した場合