重构部署方案 远程发版

This commit is contained in:
zk
2026-05-27 15:07:23 +08:00
parent af6a55c660
commit a58e660933
3 changed files with 75 additions and 82 deletions
-2
View File
@@ -1,5 +1,3 @@
# syntax=docker/dockerfile:1
# 使用 Python 3.12 slim 镜像 # 使用 Python 3.12 slim 镜像
FROM python:3.12-slim FROM python:3.12-slim
Vendored
+71 -75
View File
@@ -1,10 +1,8 @@
/** /**
* OfferPie Python AI 蓝绿部署流水线 * OfferPie Python AI 蓝绿部署流水线
* *
* 工作目录说明: * 架构:Jenkins 本地编译 → scp 镜像到目标机 → SSH 远程蓝绿切换
* - Jenkins 会自动为每个项目创建独立的工作空间:/var/jenkins_home/workspace/<项目名>/ * 目标机目录:/opt/offerpie/python-ai/
* - docker-compose.yml 和 Dockerfile 都在项目根目录,直接执行即可
* - nginx.conf 在项目根目录,首次部署时 docker cp 进 nginx 容器
*/ */
pipeline { pipeline {
agent any agent any
@@ -14,14 +12,28 @@ pipeline {
} }
environment { environment {
CONTAINER_PREFIX = 'offerpie-ai' // 容器名前缀,拼接 -blue / -green / -nginx // 目标服务器配置
HEALTH_URL = 'http://localhost:8000/health/' // 应用健康检查地址 DEPLOY_HOST = '8.138.180.255'
DEPLOY_PORT = '22'
DEPLOY_USER = 'root'
DEPLOY_PASS = 'sh.0807.'
// 项目配置
IMAGE_NAME = 'offerpie-ai'
IMAGE_TAG = 'latest'
CONTAINER_PREFIX = 'offerpie-ai'
REMOTE_DIR = '/opt/offerpie/python-ai'
HEALTH_URL = 'http://localhost:8000/health/'
// SSH 命令前缀
SSH_CMD = "sshpass -p '${DEPLOY_PASS}' ssh -o StrictHostKeyChecking=no -p ${DEPLOY_PORT} ${DEPLOY_USER}@${DEPLOY_HOST}"
SCP_CMD = "sshpass -p '${DEPLOY_PASS}' scp -o StrictHostKeyChecking=no -P ${DEPLOY_PORT}"
} }
stages { stages {
stage('开始提示') { stage('环境检查') {
steps { steps {
echo "OfferPie Python AI 开始构建" sh 'sshpass -V'
} }
} }
@@ -34,18 +46,36 @@ pipeline {
} }
} }
/** stage('本地编译') {
* 检测部署目标 steps {
* - 检查 blue 和 green 容器的运行状态 echo "开始构建镜像"
* - blue 在运行 → 部署 greengreen 在运行 → 部署 blue sh "docker build -t ${IMAGE_NAME}:${IMAGE_TAG} ."
* - 都不在或都在 → 默认部署 blue echo "导出镜像"
*/ sh "docker save -o ${IMAGE_NAME}.tar ${IMAGE_NAME}:${IMAGE_TAG}"
}
}
stage('文件传输') {
steps {
echo "传输文件到目标服务器"
sh "${SSH_CMD} 'mkdir -p ${REMOTE_DIR}'"
sh "${SCP_CMD} ${IMAGE_NAME}.tar ${DEPLOY_USER}@${DEPLOY_HOST}:${REMOTE_DIR}/"
sh "${SCP_CMD} nginx.conf ${DEPLOY_USER}@${DEPLOY_HOST}:${REMOTE_DIR}/nginx.conf"
sh "${SCP_CMD} docker-compose.yml ${DEPLOY_USER}@${DEPLOY_HOST}:${REMOTE_DIR}/docker-compose.yml"
}
}
stage('加载镜像') {
steps {
sh "${SSH_CMD} 'docker load < ${REMOTE_DIR}/${IMAGE_NAME}.tar'"
}
}
stage('检测部署目标') { stage('检测部署目标') {
steps { steps {
echo "检查当前容器状态"
script { script {
def blueRunning = sh(script: "docker ps -q -f name=${CONTAINER_PREFIX}-blue", returnStdout: true).trim() def blueRunning = sh(script: "${SSH_CMD} 'docker ps -q -f name=${CONTAINER_PREFIX}-blue'", returnStdout: true).trim()
def greenRunning = sh(script: "docker ps -q -f name=${CONTAINER_PREFIX}-green", returnStdout: true).trim() def greenRunning = sh(script: "${SSH_CMD} 'docker ps -q -f name=${CONTAINER_PREFIX}-green'", returnStdout: true).trim()
env.DEPLOY_TARGET = '' env.DEPLOY_TARGET = ''
@@ -66,47 +96,33 @@ pipeline {
} }
} }
/** stage('启动新版本') {
* 构建新版本
* - 先清理目标颜色的旧容器(如果残留)
* - docker-compose build 编译新镜像
*/
stage('构建新版本') {
steps { steps {
script { script {
def existingContainer = sh(script: "docker ps -aq -f name=${CONTAINER_PREFIX}-${env.DEPLOY_TARGET}", returnStdout: true).trim() def existingContainer = sh(script: "${SSH_CMD} 'docker ps -aq -f name=${CONTAINER_PREFIX}-${env.DEPLOY_TARGET}'", returnStdout: true).trim()
if (existingContainer) { if (existingContainer) {
echo "清理已存在的容器: ${CONTAINER_PREFIX}-${env.DEPLOY_TARGET}" sh "${SSH_CMD} 'docker rm -f ${CONTAINER_PREFIX}-${env.DEPLOY_TARGET}'"
sh "docker rm -f ${CONTAINER_PREFIX}-${env.DEPLOY_TARGET}"
} }
sh "docker-compose build ${env.DEPLOY_TARGET}" sh "${SSH_CMD} 'cd ${REMOTE_DIR} && docker compose up -d ${env.DEPLOY_TARGET}'"
sh 'sleep 15'
} }
} }
} }
/**
* 检查 Nginx
* - 检查 nginx 容器是否存在
* - 不存在则启动并复制配置文件(首次部署)
* - 存在则确保容器运行中
*/
stage('检查Nginx') { stage('检查Nginx') {
steps { steps {
script { script {
def nginxExists = sh(script: "docker ps -aq -f name=${CONTAINER_PREFIX}-nginx", returnStdout: true).trim() def nginxExists = sh(script: "${SSH_CMD} 'docker ps -aq -f name=${CONTAINER_PREFIX}-nginx'", returnStdout: true).trim()
if (!nginxExists) { if (!nginxExists) {
echo "首次部署,初始化 Nginx 容器" echo "首次部署,初始化 Nginx 容器"
sh "docker-compose up -d nginx" sh "${SSH_CMD} 'cd ${REMOTE_DIR} && docker compose up -d nginx'"
sh "sleep 3" sh 'sleep 3'
// 复制配置文件到容器内
sh "docker cp nginx.conf ${CONTAINER_PREFIX}-nginx:/etc/nginx/nginx.conf"
sh "docker exec ${CONTAINER_PREFIX}-nginx nginx -s reload"
} else { } else {
def nginxRunning = sh(script: "docker ps -q -f name=${CONTAINER_PREFIX}-nginx", returnStdout: true).trim() def nginxRunning = sh(script: "${SSH_CMD} 'docker ps -q -f name=${CONTAINER_PREFIX}-nginx'", returnStdout: true).trim()
if (!nginxRunning) { if (!nginxRunning) {
echo "Nginx 容器已停止,重新启动" echo "Nginx 容器已停止,重新启动"
sh "docker start ${CONTAINER_PREFIX}-nginx" sh "${SSH_CMD} 'docker start ${CONTAINER_PREFIX}-nginx'"
sh "sleep 2" sh 'sleep 2'
} }
echo "Nginx 容器已存在且运行中" echo "Nginx 容器已存在且运行中"
} }
@@ -114,23 +130,6 @@ pipeline {
} }
} }
stage('启动新版本') {
steps {
script {
sh "docker-compose up -d ${env.DEPLOY_TARGET}"
// 等待 FastAPI 应用启动
sh 'sleep 15'
}
}
}
/**
* 健康检查
* - 进入容器执行 curl 检测应用是否正常响应
* - curl -f 参数:HTTP 错误码(404、500等)时返回失败
* - 最多重试 3 次,每次间隔 5 秒
* - 全部失败则终止部署流程
*/
stage('健康检查') { stage('健康检查') {
steps { steps {
script { script {
@@ -140,7 +139,7 @@ pipeline {
while (retryCount < maxRetries && !healthy) { while (retryCount < maxRetries && !healthy) {
try { try {
sh "docker exec ${CONTAINER_PREFIX}-${env.DEPLOY_TARGET} curl -f ${HEALTH_URL}" sh "${SSH_CMD} 'docker exec ${CONTAINER_PREFIX}-${env.DEPLOY_TARGET} curl -f ${HEALTH_URL}'"
healthy = true healthy = true
} catch (Exception e) { } catch (Exception e) {
retryCount++ retryCount++
@@ -159,38 +158,34 @@ pipeline {
} }
} }
/**
* 切换流量
* - 修改 nginx 配置中的 proxy_pass 指向新版本容器
* - nginx 不挂载宿主机文件,直接 sed -i 修改容器内配置
* - reload 使新配置生效,实现零停机切换
*/
stage('切换流量') { stage('切换流量') {
steps { steps {
script { script {
sh "docker exec ${CONTAINER_PREFIX}-nginx sed -i 's/proxy_pass http:\\/\\/\\(blue\\|green\\):8000;/proxy_pass http:\\/\\/${env.DEPLOY_TARGET}:8000;/' /etc/nginx/nginx.conf" sh "${SSH_CMD} \"sed -i 's/proxy_pass http:\\/\\/\\(blue\\|green\\):8000;/proxy_pass http:\\/\\/${env.DEPLOY_TARGET}:8000;/' ${REMOTE_DIR}/nginx.conf\""
sh "docker exec ${CONTAINER_PREFIX}-nginx nginx -s reload" sh "${SSH_CMD} 'docker exec ${CONTAINER_PREFIX}-nginx nginx -s reload'"
echo "✅ 流量已切换到 ${env.DEPLOY_TARGET}" echo "✅ 流量已切换到 ${env.DEPLOY_TARGET}"
} }
} }
} }
/**
* 停止并删除旧版本
* - 不能用 docker-compose down,会删除所有服务(包括 nginx)
* - 用 docker rm -f 只删除指定的旧颜色容器
*/
stage('删除旧版本') { stage('删除旧版本') {
steps { steps {
script { script {
def otherExists = sh(script: "docker ps -aq -f name=${CONTAINER_PREFIX}-${env.OTHER_TARGET}", returnStdout: true).trim() def otherExists = sh(script: "${SSH_CMD} 'docker ps -aq -f name=${CONTAINER_PREFIX}-${env.OTHER_TARGET}'", returnStdout: true).trim()
if (otherExists) { if (otherExists) {
sh "docker rm -f ${CONTAINER_PREFIX}-${env.OTHER_TARGET}" sh "${SSH_CMD} 'docker rm -f ${CONTAINER_PREFIX}-${env.OTHER_TARGET}'"
echo "旧版本 ${env.OTHER_TARGET} 已删除" echo "旧版本 ${env.OTHER_TARGET} 已删除"
} }
} }
} }
} }
stage('清理') {
steps {
sh "${SSH_CMD} 'rm -f ${REMOTE_DIR}/${IMAGE_NAME}.tar'"
sh "rm -f ${IMAGE_NAME}.tar"
}
}
} }
post { post {
@@ -199,6 +194,7 @@ pipeline {
} }
failure { failure {
echo '❌ 部署失败,请检查日志' echo '❌ 部署失败,请检查日志'
sh "rm -f ${IMAGE_NAME}.tar || true"
} }
} }
} }
+4 -5
View File
@@ -5,9 +5,8 @@ services:
restart: unless-stopped restart: unless-stopped
ports: ports:
- "10502:80" - "10502:80"
depends_on: volumes:
- blue - ./nginx.conf:/etc/nginx/nginx.conf:ro
- green
healthcheck: healthcheck:
test: ["CMD", "wget", "--spider", "-q", "http://localhost/health"] test: ["CMD", "wget", "--spider", "-q", "http://localhost/health"]
interval: 30s interval: 30s
@@ -20,7 +19,7 @@ services:
cpus: '1' cpus: '1'
blue: blue:
build: . image: offerpie-ai:latest
container_name: offerpie-ai-blue container_name: offerpie-ai-blue
restart: unless-stopped restart: unless-stopped
expose: expose:
@@ -44,7 +43,7 @@ services:
cpus: '2' cpus: '2'
green: green:
build: . image: offerpie-ai:latest
container_name: offerpie-ai-green container_name: offerpie-ai-green
restart: unless-stopped restart: unless-stopped
expose: expose: