基于k8s的Jenkins CI/CD平台部署实践（三）：集成ArgoCD实现持续部署

文章目录

[基于k8s的Jenkins CI/CD平台部署实践（三）：集成ArgoCD实现持续部署](#基于k8s的Jenkins CI/CD平台部署实践（三）：集成ArgoCD实现持续部署)
一、Argocd简介
二、安装Helm
三、Helm安装ArgoCD实战
- [1. 添加ArgoCD官方仓库](#1. 添加ArgoCD官方仓库)
- [2. 创建argocd命名空间](#2. 创建argocd命名空间)
- [3. 安装ArgoCD](#3. 安装ArgoCD)
- [4. 安装ArgoCD-cli](#4. 安装ArgoCD-cli)
- [5. 验证ArgoCD-Pod状态](#5. 验证ArgoCD-Pod状态)
四、ArgoCD页面配置
- [1. 查看外部访问端口](#1. 查看外部访问端口)
- [2. 访问ui页面和配置](#2. 访问ui页面和配置)
- [3. 创建ArgoCD应用](#3. 创建ArgoCD应用)
五、Jenkins集成ArgoCD
- [1. 流水线设计](#1. 流水线设计)
总结

在前两篇文章中，我们已完成 Jenkins 在 Kubernetes 环境中的部署与流水线构建，实现了代码的持续集成与镜像构建。为了进一步提升部署自动化能力，本篇将引入 GitOps 工具 ArgoCD，并与 Jenkins 流水线集成，构建从代码提交到自动部署的完整 CI/CD 流程。通过 ArgoCD 实现基于 Git 仓库的声明式部署，我们不仅能够提升交付效率，还能确保环境一致性和部署可追溯性，为平台稳定性和可维护性提供有力支撑。

一、Argocd简介

ArgoCD 是一款基于 GitOps 模式的持续部署工具，专为 Kubernetes 场景设计。它通过监听 Git 仓库中的应用声明文件（如 Kubernetes YAML/Helm/Kustomize 等），实现集群中资源的自动同步与状态管理。与传统的手动或脚本式部署方式不同，ArgoCD 将"部署即代码"理念贯彻到底，使部署流程标准化、可追溯、易于回滚。其提供了丰富的 Web UI、命令行工具和 API 支持，方便开发团队对应用的部署状态进行可视化管理与操作。

📌 说明：本实践中 ArgoCD 是通过 Helm Chart 进行安装部署的。这种方式便于版本控制和集中化配置管理，更适合中大型团队的自动化部署场景。

二、安装Helm

bash 复制代码

curl https://raw.githubusercontent.com/helm/helm/master/scripts/get-helm-3 | bash
# 验证安装
helm version

三、Helm安装ArgoCD实战

1. 添加ArgoCD官方仓库

bash 复制代码

helm repo add argo https://argoproj.github.io/argo-helm
helm repo update

2. 创建argocd命名空间

bash 复制代码

kubectl create argocd

3. 安装ArgoCD

bash 复制代码

# 查看想要安装的版本
helm search repo argo/argo-cd --versions | head -n 20

# 下载并解压指定版本的 ArgoCD Helm Chart，便于查看或自定义配置后再安装
helm pull argo/argo-cd --version 7.8.24 --untar
vim argocd/values.yaml  #修改成你需要的配置

# 使用Helm 安装 ArgoCD
helm install argocd ./argo-cd -n argocd

4. 安装ArgoCD-cli

bash 复制代码

curl -sSL -o argocd-linux-amd64 https://github.com/argoproj/argo-cd/releases/latest/download/argocd-linux-amd64
mv argocd-linux-amd64 argocd
chmod 755 argocd
mv argocd /usr/bin/

5. 验证ArgoCD-Pod状态

bash 复制代码

kubectl get pod -n argocd

四、ArgoCD页面配置

1. 查看外部访问端口

bash 复制代码

kubectl get svc -n argocd

2. 访问ui页面和配置

复制代码

访问地址：http://ip:30080
初始账号：admin
初始密码：kubectl -n argocd get secret argocd-initial-admin-secret -o jsonpath="{.data.password}" | base64 -d

# 提供git仓库访问凭证，这里不配置的话后续配置ui页面会报错
argocd login ip:30080 \
  --username admin \
  --password aaa98224 \  #密码是因为我改成aaa98224
  --insecure
  
# 添加 Git 仓库认证信息到 Argo CD
argocd repo add http://192.168.100.100/yw/hwj.git \  #gitlab仓库地址
  --username root \
  --password 'gitlab.hwj'  #gitlab仓库密码

3. 创建ArgoCD应用

前置条件：Gitlab仓库创建K8s资源文件目录和放入资源文件

创建ArgoCD应用

配置好了以后如下图所示，点击同步

同步成功，Pod自动部署完成

五、Jenkins集成ArgoCD

1. 流水线设计

复制代码

pipeline {
    agent any
    environment {
        git_address = "http://192.168.100.100/yw/hwj.git"    // gitlab仓库地址
        git_auth = "jenkins-to-gitlab"     // Jenkins中配置的GitLab凭据ID
        docker_build_host = "192.168.100.30"    // 构建镜像主机
        branch_name = "master"
        // BUILD_NUMBER 是 Jenkins 的内置环境变量，代表当前构建的编号（递增）
        // 例如第一次构建为 1，第二次为 2，用于版本号控制
    }
    stages {
        stage('清空工作目录') {
            steps {
                echo '清理工作目录...'
                deleteDir()
            }
        }

        stage('拉取代码') {
            steps {
                checkout([$class: 'GitSCM',
                    branches: [[name: "*/${branch_name}"]],
                    doGenerateSubmoduleConfigurations: false,
                    extensions: [],
                    submoduleCfg: [],
                    userRemoteConfigs: [[credentialsId: "${git_auth}", url: "${git_address}"]]
                ])
            }
        }
        stage('代码打包') {
            steps {
                sh "mvn -U clean package -Dmaven.test.skip=true"
            }
        }

        stage('传输 Jar 包到 Docker 主机') {
            steps {
                sh """
                    scp -rp hwj-main/target/hwj-main.jar root@${docker_build_host}:/root/docker-build/hwj/
                """
            }
        }
        stage('Docker 主机构建镜像') {
            steps {
                sh """
                    ssh root@${docker_build_host} '
                        cd /root/docker-build/hwj &&
                        docker build -t harbor.local/k8s/hwj:v1.0.${BUILD_NUMBER} . &&
                        docker push harbor.local/k8s/hwj:v1.0.${BUILD_NUMBER}
                    '
                """
            }
        }
		stage('更新 YAML 并提交 Git') {
			steps {
				script {
					def newTag = "v1.0.${BUILD_NUMBER}"
					def yamlPath = "k8s/hwj/hwj-deploy.yaml"    // gitlab仓库中存放K8s资源文件的目录
					def imageLine = "image: harbor.local/k8s/hwj:${newTag}"

					// 修改 YAML 镜像地址
					sh "sed -i 's|image: harbor.local/k8s/hwj:.*|${imageLine}|' ${yamlPath}"

                    // 使用凭据进行 Git 提交和推送
                    withCredentials([usernamePassword(credentialsId: "${git_auth}", usernameVariable: 'GIT_USER', passwordVariable: 'GIT_PASS')]) {
                        sh """
                            git config user.name 'hwj'
                            git config user.email '[email protected]'
                            git remote set-url origin http://$GIT_USER:[email protected]/yw/hwj.git
                            git add ${yamlPath}
                            git commit -m '更新镜像版本为 ${newTag}' || echo "No changes to commit"
                            git push origin HEAD:${branch_name}
                        """
					}
				}
			}
		}
    }
}

再次同步 ArgoCD，这里也可以配置自动同步，每次 Jenkins 推送 YAML 改动后即可自动完成部署

总结

本篇文章基于前两篇 Jenkins CI/CD 系列的内容，进一步集成了 ArgoCD 实现自动部署能力：

✅ 使用 Helm 安装 ArgoCD，便于版本管理和企业级配置维护

✅ 配置 ArgoCD 与 Git 仓库同步，构建 GitOps 部署模型

✅ 利用 Jenkins 流水线自动更新部署清单，实现构建即部署