Jenkins怎样配置流水线

下面按从零开始的思路，给你讲一下 Jenkins 如何配置流水线（Pipeline），从概念到实际操作。

一、什么是 Jenkins Pipeline

Jenkins Pipeline 是一套用代码定义构建、测试、部署流程的方式，常见两种写法：

1. Declarative Pipeline（推荐，结构清晰）
2. Scripted Pipeline（旧式，Groovy 脚本）

✅ 新手建议用 Declarative Pipeline

二、前置条件

1. 已安装 Jenkins
2. 安装必要插件：
   • Pipeline
   • Git
   • （可选）Docker / Maven / NodeJS 等

Jenkins → Manage Jenkins → Manage Plugins → 安装插件

三、创建 Pipeline 任务的两种方式

方式一：在 Jenkins 页面中直接写 Pipeline（最简单）

1. 新建任务

• 点击 New Item
• 输入名称
• 选择 Pipeline
• 点击 OK

2. 配置 Pipeline

在 Pipeline 区域：

• Definition 选择：Pipeline script
• 在 Script 中填写：

pipeline {
    agent any

    stages {
        stage('拉取代码') {
            steps {
                git 'https://github.com/your/repo.git'
            }
        }

        stage('构建') {
            steps {
                echo 'Building...'
                sh 'mvn clean package'
            }
        }

        stage('部署') {
            steps {
                echo 'Deploying...'
            }
        }
    }
}

点击 Save → Build Now

方式二：使用 Jenkinsfile（推荐，企业常用）

1. 在项目根目录创建 Jenkinsfile

pipeline {
    agent any

    stages {
        stage('Checkout') {
            steps {
                git branch: 'main', url: 'https://github.com/your/repo.git'
            }
        }

        stage('Build') {
            steps {
                sh 'npm install'
                sh 'npm run build'
            }
        }
    }
}

2. Jenkins 中配置

• New Item → Pipeline
• Definition 选择：

  Pipeline script from SCM
  

• SCM 选择 Git
• Repository URL 填仓库地址
• Script Path 填：Jenkinsfile

四、常用 Pipeline 配置项

1. 指定构建节点

agent {
    label 'build-node'
}

2. 环境变量

environment {
    ENV = 'prod'
}

3. 条件执行

stage('Deploy') {
    when {
        branch 'main'
    }
    steps {
        echo 'Deploy to prod'
    }
}

4. 失败处理

post {
    failure {
        echo '构建失败'
    }
    success {
        echo '构建成功'
    }
}

五、示例：完整 Java 项目 Pipeline

pipeline {
    agent any

    stages {
        stage('Checkout') {
            steps {
                git 'https://github.com/xxx/xxx.git'
            }
        }
        stage('Build') {
            steps {
                sh 'mvn clean package'
            }
        }
        stage('Test') {
            steps {
                sh 'mvn test'
            }
        }
    }

    post {
        always {
            echo '流水线结束'
        }
    }
}

六、调试建议

• 用 echo 打印变量
• 查看 Blue Ocean（可视化流水线）
• 日志中看每一步执行结果

如果你愿意，我可以：

• ✅ 给你一个 前端 / Java / Python 专属 Pipeline
• ✅ 帮你写 Docker + Jenkins 流水线
• ✅ 解决你当前 Jenkins 报错

你可以直接说：“我是 XXX 项目，用的是 XXX 技术栈。”