运维|devops|JenkinsPipeline流程构建

　　发布于2026-08-13　阅读（0）

扫一扫，手机访问

运维|devops|Jenkins Pipeline流程构建

基于 jenkins Version 2.541.3 实操案例

Jenkins Pipeline

基于 Groovy 的持续交付流水线代码（Pipeline as Code）

Pipeline script vs Pipeline script from SCM(实操)

Pipeline script
流水线代码直接粘贴在 Jenkins 任务页面文本框内，存储在 Jenkins 任务配置数据库中，不关联 Git 仓库
Pipeline script from SCM
流水线代码（Jenkinsfile）存放在代码仓库 (Git/SVN)，Jenkins 运行流水线时先拉取代码，读取仓库内的 Jenkinsfile 执行

Jenkinsfile 脚本内容的语法格式如下两种

Declarative Pipeline（声明式-实操）这套写法，语法更严格，结构也更清晰，读起来一目了然，放到绝大多数项目里都很合适。

pipeline {
  agent any
  stages {
      stage('构建') {
          steps {
              echo "hello"
          }
      }
  }
}

Scripted Pipeline（脚本式）：基于原生 Groovy 编写，自由度很高，尤其适合处理复杂逻辑。
```
node {
  stage('构建') {
      echo "hello"
  }
}
```

前置条件

git、ssh、jdk、ma ven 等配置

服务器端开启ssh登录

生成密钥
```
ssh-keygen -t rsa -b 4096
```

将公钥添加到本机的 authorized_keys

cat ~/.ssh/id_rsa.pub >> ~/.ssh/authorized_keys

配置 SSH 服务（/etc/ssh/sshd_config)

PubkeyAuthentication yes
PasswordAuthentication yes

重启 SSH 服务
```
sudo systemctl reload sshd
```
将私钥拷贝到Jenkins全局令牌凭证中

Jenkinsfile文件和脚本创建

Jenkinsfile位置放入项目pom同级别

位置参照

Core（仓库根目录｜父pom）
├─ pom.xml                聚合父工程
├─ common-core            公共依赖模块（无需Jenkinsfile）
│  └─ pom.xml
├─ Core.Api      业务子模块
│  ├─ pom.xml
│  └─ Jenkinsfile          当前模块流水线文件

Groovy构建脚本(Jenkinsfile)

pipeline {
  agent any

  options {
      disableConcurrentBuilds()
      timeout(time: 20, unit: 'MINUTES')
      timestamps()
      buildDiscarder(logRotator(numToKeepStr: '10'))
  }

  parameters {
      booleanParam(
          name: 'AUTO_DEPLOY',
          defaultValue: false,
          description: '构建完成自动推送Jar并重启远程服务'
      )
  }

  environment {
      SERVICE_DIR = 'app'
      SERVICE_NAME = 'app'
      JAR_VERSION = '1.0.0-SNAPSHOT'
      JAR_FILE = "${SERVICE_NAME}-${JAR_VERSION}.jar"
      REMOTE_SUB_DIR = "${SERVICE_NAME}"
      REMOTE_FULL_DIR = "/usr/local/${REMOTE_SUB_DIR}"
      LOCAL_JAR_PATH = "${SERVICE_DIR}/target/${JAR_FILE}"
      JA VA_HOME = '/usr/local/jdk21'
      M2_HOME = '/usr/local/ma ven'
      // SSH 配置
      REMOTE_HOST = '192.168.0.66'
      REMOTE_USER = 'test'
      SSH_CREDENTIALS_ID = 'test'
  }

  stages {
      stage('1. 环境信息打印') {
          steps {
              echo "【构建信息】服务名：${env.SERVICE_NAME}｜Jar包：${env.JAR_FILE}"
              echo "本地路径：${env.LOCAL_JAR_PATH}"
              echo "远端目录：${env.REMOTE_FULL_DIR}"
          }
      }

      stage('2. Ma ven编译打包') {
          steps {
              sh '''
                  test -d ${JA VA_HOME} || { echo " JA VA_HOME目录不存在"; exit 1; }
                  test -d ${M2_HOME} || { echo " M2_HOME目录不存在"; exit 1; }
                  ${JA VA_HOME}/bin/ja va -version
                  ${M2_HOME}/bin/mvn -v
                  cd ${SERVICE_DIR}
                  ${M2_HOME}/bin/mvn clean package -DskipTests
              '''
          }
      }

      stage('3. 归档构建产物') {
          steps {
              archiveArtifacts artifacts: "${env.LOCAL_JAR_PATH}", fingerprint: true, onlyIfSuccessful: true
          }
      }

      stage('4. 远程发布部署') {
          when {
              expression { params.AUTO_DEPLOY }
          }
          steps {
              echo "开始推送Jar包并远程重启服务"

              withCredentials([sshUserPrivateKey(
                  credentialsId: "${env.SSH_CREDENTIALS_ID}",
                  keyFileVariable: 'SSH_KEY',
                  usernameVariable: 'SSH_USER'
              )]) {
                  sh """
                      set -e -x
                      # 传输 JAR
                      scp -i $SSH_KEY -o StrictHostKeyChecking=no ${LOCAL_JAR_PATH} ${REMOTE_USER}@${REMOTE_HOST}:${REMOTE_FULL_DIR}/${JAR_FILE}

                      # 远程执行部署【修复pgrep匹配BUG】
                      ssh -i $SSH_KEY -o StrictHostKeyChecking=no ${REMOTE_USER}@${REMOTE_HOST} << 'EOF'
                          export JA VA_HOME=/usr/local/jdk-21.0.11
                          SERVICE_NAME=${SERVICE_NAME}
                          REMOTE_FULL_DIR=${REMOTE_FULL_DIR}
                          JAR_FILE=${JAR_FILE}

                          mkdir -p ${REMOTE_FULL_DIR}
                          cd ${REMOTE_FULL_DIR}

                          # 根据服务名杀死进程，不再写死jar名称
                          pkill -f "${SERVICE_NAME}" || true
                          sleep 1

                          # 后台启动服务
                          nohup ${JA VA_HOME}/bin/ja va -jar ${JAR_FILE} > app.log 2>&1 &
                          sleep 3

                          # 校验进程：匹配服务名称，不再匹配jar短文件名
                          if pgrep -f "${SERVICE_NAME}" > /dev/null; then
                              echo " 服务启动成功"
                          else
                              echo " 服务启动失败，打印最近日志"
                              [ -f app.log ] && tail -15 app.log || echo "app.log 文件尚未生成"
                              exit 1
                          fi
EOF
                  """
              }

              echo "远程部署流程执行完毕"
          }
      }
  }

  post {
      always {
          echo "【Post钩子】流水线构建结束"
      }
      success {
          cleanWs()
          echo " 流水线全部执行成功！"
      }
      failure {
          echo " 流水线执行失败，请查看日志排查问题！"
      }
  }
}

创建Pipeline任务

构建相关pipeline

脚本指向路径

执行构建结果

优化脚本

增加git 打印、和后台应用日志

pipeline {
    agent any

    options {
        disableConcurrentBuilds()
        timeout(time: 20, unit: 'MINUTES')
        timestamps()
        buildDiscarder(logRotator(numToKeepStr: '10'))
    }

    parameters {
        booleanParam(
            name: 'AUTO_DEPLOY',
            defaultValue: false,
            description: '构建完成自动推送Jar并重启远程服务'
        )
    }

    environment {
        SERVICE_DIR = 'app'
        SERVICE_NAME = 'app'
        JAR_VERSION = '1.0.0-SNAPSHOT'
        JAR_FILE = "${SERVICE_NAME}-${JAR_VERSION}.jar"
        REMOTE_SUB_DIR = "${SERVICE_NAME}"
        REMOTE_FULL_DIR = "/usr/local/${REMOTE_SUB_DIR}"
        LOCAL_JAR_PATH = "${SERVICE_DIR}/target/${JAR_FILE}"
        JA VA_HOME = '/usr/local/jdk21'
        M2_HOME = '/usr/local/ma ven'
        REMOTE_HOST = '192.168.0.66'
        REMOTE_USER = 'test'
        SSH_CREDENTIALS_ID = 'test'
    }

    stages {
        stage('1. 环境信息 & Git提交日志打印') {
            steps {
                sh '''#!/bin/bash
                    echo "==================== Git 最新提交信息 ===================="
                    echo "短提交号: $(git rev-parse --short HEAD)"
                    echo "完整commit: $(git rev-parse HEAD)"
                    echo "提交人姓名: $(git log -1 --pretty=%an)"
                    echo "提交备注:"
                    git log -1 --pretty=%B
                    echo "=========================================================="
                '''

                echo "【构建信息】服务名：${env.SERVICE_NAME}｜Jar包：${env.JAR_FILE}"
                echo "本地路径：${env.LOCAL_JAR_PATH}"
                echo "远端目录：${env.REMOTE_FULL_DIR}"
            }
        }

        stage('2. Ma ven编译打包') {
            steps {
                sh '''#!/bin/bash
                    test -d ${JA VA_HOME} || { echo " JA VA_HOME目录不存在"; exit 1; }
                    test -d ${M2_HOME} || { echo " M2_HOME目录不存在"; exit 1; }
                    ${JA VA_HOME}/bin/ja va -version
                    ${M2_HOME}/bin/mvn -v
                    cd ${SERVICE_DIR}
                    ${M2_HOME}/bin/mvn clean package -DskipTests
                '''
            }
        }

        stage('3. 归档构建产物') {
            steps {
                archiveArtifacts artifacts: "${env.LOCAL_JAR_PATH}", fingerprint: true, onlyIfSuccessful: true
            }
        }

        stage('4. 远程发布部署') {
            when {
                expression { params.AUTO_DEPLOY }
            }
            steps {
                echo "开始推送Jar包并远程重启服务"

                withCredentials([sshUserPrivateKey(
                    credentialsId: "${env.SSH_CREDENTIALS_ID}",
                    keyFileVariable: 'SSH_KEY',
                    usernameVariable: 'SSH_USER'
                )]) {
                    // ===== 使用三双引号 """ 允许Groovy解析Jenkins环境变量 =====
                    sh """#!/bin/bash
                        set -e -x
                        scp -i $SSH_KEY -o StrictHostKeyChecking=no ${LOCAL_JAR_PATH} ${REMOTE_USER}@${REMOTE_HOST}:${REMOTE_FULL_DIR}/${JAR_FILE}

                        ssh -i $SSH_KEY -o StrictHostKeyChecking=no ${REMOTE_USER}@${REMOTE_HOST} << EOF
                            SERVICE_NAME=${SERVICE_NAME}
                            REMOTE_FULL_DIR=${REMOTE_FULL_DIR}
                            JAR_FILE=${JAR_FILE}

                            mkdir -p ${REMOTE_FULL_DIR}
                            cd ${REMOTE_FULL_DIR}

                            echo "【1】优雅停止旧服务进程"
                            pgrep -f "ja va.*${SERVICE_NAME}" | xargs kill -15 2>/dev/null || true
                            sleep 2
                            pgrep -f "ja va.*${SERVICE_NAME}" | xargs kill -9 2>/dev/null || true
                            sleep 1

                            echo "【2】启动新服务 >> 追加日志，不再清空日志文件"
                            # 远端服务器JA VA路径【硬编码】，彻底避开变量冲突大坑
                            nohup /usr/local/jdk-21.0.11/bin/ja va -Dfile.encoding=UTF-8 -jar ${JAR_FILE} >> app.log 2>&1 &
                            sleep 3

                            echo "========== 远端应用启动日志（尾部30行） =========="
                            [ -f app.log ] && tail -30 app.log || echo "app.log 文件尚未生成"
                            echo "===================================================="

                            echo "【3】校验进程状态"
                            if pgrep -f "ja va.*${SERVICE_NAME}" > /dev/null; then
                                echo " 服务进程启动成功"
                            else
                                echo " 服务启动失败！"
                                exit 1
                            fi
EOF
                    """
                }

                echo "远程部署流程执行完毕"
            }
        }
    }

    post {
        always {
            echo "【Post钩子】流水线构建结束"
        }
        success {
            cleanWs()
            echo " 流水线全部执行成功！"
        }
        failure {
            echo " 流水线执行失败，请查看日志排查问题！"
        }
    }
}

优化脚本之后

本文转载于：https://segmentfault.com/a/1190000048093086 如有侵犯，请联系zhengruancom@outlook.com删除。
免责声明：正软商城发布此文仅为传递信息，不代表正软商城认同其观点或证实其描述。

上一篇：运维|devops|jenkins构建分支选择及执行日志展示

下一篇：Linux系统之passwd命令的基本使用

产品推荐

售后无忧
立即购买>

DAEMON Tools Lite 10【序列号终身授权 + 中文版 + Win】

￥150.00
office旗舰店
售后无忧
立即购买>

DAEMON Tools Ultra 5【序列号终身授权 + 中文版 + Win】

￥198.00
office旗舰店
售后无忧
立即购买>

DAEMON Tools Pro 8【序列号终身授权 + 中文版 + Win】

￥189.00
office旗舰店
售后无忧
立即购买>

CorelDRAW X8 简体中文【标准版 + Win】

￥1788.00
office旗舰店

正版软件

登录与切换用户

## 介绍在 Linux 系统里，多用户共享同一个环境几乎是家常便饭。对于系统管理员来说，用户账户怎么管、不同用户之间怎么切，这些都不是边角料，而是必须熟练掌握的基本功。这次挑战，重点考察的就是 Linux 环境下的用户管理和身份验证能力。 ### 环境说明 LabEx 使用红帽通用基础镜像 9（

4分钟前 0
正版软件

管理文件权限

## 介绍在 Linux 系统里，文件权限是控制文件和目录访问的关键。本次挑战重点考察你对 `chmod` 命令的使用能力，而这正是系统管理员和 Linux 用户都必须熟练掌握的基础技能。 ### 环境说明 LabEx 使用红帽通用基础镜像 9（UBI9）来模拟考试环境。虽然它和真实的 RHCSA

5分钟前 0
正版软件

管理默认文件权限

介绍在这个挑战里，要练的是 Linux 里一个很基础、但特别关键的能力：管理默认文件权限。很多时候，文件和目录一创建出来，权限就已经“定型”了，所以如果默认权限没设好，后面再补救就会很被动。这里要做的，就是通过 umask 命令来设置默认权限掩码，并观察它到底会怎样影响新建对象的权限表现。使用

6分钟前 0
正版软件

管理日志与归档文件

介绍在这次挑战里，你要练习的是日志分析和文件归档这两项核心系统管理技能。具体来说，就是在模拟日志文件中查找指定条目并导出，然后把某个目录打成归档文件。这类操作在故障排查和备份场景里很常见，算是系统管理中的基本功。环境 LabEx 使用 Red Hat Universal Base Image 9

8分钟前 0
正版软件

Ansible 角色和集合在 RHEL 上的应用

介绍在本实验中，你将学习如何利用 Ansible Roles 和 Collections 的强大功能和可重用性，来自动化配置 Red Hat Enterprise Linux (RHEL) Web 服务器。你将通过创建自定义角色来部署特定配置，将来自 Git 仓库的外部角色作为依赖项集成，并利用 A

8分钟前 0