buildkite

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Buildkite — CI/CD

Setup

安装配置

The

buildkite

wrapper auto-detects first run and launches

scripts/setup

buildkite

包装器会自动检测首次运行并启动

scripts/setup

。

Build Operations

构建操作

bash

undefined

bash

undefined

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

undefined

buildkite build cancel BUILD_NUMBER --pipeline SLUG

undefined

Job & Log Operations

任务与日志操作

bash

undefined

bash

undefined

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

undefined

buildkite artifacts download --build BUILD_NUMBER --pipeline SLUG

undefined

Pipeline Operations

流水线操作

bash

undefined

bash

undefined

List all pipelines

列出所有流水线

buildkite pipeline list

View pipeline configuration

查看流水线配置

buildkite pipeline view SLUG

undefined

buildkite pipeline view SLUG

undefined

Failure Debugging Workflow

失败调试工作流

When a build fails, follow this sequence:

Find the failed build:

buildkite build list --pipeline SLUG --state failed

View build details to see which jobs failed:

buildkite build view BUILD_NUMBER --pipeline SLUG

Get the failed job's log:
```
buildkite job log JOB_ID
```

Download artifacts (test reports, etc.) if available:

buildkite artifacts download --build BUILD_NUMBER --pipeline SLUG

For detailed debugging patterns, load

references/build-debugging.md

当构建失败时，请遵循以下步骤：

找到失败的构建：

buildkite build list --pipeline SLUG --state failed

查看构建详情以确定哪些任务失败：

buildkite build view BUILD_NUMBER --pipeline SLUG

获取失败任务的日志：
```
buildkite job log JOB_ID
```
若有可用产物，下载相关文件（如测试报告等）：
```
buildkite artifacts download --build BUILD_NUMBER --pipeline SLUG
```

如需详细的调试模式，请加载

references/build-debugging.md

。

Output Conventions

输出约定

```
buildkite
```
outputs JSON by default — pipe through
```
jq
```
for display or extraction.
Use
```
buildkite api
```
for REST API endpoints not covered by direct commands.

Example:

buildkite api /v2/organizations/ORG/pipelines | jq '.[].slug'

```
buildkite
```
默认输出JSON格式结果 —— 可通过管道传递给
```
jq
```
进行展示或提取。
对于未被直接命令覆盖的REST API端点，请使用
```
buildkite api
```
。

示例：

buildkite api /v2/organizations/ORG/pipelines | jq '.[].slug'

Reference Files

参考文件

Reference	When to Load
references/bk-commands.md	Full bk CLI command reference needed
references/build-debugging.md	Debugging build failures in depth
references/troubleshooting.md	Auth failures, CLI errors, rate limits

参考文档	加载场景
references/bk-commands.md	需要完整的bk CLI命令参考时
references/build-debugging.md	深度调试构建失败问题时
references/troubleshooting.md	遇到认证失败、CLI错误、速率限制问题时