Jenkinsfile 15 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400
  1. pipeline {
  2. agent any
  3. parameters {
  4. choice(name: 'env', choices: ['dev', 'test', 'prod'], description: '部署环境')
  5. string(name: 'NAMESPACE', defaultValue: 'portal-frontend', description: 'K8s 命名空间')
  6. string(name: 'DOMAIN', defaultValue: '', description: 'Ingress 域名(留空则不创建 Ingress)')
  7. string(name: 'TLS_SECRET', defaultValue: 'portal-tls', description: 'TLS Secret 名称(仅在 DOMAIN 非空时使用)')
  8. booleanParam(name: 'FORCE_UPDATE_CONFIG', defaultValue: false, description: '强制更新配置(包括 Deployment 和 Ingress)')
  9. }
  10. environment {
  11. PROJECT_NAME = 'portal-frontend'
  12. BUILD_DIR = 'dist'
  13. NODE_ENV = 'production'
  14. HARBOR_HOST = '8.130.28.21:81'
  15. KUBECONFIG_PATH = '/root/.kube/config'
  16. HARBOR_USER = 'admin'
  17. HARBOR_PASS = 'Hfln@1024'
  18. HARBOR_RETENTION_ID = '1'
  19. }
  20. stages {
  21. stage('🧬 初始化环境') {
  22. steps {
  23. script {
  24. env.HARBOR_PROJECT = params.env
  25. env.IMAGE_TAG = "${HARBOR_HOST}/${env.HARBOR_PROJECT}/${PROJECT_NAME}:${BUILD_NUMBER}"
  26. echo ">>> 环境:${params.env}, Harbor项目:${env.HARBOR_PROJECT}, K8s命名空间:${params.NAMESPACE}"
  27. if (params.DOMAIN?.trim()) {
  28. echo ">>> 域名:${params.DOMAIN}, TLS Secret:${params.TLS_SECRET}"
  29. echo ">>> 将使用 LoadBalancer 类型访问"
  30. } else {
  31. echo ">>> 未配置域名,将使用 NodePort 类型访问"
  32. }
  33. echo ">>> 强制更新配置:${params.FORCE_UPDATE_CONFIG}"
  34. }
  35. }
  36. }
  37. stage('📥 拉取代码') {
  38. steps {
  39. checkout scm
  40. echo "✅ 代码拉取成功"
  41. }
  42. }
  43. stage('🔐 配置 Ingress 控制器') {
  44. when {
  45. expression { params.DOMAIN?.trim() }
  46. }
  47. steps {
  48. script {
  49. sh """
  50. export KUBECONFIG=${KUBECONFIG_PATH}
  51. echo ">>> 配置 Ingress 控制器为 LoadBalancer 类型..."
  52. # 检查 Ingress 控制器 Service 类型
  53. INGRESS_SERVICE_TYPE=\$(kubectl get svc ingress-nginx-controller -n ingress-nginx -o jsonpath='{.spec.type}')
  54. echo ">>> 当前 Ingress 控制器类型: \${INGRESS_SERVICE_TYPE}"
  55. if [ "\${INGRESS_SERVICE_TYPE}" != "LoadBalancer" ]; then
  56. echo ">>> 修改 Ingress 控制器为 LoadBalancer 类型..."
  57. kubectl patch svc ingress-nginx-controller -n ingress-nginx -p '{"spec":{"type":"LoadBalancer"}}'
  58. echo ">>> 等待 LoadBalancer 分配外部 IP..."
  59. kubectl wait --for=condition=Available --timeout=300s svc/ingress-nginx-controller -n ingress-nginx
  60. # 获取外部 IP
  61. EXTERNAL_IP=\$(kubectl get svc ingress-nginx-controller -n ingress-nginx -o jsonpath='{.status.loadBalancer.ingress[0].ip}')
  62. if [ -n "\${EXTERNAL_IP}" ]; then
  63. echo "✅ Ingress 控制器获得外部 IP: \${EXTERNAL_IP}"
  64. echo ">>> 请将域名 ${params.DOMAIN} 解析到: \${EXTERNAL_IP}"
  65. else
  66. echo "⚠️ LoadBalancer 尚未分配外部 IP,请稍后检查"
  67. fi
  68. else
  69. echo "✅ Ingress 控制器已经是 LoadBalancer 类型"
  70. EXTERNAL_IP=\$(kubectl get svc ingress-nginx-controller -n ingress-nginx -o jsonpath='{.status.loadBalancer.ingress[0].ip}')
  71. if [ -n "\${EXTERNAL_IP}" ]; then
  72. echo ">>> 当前外部 IP: \${EXTERNAL_IP}"
  73. fi
  74. fi
  75. """
  76. }
  77. }
  78. }
  79. stage('�� 验证 TLS Secret') {
  80. when {
  81. expression { params.DOMAIN?.trim() }
  82. }
  83. steps {
  84. script {
  85. sh """
  86. export KUBECONFIG=${KUBECONFIG_PATH}
  87. # 验证 TLS Secret 是否存在
  88. if ! kubectl get secret ${params.TLS_SECRET} -n ${params.NAMESPACE} >/dev/null 2>&1; then
  89. echo "❌ TLS Secret '${params.TLS_SECRET}' 在命名空间 '${params.NAMESPACE}' 中不存在!"
  90. echo "请先创建 TLS Secret:"
  91. echo "kubectl create secret tls ${params.TLS_SECRET} --cert=fullchain.pem --key=privkey.pem -n ${params.NAMESPACE}"
  92. exit 1
  93. fi
  94. echo "✅ TLS Secret '${params.TLS_SECRET}' 验证成功"
  95. """
  96. }
  97. }
  98. }
  99. stage('🔧 构建 Docker 镜像') {
  100. steps {
  101. script {
  102. sh """
  103. docker login -u ${HARBOR_USER} -p ${HARBOR_PASS} ${HARBOR_HOST}
  104. docker build --build-arg ENV=${params.env} -t ${IMAGE_TAG} .
  105. """
  106. echo "✅ 镜像构建成功:${IMAGE_TAG}"
  107. }
  108. }
  109. }
  110. stage('🚀 推送镜像到 Harbor') {
  111. steps {
  112. script {
  113. sh """
  114. docker push ${IMAGE_TAG}
  115. docker rmi ${IMAGE_TAG}
  116. """
  117. echo "✅ 镜像推送并本地清理完成"
  118. }
  119. }
  120. }
  121. stage(' Kubernetes 部署') {
  122. steps {
  123. script {
  124. def domain = params.DOMAIN?.trim()
  125. sh """
  126. export KUBECONFIG=${KUBECONFIG_PATH}
  127. # 确保命名空间存在
  128. kubectl get ns ${params.NAMESPACE} >/dev/null 2>&1 || kubectl create ns ${params.NAMESPACE}
  129. # 如果强制更新配置或 Deployment 不存在,则重新创建
  130. if [ "${params.FORCE_UPDATE_CONFIG}" = "true" ] || ! kubectl get deployment ${PROJECT_NAME} -n ${params.NAMESPACE} >/dev/null 2>&1; then
  131. if [ "${params.FORCE_UPDATE_CONFIG}" = "true" ]; then
  132. echo ">>> 强制更新配置,删除现有资源..."
  133. kubectl delete deployment ${PROJECT_NAME} -n ${params.NAMESPACE} --ignore-not-found=true
  134. kubectl delete svc ${PROJECT_NAME} -n ${params.NAMESPACE} --ignore-not-found=true
  135. kubectl delete svc ${PROJECT_NAME}-nodeport -n ${params.NAMESPACE} --ignore-not-found=true
  136. kubectl delete ingress ${PROJECT_NAME}-ingress -n ${params.NAMESPACE} --ignore-not-found=true
  137. fi
  138. echo ">>> 创建 Deployment..."
  139. kubectl apply -n ${params.NAMESPACE} -f - <<EOF
  140. apiVersion: apps/v1
  141. kind: Deployment
  142. metadata:
  143. name: ${PROJECT_NAME}
  144. spec:
  145. replicas: 2
  146. selector:
  147. matchLabels:
  148. app: ${PROJECT_NAME}
  149. template:
  150. metadata:
  151. labels:
  152. app: ${PROJECT_NAME}
  153. spec:
  154. containers:
  155. - name: ${PROJECT_NAME}
  156. image: ${IMAGE_TAG}
  157. ports:
  158. - containerPort: 80
  159. resources:
  160. requests:
  161. memory: "128Mi"
  162. cpu: "100m"
  163. limits:
  164. memory: "256Mi"
  165. cpu: "200m"
  166. livenessProbe:
  167. httpGet:
  168. path: /
  169. port: 80
  170. initialDelaySeconds: 30
  171. periodSeconds: 10
  172. readinessProbe:
  173. httpGet:
  174. path: /
  175. port: 80
  176. initialDelaySeconds: 5
  177. periodSeconds: 5
  178. EOF
  179. # 根据是否配置域名创建不同的 Service
  180. if [ -n "${domain}" ]; then
  181. echo ">>> 创建 ClusterIP Service(用于 Ingress)..."
  182. kubectl apply -n ${params.NAMESPACE} -f - <<EOF
  183. apiVersion: v1
  184. kind: Service
  185. metadata:
  186. name: ${PROJECT_NAME}
  187. spec:
  188. type: ClusterIP
  189. selector:
  190. app: ${PROJECT_NAME}
  191. ports:
  192. - port: 80
  193. targetPort: 80
  194. protocol: TCP
  195. EOF
  196. else
  197. echo ">>> 创建 NodePort Service(用于直接访问)..."
  198. kubectl apply -n ${params.NAMESPACE} -f - <<EOF
  199. apiVersion: v1
  200. kind: Service
  201. metadata:
  202. name: ${PROJECT_NAME}-nodeport
  203. spec:
  204. type: NodePort
  205. selector:
  206. app: ${PROJECT_NAME}
  207. ports:
  208. - port: 80
  209. targetPort: 80
  210. nodePort: 30085
  211. protocol: TCP
  212. EOF
  213. fi
  214. # 创建 Ingress(如果提供了域名)
  215. if [ -n "${domain}" ]; then
  216. echo ">>> 创建 Ingress..."
  217. kubectl apply -n ${params.NAMESPACE} -f - <<EOF
  218. apiVersion: networking.k8s.io/v1
  219. kind: Ingress
  220. metadata:
  221. name: ${PROJECT_NAME}-ingress
  222. annotations:
  223. kubernetes.io/ingress.class: nginx
  224. nginx.ingress.kubernetes.io/ssl-redirect: "true"
  225. nginx.ingress.kubernetes.io/force-ssl-redirect: "true"
  226. nginx.ingress.kubernetes.io/backend-protocol: "HTTP"
  227. nginx.ingress.kubernetes.io/ssl-passthrough: "false"
  228. nginx.ingress.kubernetes.io/proxy-body-size: "8m"
  229. nginx.ingress.kubernetes.io/rewrite-target: /
  230. nginx.ingress.kubernetes.io/ssl-ciphers: "ECDHE-RSA-AES128-GCM-SHA256:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-RSA-AES128-SHA256:ECDHE-RSA-AES256-SHA384"
  231. nginx.ingress.kubernetes.io/ssl-protocols: "TLSv1.2 TLSv1.3"
  232. spec:
  233. tls:
  234. - hosts:
  235. - ${domain}
  236. secretName: ${params.TLS_SECRET}
  237. rules:
  238. - host: ${domain}
  239. http:
  240. paths:
  241. - path: /
  242. pathType: Prefix
  243. backend:
  244. service:
  245. name: ${PROJECT_NAME}
  246. port:
  247. number: 80
  248. EOF
  249. fi
  250. else
  251. # 只更新镜像
  252. echo ">>> Deployment 已存在,仅更新镜像..."
  253. kubectl set image deployment/${PROJECT_NAME} ${PROJECT_NAME}=${IMAGE_TAG} -n ${params.NAMESPACE}
  254. echo "✅ 镜像更新完成,Kubernetes 将自动处理滚动更新"
  255. fi
  256. # 等待 Deployment 就绪
  257. # echo ">>> 等待 Deployment 就绪..."
  258. # kubectl wait --for=condition=available --timeout=300s deployment/${PROJECT_NAME} -n ${params.NAMESPACE}
  259. # 显示部署状态
  260. echo ">>> 部署状态:"
  261. kubectl get all -n ${params.NAMESPACE}
  262. kubectl get ingress -n ${params.NAMESPACE} || echo ">>> 未配置 Ingress"
  263. # 根据配置显示访问信息
  264. if [ -n "${domain}" ]; then
  265. echo "✅ 应用部署完成!"
  266. echo "🌐 访问地址:https://${domain}"
  267. echo " 注意:请确保域名 ${domain} 已正确解析到 Ingress 控制器的外部 IP"
  268. else
  269. echo "✅ 应用部署完成!"
  270. echo "🌐 访问地址:"
  271. echo " HTTP: http://47.121.135.46:30085"
  272. echo " HTTPS: https://47.121.135.46:30085"
  273. echo " 注意:使用 NodePort 方式访问,端口为 30085"
  274. fi
  275. """
  276. }
  277. }
  278. }
  279. stage('🔍 部署验证') {
  280. steps {
  281. script {
  282. def domain = params.DOMAIN?.trim()
  283. sh """
  284. export KUBECONFIG=${KUBECONFIG_PATH}
  285. echo ">>> 验证部署状态..."
  286. # 检查 Pod 状态
  287. kubectl get pods -n ${params.NAMESPACE} -l app=${PROJECT_NAME}
  288. # 检查 Service 状态
  289. if [ -n "${domain}" ]; then
  290. kubectl get svc -n ${params.NAMESPACE} ${PROJECT_NAME}
  291. kubectl get ingress -n ${params.NAMESPACE} ${PROJECT_NAME}-ingress
  292. kubectl get secret -n ${params.NAMESPACE} ${params.TLS_SECRET}
  293. else
  294. kubectl get svc -n ${params.NAMESPACE} ${PROJECT_NAME}-nodeport
  295. fi
  296. # 检查 Ingress 控制器状态(如果配置了域名)
  297. if [ -n "${domain}" ]; then
  298. echo ">>> Ingress 控制器状态:"
  299. kubectl get svc ingress-nginx-controller -n ingress-nginx
  300. fi
  301. echo "✅ 部署验证完成"
  302. """
  303. }
  304. }
  305. }
  306. stage('🧹 清理本地旧镜像(保留最新3个)') {
  307. steps {
  308. script {
  309. def baseImage = "${HARBOR_HOST}/${env.HARBOR_PROJECT}/${PROJECT_NAME}"
  310. sh """
  311. docker images ${baseImage} --format "{{.Repository}}:{{.Tag}}" \\
  312. | grep -v latest \\
  313. | sort -r -t ':' -k2 \\
  314. | tail -n +4 \\
  315. | xargs -r docker rmi || true
  316. """
  317. echo "✅ 本地旧镜像清理完成"
  318. }
  319. }
  320. }
  321. stage(' 清理悬空镜像 <none>') {
  322. steps {
  323. script {
  324. sh """
  325. docker images -f "dangling=true" -q | xargs -r docker rmi || true
  326. """
  327. echo "✅ 悬空镜像(<none>)清理完成"
  328. }
  329. }
  330. }
  331. stage(' 触发 Harbor 镜像保留策略') {
  332. steps {
  333. script {
  334. sh """
  335. curl -u ${HARBOR_USER}:${HARBOR_PASS} -X POST \\
  336. "http://${HARBOR_HOST}/api/v2.0/retentions/${HARBOR_RETENTION_ID}/executions"
  337. """
  338. echo "✅ Harbor 镜像保留策略已触发"
  339. }
  340. }
  341. }
  342. }
  343. post {
  344. success {
  345. echo "✅ 构建 & 部署成功!"
  346. script {
  347. if (params.DOMAIN?.trim()) {
  348. echo "🌐 应用可通过 https://${params.DOMAIN} 访问"
  349. echo " 请确保域名已解析到 Ingress 控制器的外部 IP"
  350. } else {
  351. echo "🌐 应用可通过以下地址访问:"
  352. echo " HTTP: http://47.121.135.46:30085"
  353. echo " HTTPS: https://47.121.135.46:30085"
  354. }
  355. }
  356. }
  357. failure {
  358. echo "❌ 构建或部署失败,请检查日志"
  359. }
  360. always {
  361. cleanWs()
  362. }
  363. }
  364. }