基于 Jenkins 与 Gitea 的离线环境 CI/CD 自动化搭建指南

2. Jenkins 配置

全局工具配置

无特殊要求。

生成 Git 服务器的公钥

需要在 Jenkins 服务器执行这个命令，并且 SSH 端口需要宿主机真实端口。

[root@Kylin01 plugins]# ssh-keyscan -p 222 -t rsa 192.168.253.137
# 192.168.253.137:222 SSH-2.0-OpenSSH_9.3
[192.168.253.137]:222 ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABgQCpfG5+2lizKDAhCXMXNvmYpRrloXCENzxwihKCWJ7HcfnLHNa+nTGCmmKbqYybn6XB63xeXAxUwj+Al1kHk9mDV28LOQ5o9sFPPKgE0vdHbvSvYTsYxgThFHR3XLnUj/TAasTZLPDkTQo0IP5PeKavy63B5RIIGyd0LH3NgiHbM3LyEr9mjuNr+tbygNrHkCjIye8bT/S8zp5q3y7kclLMUynCLJNEydefqITj2rNU2IqKYoWumCB1G9sFQbKLuPlqu6TU41zJ4n1lQEe/JcCOl+BhJIxcJ3OhEee8dbLYfiuqx3UQGbEswjSSfKZVQb/AcyWZu/1uytNLBaRDKOfm/lcjunQhbaPPIpt2TeYkTgLn3yfPrzQ2S1TJcTI4+cyn0e7teWdMlGOSCCkXCm0bSl9qk1IKeaMMHJ94aclMd6lWBn8qDgwKOtyvJfRDYeZTcv7Ai6YZRYwGH3W81RIg+hBoJyrt0OaYVmLhMOO0rr6aHxz+TD633RWpBjz12Ic=

设置凭据

这里获取的是 Jenkins 服务器的私钥，同时后面 Gitea 服务器也要设置对应同一套的公钥。

[root@Kylin01 plugins]# docker exec -it myjenkins bash
[root@Kylin01 plugins]# ssh-keygen -t rsa -b 4096
root@49413caa42b7:/# cat /root/.ssh/id_rsa
root@49413caa42b7:/# cat /root/.ssh/id_rsa.pub

流水线 Job 配置

后端 Job 的 Trigger 配置

前端 Job 的 Trigger 配置 (为了识别 JSON)

后端 Pipeline Scripts

pipeline {
    agent any
    tools {
        // 请确保在 Jenkins "Global Tool Configuration" 中配置了名为 'maven-3.9.12' 的 Maven
        maven 'maven-3.9.12'
    }
    triggers {
        pollSCM('')
    }
    environment {
        // ================= 配置区 =================
        // 1. 目标宿主机信息 (用于部署)
        REMOTE_IP   = "192.168.253.137"
        DEPLOY_PORT = "22"         // 宿主机 SSH 端口
        REMOTE_USER = "root"
        REMOTE_DIR  = "/app/xhdj_dev/project_backend"      // 2. Gitea 信息 (仅用于拉取代码)
        GITEA_PORT  = "222"         // Gitea 容器映射端口
        GITEA_CRED  = "gitea-ssh-key" // Jenkins 中配置的凭据 ID
        // 3. 待发布的模块列表
        WHITELIST   = "zhdq-auth-web zhdq-gateway zhdq-service-datamiddle-web zhdq-service-file zhdq-service-jobhandle zhdq-service-party-manage-web zhdq-service-party-meeting-web zhdq-service-party-member-web zhdq-service-xxl"
        // 4. 需要检测存活的端口
        CHECK_PORTS = "10200 10005 10206 13800 8012 10204 10203 28305"
        // ==========================================
    }
    stages {
        stage('拉取代码') {
            steps {
                echo "🚚 正在从 Gitea 拉取代码..."
                git credentialsId: "${GITEA_CRED}",
                    url: "ssh://git@${REMOTE_IP}:${GITEA_PORT}/liaoch_1/xh_backend.git",
                    branch: 'main'
            }
        }
        stage('离线编译') {
            steps {
                echo "🔨 开始 Maven 编译 (离线模式)..."
                // -o 为离线模式，如果是第一次编译请去掉 -o
                sh 'mvn clean package -DskipTests -o -s /var/jenkins_home/apache-maven-3.9.12/conf/settings.xml -Dmaven.repo.local=/var/jenkins_home/maven_repository'
            }
        }
        stage('收集并远程推送') {
            steps {
                sh '''
                #!/bin/bash
                set -e
                echo "📂 正在确保远程目录存在：${REMOTE_DIR}"
                ssh -p ${DEPLOY_PORT} ${REMOTE_USER}@${REMOTE_IP} "mkdir -p ${REMOTE_DIR}"
                echo "🔍 开始扫描并推送 JAR 包..."
                for mod in $WHITELIST; do
                    # 查找生成的 jar，排除 sources 和 javadoc
                    jar_path=$(find . -path "*/target/${mod}*.jar" ! -name "*-sources.jar" ! -name "*-javadoc.jar" -type f | head -n 1)
                    if [ -n "$jar_path" ]; then
                        echo "✅ 匹配成功：$mod -> 正在推送..."
                        # 注意：scp 端口是大写 -P
                        scp -P ${DEPLOY_PORT} "$jar_path" "${REMOTE_USER}@${REMOTE_IP}:${REMOTE_DIR}/${mod}.jar"
                    else
                        echo "⚠️ 未找到模块：$mod 的 JAR 文件"
                    fi
                done
                '''
            }
        }
        stage('远程重启并存活检测') {
            steps {
                sh '''
                #!/bin/bash
                ssh -p ${DEPLOY_PORT} ${REMOTE_USER}@${REMOTE_IP} "
                    cd ${REMOTE_DIR}
                    echo '🚀 执行重启脚本...'
                    ./app-manager-linux-amd64 restart
                    echo '⏳ 进入 120 秒初始化等待期...'
                    sleep 120
                    echo '🔍 开始进行端口健康检查...'
                    FAILED_COUNT=0
                    for port in ${CHECK_PORTS}; do
                        # 同时尝试 ss 和 netstat 增加兼容性
                        if ss -lnt | grep -q \":\$port \" || netstat -lnt | grep -q \":\$port \"; then
                            echo \"✅ [OK] 端口 \$port 正常启动\"
                        else
                            echo \"❌ [ERROR] 端口 \$port 未响应！\"
                            FAILED_COUNT=\$((FAILED_COUNT+1))
                        fi
                    done
                    if [ \$FAILED_COUNT -gt 0 ]; then
                        echo \"------------------------------------------\"
                        echo \"❌ 部署失败：共有 \$FAILED_COUNT 个模块未正常启动！\"
                        echo \"------------------------------------------\"
                        exit 1
                    else
                        echo \"------------------------------------------\"
                        echo \"🎊 部署成功：所有微服务均已就绪！\"
                        echo \"------------------------------------------\"
                    fi
                "
                '''
            }
        }
    }
    post {
        always {
            echo "🏁 流程结束。"
        }
        failure {
            echo "❌ 构建失败，请检查 Jenkins 控制台输出和服务器日志。"
        }
    }
}

前端 Pipeline Scripts

pipeline {
    agent any
    environment {
        // 目标部署服务器信息 (137 宿主机)
        REMOTE_IP = "192.168.253.137"
        REMOTE_USER = "root"
        // 生产环境目录
        PROD_DIR = "/app/xhdj_dev/project_frontend"
        // 备份/归档目录
        UPDATE_DIR = "/app/xhdj_dev/project_update/frontend_${BUILD_NUMBER}"
        // Jenkins 凭据 ID (请确保在 Jenkins 凭据里配置了私钥，且 ID 为此值)
        GITEA_CRED = "gitea-ssh-key"
    }
    triggers {
        // 只要 UI 界面配置了 token，脚本里加这段可以确保配置被固化
        GenericTrigger(
            genericVariables: [
                [key: 'ref', value: '$.ref']
            ],
            token: 'xh_frontend_token',
            causeString: 'Gitea Push: $ref',
            printPostContent: true,
            silentResponse: false
        )
    }
    stages {
        stage('Git Checkout') {
            steps {
                echo "🚚 正在从 Gitea 拉取前端代码..."
                // 修正后的地址：使用 222 端口和 xh_frontend 仓库
                git credentialsId: "${GITEA_CRED}",
                    url: "ssh://[email protected]:222/liaoch_1/xh_frontend.git",
                    branch: 'main'
            }
        }
        stage('Front-end Build') {
            steps {
                echo "🛠️ 正在执行离线构建..."
                sh """
                # 1. 环境变量（必须加，否则找不到 node/yarn）
                export NODE_HOME="/var/jenkins_home/node-v20.19.0"
                export YARN_HOME="/var/jenkins_home/yarn-tool"
                export PATH="$NODE_HOME/bin:$YARN_HOME/bin:$PATH"
                # 2. 注入依赖
                CACHE_DIR="/var/jenkins_home/frontend_cache/node_modules"
                if [ -d "$CACHE_DIR" ]; then
                    echo "📦 正在注入 node_modules..."
                    # cp -rn 确保只拷贝缺少的文件，不重复覆盖
                    cp -rn $CACHE_DIR ./
                else
                    echo "❌ 找不到离线依赖目录" && exit 1
                fi
                # 3. 修复 tyarn 找不到的问题
                # 将 package.json 里的 "tyarn" 替换为 "yarn"
                if grep -q "tyarn" package.json; then
                    sed -i 's/tyarn/yarn/g' package.json
                fi
                # 4. 执行构建
                yarn build
                """
            }
        }
        stage('Archive & Deploy') {
            steps {
                echo "🚀 正在同步产物到 137 服务器 (精准模式)..."
                sh """
                # 1. 确保远程目录存在
                ssh -o StrictHostKeyChecking=no ${REMOTE_USER}@${REMOTE_IP} "mkdir -p ${UPDATE_DIR} ${PROD_DIR}"
                # 2. 【核心修正】只传输内层真正的产物
                # 注意这里的路径：dist/project_frontend/*
                echo "📦 正在从 dist/project_frontend 提取文件..."
                scp -r dist/project_frontend/* ${REMOTE_USER}@${REMOTE_IP}:${UPDATE_DIR}/
                # 3. 部署到生产目录
                # 先清空，再用 /. 语法平铺拷贝
                ssh ${REMOTE_USER}@${REMOTE_IP} "
                    rm -rf ${PROD_DIR}/* && \
                    cp -Rf ${UPDATE_DIR}/. ${PROD_DIR}/ && \
                    echo '✅ 部署成功！目录内容：' && \
                    ls -F ${PROD_DIR}
                "
                """
            }
        }
        stage('Health Check') {
            steps {
                echo "🔍 检查 137 服务器上的部署结果..."
                sh "ssh ${REMOTE_USER}@${REMOTE_IP} 'ls -l ${PROD_DIR}'"
            }
        }
    }
    post {
        success {
            echo "✅ 前端自动部署成功！"
        }
        failure {
            echo "❌ 构建失败，请查看 Console Output。"
        }
    }
}

3. Gitea 配置

# 安装 Docker Gitea
tar xf docker-24.0.9.tgz
cp docker/* /usr/bin/
vim /etc/systemd/system/docker.service
systemctl daemon-reload
systemctl enable docker
systemctl start docker
cp docker-compose-linux-x86_64 /usr/local/bin/docker-compose
chmod +x /usr/local/bin/docker-compose
docker-compose version
cd /opt

[root@Kylin01 gitea]# vim docker-compose.yml
version: "3"
networks:
  gitea:
    external: false
services:
  server:
    image: docker.gitea.com/gitea:1.21.4 # 建议使用稳定版，1.25 目前可能过于超前
    container_name: gitea
    environment:
      - USER_UID=1000
      - USER_GID=1000
      # 如果你以后想用 MySQL/PostgreSQL，可以在这里加环境变量
    restart: always
    networks:
      - gitea
    volumes:
      - ./gitea:/data
      - /etc/timezone:/etc/timezone:ro
      - /etc/localtime:/etc/localtime:ro
    ports:
      - "3000:3000"  # Web 访问端口
      - "222:22"     # SSH 端口

id was chown -R was. /opt/gitea
export DOCKER_API_VERSION=1.43
docker-compose up -d

vim gitea/conf/app.ini
[webhook]
ALLOWED_HOST_LIST = *
SKIP_TLS_VERIFY = true
DELIVER_TIMEOUT = 15s

docker restart gitea

# 初始化项目目录
mkdir -p /app/xhdj_dev
cd /app/xhdj_dev
chmod +x app-manager-linux-amd64
./app-manager-linux-amd64 init

# Gitea 代码仓库初始化
# 1. 拉取需要迁移的前后端代码 先拉到本地电脑对应两个目录
git clone http://***.git
# 2. 在 git 新建两个仓库
# 3. 拿到仓库地址
http://192.168.253.137:3000/liaoch_1/xh_frontend.git
http://192.168.253.137:3000/liaoch_1/xh_backend.git
# 4. 将拉下来的代码推送上去
git push --mirror http://192.168.253.137:3000/liaoch_1/xh_frontend.git
git push --mirror http://192.168.253.137:3000/liaoch_1/xh_backend.git

# Webhook 设置
# 前端：http://192.168.253.129:8082/generic-webhook-trigger/invoke?token=xh_frontend_token
# 后端：http://192.168.253.129:8082/generic-webhook-trigger/invoke?token=xh_backend_token（这里的 token 就是前面 Jenkins 的 trigger 里定义的）

# SSH 秘钥设置
# 就是前面在 Jenkins 容器中获取到的 pub 公钥
root@49413caa42b7:/# cat /root/.ssh/id_rsa.pub

4. 测试推送

Gitea 测试推送

然后去 Jenkins 下看是否有任务构建。

推送代码测试

1. 本地电脑修改部分代码
2. 目录终端执行 git add ., git commit -m "测试 Webhook 自动触发构建", git push origin main
3. 查看 Jenkins 是否有新的任务构建
4. 检验是否构建成功
5. 查看对应项目目录下是否有构建成功的 jar 包，前端文件、后端应用是否成功启动