pipeline { agent any parameters { choice(name: 'env', choices: ['dev', 'test', 'prod'], description: '部署环境') string(name: 'NAMESPACE', defaultValue: 'portal-frontend', description: 'K8s 命名空间') string(name: 'DOMAIN', defaultValue: 'radar-power.asia', description: 'Ingress 域名(留空则不创建 Ingress)') string(name: 'TLS_SECRET', defaultValue: 'portal-tls', description: 'TLS Secret 名称(仅在 DOMAIN 非空时使用)') booleanParam(name: 'FORCE_UPDATE_CONFIG', defaultValue: false, description: '强制更新配置(包括 Deployment 和 Ingress)') } environment { PROJECT_NAME = 'portal-frontend' BUILD_DIR = 'dist' NODE_ENV = 'production' HARBOR_HOST = '8.130.28.21:81' KUBECONFIG_PATH = '/root/.kube/config' HARBOR_USER = 'admin' HARBOR_PASS = 'Hfln@1024' HARBOR_RETENTION_ID = '1' } stages { stage('🧬 初始化环境') { steps { script { env.HARBOR_PROJECT = params.env env.IMAGE_TAG = "${HARBOR_HOST}/${env.HARBOR_PROJECT}/${PROJECT_NAME}:${BUILD_NUMBER}" echo ">>> 环境:${params.env}, Harbor项目:${env.HARBOR_PROJECT}, K8s命名空间:${params.NAMESPACE}" if (params.DOMAIN?.trim()) { echo ">>> 域名:${params.DOMAIN}, TLS Secret:${params.TLS_SECRET}" } echo ">>> 强制更新配置:${params.FORCE_UPDATE_CONFIG}" } } } stage('📥 拉取代码') { steps { checkout scm echo "✅ 代码拉取成功" } } stage('�� 验证 TLS Secret') { when { expression { params.DOMAIN?.trim() } } steps { script { sh """ export KUBECONFIG=${KUBECONFIG_PATH} # 验证 TLS Secret 是否存在 if ! kubectl get secret ${params.TLS_SECRET} -n ${params.NAMESPACE} >/dev/null 2>&1; then echo "❌ TLS Secret '${params.TLS_SECRET}' 在命名空间 '${params.NAMESPACE}' 中不存在!" echo "请先创建 TLS Secret:" echo "kubectl create secret tls ${params.TLS_SECRET} --cert=fullchain.pem --key=privkey.pem -n ${params.NAMESPACE}" exit 1 fi echo "✅ TLS Secret '${params.TLS_SECRET}' 验证成功" """ } } } stage('🔧 构建 Docker 镜像') { steps { script { sh """ docker login -u ${HARBOR_USER} -p ${HARBOR_PASS} ${HARBOR_HOST} docker build --build-arg ENV=${params.env} -t ${IMAGE_TAG} . """ echo "✅ 镜像构建成功:${IMAGE_TAG}" } } } stage('🚀 推送镜像到 Harbor') { steps { script { sh """ docker push ${IMAGE_TAG} docker rmi ${IMAGE_TAG} """ echo "✅ 镜像推送并本地清理完成" } } } stage(' Kubernetes 部署') { steps { script { def domain = params.DOMAIN?.trim() sh """ export KUBECONFIG=${KUBECONFIG_PATH} # 确保命名空间存在 kubectl get ns ${params.NAMESPACE} >/dev/null 2>&1 || kubectl create ns ${params.NAMESPACE} # 如果强制更新配置或 Deployment 不存在,则重新创建 if [ "${params.FORCE_UPDATE_CONFIG}" = "true" ] || ! kubectl get deployment ${PROJECT_NAME} -n ${params.NAMESPACE} >/dev/null 2>&1; then if [ "${params.FORCE_UPDATE_CONFIG}" = "true" ]; then echo ">>> 强制更新配置,删除现有资源..." kubectl delete deployment ${PROJECT_NAME} -n ${params.NAMESPACE} --ignore-not-found=true kubectl delete svc ${PROJECT_NAME} -n ${params.NAMESPACE} --ignore-not-found=true kubectl delete ingress ${PROJECT_NAME}-ingress -n ${params.NAMESPACE} --ignore-not-found=true fi echo ">>> 创建 Deployment 和 Service..." kubectl apply -n ${params.NAMESPACE} -f - <>> 创建 Ingress..." kubectl apply -n ${params.NAMESPACE} -f - <>> Deployment 已存在,仅更新镜像..." kubectl set image deployment/${PROJECT_NAME} ${PROJECT_NAME}=${IMAGE_TAG} -n ${params.NAMESPACE} echo "✅ 镜像更新完成,Kubernetes 将自动处理滚动更新" fi # 等待 Deployment 就绪 echo ">>> 等待 Deployment 就绪..." kubectl wait --for=condition=available --timeout=300s deployment/${PROJECT_NAME} -n ${params.NAMESPACE} # 显示部署状态 echo ">>> 部署状态:" kubectl get all -n ${params.NAMESPACE} kubectl get ingress -n ${params.NAMESPACE} || echo ">>> 未配置 Ingress" # 如果配置了域名,显示访问信息 if [ -n "${domain}" ]; then echo "✅ 应用部署完成!" echo "🌐 访问地址:https://${domain}" echo "�� 注意:确保域名 ${domain} 已正确解析到集群公网IP" else echo "✅ 应用部署完成!" echo "📝 注意:未配置域名,请手动配置 Ingress 或使用 NodePort 访问" fi """ } } } stage('🔍 部署验证') { when { expression { params.DOMAIN?.trim() } } steps { script { def domain = params.DOMAIN?.trim() sh """ export KUBECONFIG=${KUBECONFIG_PATH} echo ">>> 验证部署状态..." # 检查 Pod 状态 kubectl get pods -n ${params.NAMESPACE} -l app=${PROJECT_NAME} # 检查 Service 状态 kubectl get svc -n ${params.NAMESPACE} ${PROJECT_NAME} # 检查 Ingress 状态 kubectl get ingress -n ${params.NAMESPACE} ${PROJECT_NAME}-ingress # 检查 TLS Secret kubectl get secret -n ${params.NAMESPACE} ${params.TLS_SECRET} echo "✅ 部署验证完成" """ } } } stage('🧹 清理本地旧镜像(保留最新3个)') { steps { script { def baseImage = "${HARBOR_HOST}/${env.HARBOR_PROJECT}/${PROJECT_NAME}" sh """ docker images ${baseImage} --format "{{.Repository}}:{{.Tag}}" \\ | grep -v latest \\ | sort -r -t ':' -k2 \\ | tail -n +4 \\ | xargs -r docker rmi || true """ echo "✅ 本地旧镜像清理完成" } } } stage(' 清理悬空镜像 ') { steps { script { sh """ docker images -f "dangling=true" -q | xargs -r docker rmi || true """ echo "✅ 悬空镜像()清理完成" } } } stage(' 触发 Harbor 镜像保留策略') { steps { script { sh """ curl -u ${HARBOR_USER}:${HARBOR_PASS} -X POST \\ "http://${HARBOR_HOST}/api/v2.0/retentions/${HARBOR_RETENTION_ID}/executions" """ echo "✅ Harbor 镜像保留策略已触发" } } } } post { success { echo "✅ 构建 & 部署成功!" script { if (params.DOMAIN?.trim()) { echo "🌐 应用可通过 https://${params.DOMAIN} 访问" } } } failure { echo "❌ 构建或部署失败,请检查日志" } always { cleanWs() } } }