Jenkinsfile 15 KB

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