Jenkins 基础(4)：企业实战篇 —— 版本控制+多环境部署+容器化交付#

1
pipeline {
2
    agent any
3
    environment {
4
        // 根据内置变量 env.BRANCH_NAME 动态决定部署环境
5
        DEPLOY_ENV = "${env.BRANCH_NAME == 'main' ? 'prod' : env.BRANCH_NAME}"
6
    }
7
    stages {
8
        stage('Deploy') {
9
            steps {
10
                echo "当前分支为 ${env.BRANCH_NAME}，准备发布到 ${DEPLOY_ENV} 环境..."
11
                // 后续可根据 DEPLOY_ENV 加载不同的配置
12
            }
13
        }
14
    }
15
}

1
pipeline {
2
    agent any
3
    tools {
4
        maven 'maven-3.8.8' // 引用系统配置中定义的 Maven 工具
5
        jdk 'jdk-17'
6
    }
7
    options {
8
        timestamps()
9
        disableConcurrentBuilds()
10
    }
11
    environment {
12
        APP_NAME = 'user-service'
13
    }
14
    stages {
15
        stage('1. Maven Build') {
16
            steps {
17
                echo "开始编译打包..."
18
                // 执行 Maven 编译，跳过单元测试加快打包速度
19
                sh "mvn clean package -DskipTests"
20
            }
21
        }
22

23
        stage('2. Deploy via SSH') {
24
            steps {
25
                echo "开始部署到目标服务器..."
26
                // 使用 Publish Over SSH 插件的 sshPublisher 语法
27
                // 注意：这里 configName 的值需与系统设置中配置的服务器名称完全一致
28
                sshPublisher(publishers: [
29
                    sshPublisherDesc(
30
                        configName: 'app-server-dev',
31
                        transfers: [
32
                            sshTransfer(
33
                                sourceFiles: 'target/*.jar',
34
                                removePrefix: 'target/',
35
                                remoteDirectory: '/opt/apps/user-service/',
36
                                // 传输完成后在目标服务器执行的重启命令
37
                                execCommand: '''
38
                                    cd /opt/apps/user-service
39
                                    # 优雅停机并备份
40
                                    ps -ef | grep user-service.jar | grep -v grep | awk '{print $2}' | xargs -r kill -9
41
                                    mv user-service.jar user-service-$(date +%Y%m%d%H%M%S).jar.bak || true
42
                                    # 启动新版本
43
                                    mv *.jar user-service.jar
44
                                    nohup java -jar -Xms512m -Xmx512m user-service.jar > app.log 2>&1 &
45
                                    echo "服务已成功启动！"
46
                                '''
47
                            )
48
                        ]
49
                    )
50
                ])
51
            }
52
        }
53
    }
54
}

1
pipeline {
2
    agent any
3
    tools {
4
        nodejs 'node-18' // 自动注入 node 和 npm 命令
5
    }
6
    stages {
7
        stage('1. Install Dependencies') {
8
            steps {
9
                echo "安装前端依赖..."
10
                sh 'npm config set registry https://registry.npmmirror.com'
11
                sh 'npm install'
12
            }
13
        }
14

15
        stage('2. Build Project') {
16
            steps {
17
                echo "开始前端打包..."
18
                sh 'npm run build'
19

20
                // 将打包产物 dist 目录压缩，极大加快网络传输速度
21
                sh 'tar -zcvf dist.tar.gz dist/'
22
            }
23
        }
24

25
        stage('3. Sync to Nginx') {
26
            steps {
27
                // 这里演示另一种部署方式：直接使用 ssh 命令行配合 credentials
28
                withCredentials([sshUserPrivateKey(credentialsId: 'nginx-server-key', keyFileVariable: 'SSH_KEY', usernameVariable: 'SSH_USER')]) {
29
                    sh '''
30
                        echo "上传压缩包到 Nginx 服务器..."
31
                        scp -i $SSH_KEY -o StrictHostKeyChecking=no dist.tar.gz $SSH_USER@192.168.1.100:/tmp/
32

33
                        echo "在远程执行解压和替换操作..."
34
                        ssh -i $SSH_KEY -o StrictHostKeyChecking=no $SSH_USER@192.168.1.100 "
35
                            cd /usr/share/nginx/html &&
36
                            rm -rf ./my-web-app/* &&
37
                            tar -zxvf /tmp/dist.tar.gz -C ./my-web-app --strip-components=1 &&
38
                            rm -f /tmp/dist.tar.gz
39
                        "
40
                    '''
41
                }
42
            }
43
        }
44
    }
45
}

1
pipeline {
2
    agent any
3
    environment {
4
        // 定义镜像相关信息
5
        IMAGE_NAME = "my-registry.com/my-group/api-service"
6
        // 使用 Jenkins 的构建号作为镜像的 Tag，实现版本可追溯
7
        IMAGE_TAG = "v1.0.${env.BUILD_NUMBER}"
8
        REGISTRY_CRED_ID = "harbor-auth-cred"
9
    }
10
    stages {
11
        stage('1. Compile Code') {
12
            steps {
13
                // 此处省略 Maven/Node 编译步骤，假设已生成可执行文件到 target/ 目录
14
                echo "代码编译完成"
15
            }
16
        }
17

18
        stage('2. Build Docker Image') {
19
            steps {
20
                echo "开始构建 Docker 镜像: ${IMAGE_NAME}:${IMAGE_TAG}"
21
                script {
22
                    // 使用 docker 插件内置方法构建镜像
23
                    // 会自动寻找当前目录下的 Dockerfile
24
                    dockerImage = docker.build("${IMAGE_NAME}:${IMAGE_TAG}")
25
                }
26
            }
27
        }
28

29
        stage('3. Push to Registry') {
30
            steps {
31
                echo "推送镜像到私有仓库..."
32
                script {
33
                    // 使用 withRegistry 自动处理 docker login
34
                    // 第一个参数是仓库 URL，第二个是凭证 ID
35
                    docker.withRegistry('https://my-registry.com', REGISTRY_CRED_ID) {
36
                        dockerImage.push()
37
                        // 顺便打一个 latest 标签并推送
38
                        dockerImage.push('latest')
39
                    }
40
                }
41
            }
42
        }
43

44
        stage('4. Clean Local Image') {
45
            steps {
46
                echo "清理 Jenkins 本地的废弃镜像，防止磁盘空间耗尽..."
47
                sh "docker rmi ${IMAGE_NAME}:${IMAGE_TAG} || true"
48
            }
49
        }
50

51
        stage('5. Trigger Remote Deployment') {
52
            steps {
53
                // 通知目标服务器拉取新镜像并重启容器
54
                withCredentials([sshUserPrivateKey(credentialsId: 'prod-server-key', keyFileVariable: 'SSH_KEY')]) {
55
                    sh """
56
                        ssh -i \$SSH_KEY -o StrictHostKeyChecking=no root@192.168.1.200 '
57
                            # 登录镜像仓库
58
                            docker login -u "\$REGISTRY_USER" -p "\$REGISTRY_PWD" my-registry.com
59
                            # 拉取最新镜像
60
                            docker pull ${IMAGE_NAME}:${IMAGE_TAG}
61
                            # 重启服务 (假设使用 docker-compose)
62
                            cd /opt/deploy/api-service
63
                            # 修改 .env 文件中的镜像 TAG
64
                            sed -i "s/IMAGE_VERSION=.*/IMAGE_VERSION=${IMAGE_TAG}/g" .env
65
                            docker-compose up -d
66
                        '
67
                    """
68
                }
69
            }
70
        }
71
    }
72
}