jenkins pipeline 定义复杂流水线应以声明式语法（pipeline{}）为主干，确保结构清晰、阶段可视、错误易定位；在 script{} 块中嵌入脚本式 groovy 处理循环、动态分支等复杂逻辑，兼顾可维护性与灵活性。

用 Jenkins Pipeline 定义复杂流水线，关键不在写得多，而在结构清、控制准、可维护强。它不是把一堆命令堆进 Jenkinsfile，而是用代码逻辑组织构建、测试、部署各环节的协作关系与边界条件。

明确声明式为主、脚本式为辅的混合策略

新项目统一用声明式语法（pipeline{}）打底，保证结构清晰、阶段可视、错误易定位；遇到循环、动态分支、异常重试等复杂逻辑时，在 script{} 块里嵌入脚本式 Groovy 代码。这样既保留团队协作友好性，又不失灵活性。

• 声明式负责主干流程：拉代码 → 编译 → 单元测试 → 构建镜像 → 推送仓库 → 部署
• 脚本式嵌入点举例：script{ if (env.BRANCH_NAME == 'main') { sh 'kubectl rollout restart deployment/myapp' } }
• 避免全量使用脚本式——它虽灵活，但缺乏内置校验，CI 稳定性易受 Groovy 语法细节影响

用 environment + parameters + input 实现多环境可控部署

一套流水线跑多个环境（dev/staging/prod），靠硬编码切换容易出错。正确做法是通过参数化触发 + 环境变量隔离 + 人工确认关卡来分层控制。

Ralph Loop (Agent Mode)

引导 OpenClaw 代理使用 exec 和 process 工具执行 Ralph Wiggum 循环。通过 pty:true 提供正确的 TTY 支持，编排编码代理（Codex, Claude Code, OpenCode, Goose）。利用 PROMPT.md、AGENTS.md、SPECS 和 IMPLEMENTATION_PLAN.md 规划和构建代码。包含规划与构建模式、背压机制、沙箱及完成条件。用户请求循环，代理使用工具执行。

下载

• parameters 定义可选参数，如 string(name: 'TARGET_ENV', defaultValue: 'dev', description: '部署目标环境')
• environment 按环境加载配置：if (params.TARGET_ENV == 'prod') { DOCKER_TAG = 'stable' }
• input 放在 prod 阶段前：input message: '确认部署到生产环境？', ok: '发布'，防止误操作

并行执行与失败隔离提升效率与健壮性

单元测试、静态扫描、安全检查这些不相互依赖的任务，完全可以并行运行；同时要确保某个子任务失败不影响其他并行分支继续执行，并能汇总结果。

• 用 parallel 包裹独立 stage：parallel 'unit': { stage('Unit Test') { steps { sh 'mvn test' } } }, 'lint': { stage('Code Lint') { steps { sh 'npm run lint' } } }
• 每个并行分支内加 post { always { ... } } 记录日志或上传报告，避免因一个失败导致整体中断
• 主 stage 的 post { failure { emailext(...) } } 用于兜底告警，而不是只依赖单个步骤的 try-catch

借助共享库封装重复逻辑，避免 Jenkinsfile 膨胀

当多个项目都要做“构建 Docker 镜像”“推送至私有 Registry”“滚动更新 K8s Deployment”，把这些通用操作抽成共享库函数，比在每个 Jenkinsfile 里复制粘贴更安全、更易升级。

• 创建全局共享库（如名为 shared-lib），目录结构含 vars/dockerBuild.groovy 和 vars/k8sDeploy.groovy
• Jenkinsfile 中引用：@Library('shared-lib') _，然后直接调用 dockerBuild(imageName: 'myapp', tag: 'latest')
• 版本化共享库（绑定 Git Tag），确保某次流水线执行始终使用确定版本的工具函数