用途
Harness Pipeline 技能用于执行和监控 Harness CI/CD 流水线，并自动关联 Jira 问题。当用户要求“运行 Harness 流水线”“触发部署流水线”“监控 Harness 执行”或“检查流水线状态”时，可使用该技能。
主要能力
该技能提供四类操作：
- trigger：触发一次流水线执行。
- status：检查流水线执行状态，返回流水线名称、当前状态（Running、Success、Failed、Aborted）、各阶段状态、持续时间以及失败时的错误详情。
- logs：获取流水线执行日志，可按阶段筛选。
- list：列出最近的流水线执行记录，可指定数量上限。
使用方式
命令格式为：
/harness-pipeline <action> [options]
触发流水线：
/harness-pipeline trigger --pipeline <pipeline-id> --branch <branch-name> --jira <issue-key>
触发步骤包括：校验 Jira 问题是否存在（使用 issue-validator）、通过 Harness REST API 执行流水线、向 Jira 问题添加带执行链接的评论、返回执行 ID 以供监控。
检查状态：
/harness-pipeline status --execution <execution-id>
获取日志：
/harness-pipeline logs --execution <execution-id> --stage <stage-name>
列出最近执行：
/harness-pipeline list --pipeline <pipeline-id> --limit 10
示例工作流：
# 1. Validate the Jira issue first
/jira validate PROJ-163
# 2. Trigger pipeline with Jira link
/harness-pipeline trigger \
--pipeline my-ci-pipeline \
--branch feature/PROJ-163 \
--jira PROJ-163
# 3. Monitor execution
/harness-pipeline status --execution <returned-execution-id>
# 4. View logs if needed
/harness-pipeline logs --execution <execution-id> --stage build
Jira 集成
当使用 --jira 标志触发流水线时：
- 执行前：校验问题是否存在、检查问题是否处于合适状态、添加“Pipeline Triggered”评论。
- 执行中：可选将问题状态更新为“In Progress”。
- 执行后：添加执行结果评论、关联构建产物、根据结果转换问题状态（可配置）。
REST API 调用
该技能使用 Harness REST API（非 MCP）：
# Trigger pipeline
curl -X POST "${HARNESS_API_URL}/pipeline/api/pipeline/execute/${PIPELINE_ID}" \
-H "x-api-key: ${HARNESS_API_KEY}" \
-H "Harness-Account: ${HARNESS_ACCOUNT_ID}" \
-H "Content-Type: application/json" \
--data-urlencode "accountIdentifier=${HARNESS_ACCOUNT_ID}" \
--data-urlencode "orgIdentifier=${HARNESS_ORG_ID}" \
--data-urlencode "projectIdentifier=${HARNESS_PROJECT_ID}"
错误处理
| 错误 | 原因 | 解决方式 |
|---|---|---|
| 401 Unauthorized | PAT 无效或已过期 | 重新生成 PAT 令牌 |
| 403 Forbidden | 权限不足 | 检查 PAT 作用域 |
| 404 Not Found | 流水线/执行未找到 | 核实标识符 |
| 429 Too Many Requests | 触发速率限制 | 等待后重试 |
安全
- PAT 令牌仅存储在 .env 中。
- 绝不记录或暴露令牌。
- 使用最小必要权限。
- 定期轮换令牌。
适用场景
适用于需要通过 Harness 触发 CI/CD 流水线、监控执行状态与日志，并将流水线执行与 Jira 问题关联的开发和运维工作流。
限制
资料未提供该技能的具体安装方式、支持平台、收费情况或价格信息。