Jenkins Pipeline进阶：agent、parameters与stages详解

本文档主要介绍了 Jenkins Pipeline 的进阶语法，重点讨论了 agent、parameters 和 stages 三个关键概念。 1. Agent 语法： Agent 是 Jenkins Pipeline 中用于指定任务执行节点的关键元素。它决定了任务将在哪个节点上运行。在 pipeline 的开始位置或 stage 内部定义 agent 可能有不同的含义： - `agent any`：允许任务在任何可用的 agent 节点上运行，适合无需特定环境的通用任务。 - `agent { label 'jenkins-slave1-107' }`：通过标签指定任务必须在带有特定标签（如 'jenkins-slave1-107'）的节点上执行，这样可以更好地管理资源。 - `agent docker { image 'maven:3-alpine' }`：使用 Docker 容器执行任务，提供了一个隔离的运行环境，例如使用 Maven 3 镜像。 - `agent none`：不为整个 pipeline 分配全局 agent，要求每个 stage 明确指定其执行节点。 2. Parameters（参数）： Parameters 用于实现参数化构建流程，使用户能够根据需要传递不同的输入到 pipeline 中。常见的参数类型包括： - `choice` 参数：选项参数，提供了预定义的选择列表，如 `name: 'target', choices: ['线上环境', '测试环境']`，用于选择目标环境。 - `string` 参数：提供输入框让用户输入文本，例如 `name: 'PROJECT', defaultValue: 'know-system'`。 - `gitParameter`：允许用户从 Git 仓库选择分支，包括默认值和描述信息。 3. Stages（阶段）： Stages 是 pipeline 的核心结构，用于组织和分隔任务逻辑。每个 stage 包含一组命令或操作，它们按顺序执行。以下是一个包含 parameters 和 stages 的示例： ``` pipeline { agent any parameters { choice(name: 'target', choices: ['线上环境', '测试环境'], description: '选择部署环境') } stages { stage('编译') { steps { // 编译阶段的命令 } } stage('测试') { when { expression { params.target == '测试环境' } } steps { // 测试阶段的命令 } } stage('部署') { steps { // 部署阶段的命令 } } } } ``` 这个例子展示了如何在不同的 stages 中根据 `target` 参数的不同值执行不同的操作。 Jenkins Pipeline 的语法允许开发者灵活地配置任务执行的节点、接收用户输入并组织复杂的任务流程。熟练掌握这些概念有助于编写更高效、可维护的自动化构建管道。