ci-cd-ops

ci-cd-ops

用途

此技能使用 Jenkins 和 GitHub Actions 自动化 CI/CD 流水线，以构建、测试和部署代码，并专注于 DevOps 工作流，从而简化软件交付。

适用场景

在为代码变更设置自动化流水线时使用此技能，例如微服务架构，或与 Git 等版本控制系统集成时。它也适用于敏捷团队的频繁部署，或通过扩展 DevOps 运维来减少人工错误。

主要功能

• 使用 Jenkins 自动化构建流程，包括任务调度和构件管理。
• 配置 GitHub Actions 以创建事件驱动的工作流，例如在收到拉取请求时触发。
• 支持使用基于 YAML 的配置等工具编排流水线，以定义阶段、任务和条件。
• 集成监控和日志记录，以跟踪流水线状态和故障。
• 使用参数化变量处理特定环境的部署，例如预发布环境与生产环境。

使用模式

要使用此技能，请通过 OpenClaw Agent 使用特定命令调用它。例如，传入仓库 URL 和配置文件以启动流水线。命令中务必指定工具（例如 Jenkins 或 GitHub Actions）。使用 JSON 或 YAML 作为输入参数。示例模式：Agent 命令 -> 解析输入 -> 执行流水线 -> 监控输出。

常用命令/API

直接使用以下 CLI 命令或 API 调用。身份验证需要将 $JENKINS_API_KEY 或 $GITHUB_TOKEN 设置为环境变量。

• Jenkins CLI：运行 jenkins build -job MyJob -params '{"branch":"main"}' -key $JENKINS_API_KEY 以触发构建任务。

  curl -X POST http://jenkins.example.com/job/MyJob/build \
       -H "Authorization: Bearer $JENKINS_API_KEY" \
       --data 'parameter=[{"name":"branch","value":"main"}]'
  

• GitHub Actions API：使用 gh workflow run MyWorkflow.yml -f branch=main -token $GITHUB_TOKEN 调度工作流。

  curl -X POST https://api.github.com/repos/user/repo/actions/workflows/MyWorkflow.yml/dispatches \
       -H "Authorization: token $GITHUB_TOKEN" \
       -d '{"ref":"main"}'
  

• 常用标志：使用 -f 指定文件路径（例如工作流文件），使用 -env 指定环境变量（例如 -env KEY=VALUE），使用 -wait 阻塞等待完成。
• 配置格式：流水线使用 YAML 定义，例如包含 pipeline { agent any stages { stage('Build') { steps { sh 'mvn build' } } } } 的 Jenkinsfile。

集成说明

通过导出必要的凭据（例如 $GITHUB_TOKEN 环境变量），将此技能与现有工具集成。对于 Jenkins，通过 HTTP 端点连接；对于 GitHub Actions，使用 Webhook。示例：添加一个构建后步骤，调用 OpenClaw Agent 命令，将 CI 工具接入此技能，例如 agent invoke ci-cd-ops --action deploy --config path/to/config.yml。通过匹配版本确保兼容性，例如 Jenkins 2.3+ 或 GitHub Actions API v3。使用 Docker 容器隔离流水线运行环境，以避免冲突。

错误处理

务必检查命令的退出代码；对于 Jenkins，解析 API 响应以检查 HTTP 4xx/5xx 错误。在脚本中使用 try-catch，例如在 bash 包装脚本中：jenkins build ... || echo "Error: Build failed with code $?"。对于 GitHub Actions，通过最多重试 3 次并采用指数退避来处理 Webhook 失败。记录错误时附上时间戳，并包含堆栈跟踪。常见问题：令牌无效——使用前通过 echo $GITHUB_TOKEN 验证；使用 export GITHUB_TOKEN=new_value 解决。使用 -v 等详细模式标志进行调试。

具体使用示例

1. 使用 Jenkins 自动部署 Java 应用： 为 Git 仓库设置流水线。命令：agent invoke ci-cd-ops --tool jenkins --repo [email protected]:user/app.git --job BuildAndDeploy。此命令会触发构建、运行测试，并在成功后部署。配置片段：

   pipeline {
     stages {
       stage('Test') { steps { sh 'mvn test' } }
     }
   }
   

2. 为 Node.js CI 触发 GitHub Actions： 用于拉取请求工作流。命令：agent invoke ci-cd-ops --tool github --workflow ci.yml --event pull_request。此命令会在 PR 上运行 lint 和测试。API 调用示例：

   curl -X POST https://api.github.com/.../dispatches -H "Authorization: token $GITHUB_TOKEN"
   

图关系

• 与集群相关：devops-sre（例如，与 monitoring-tools、deployment-automation 共享节点）。
• 通过标签连接：ci-cd（链接到 build-systems）、devops（链接到 infrastructure-as-code）、automation（链接到 script-execution）。
• 依赖项：需要访问版本控制（例如，git-ops）和监控（例如，log-analyzer）技能。