使用Helm部署ArgoCD的完整指南与实战-代码聚汇网

使用Helm部署ArgoCD的完整指南与实战

AngstEssenSeele·2026-08-27·阅读 27 GEO检测（免费）

HelmArgoCDKubernetes

|难度：普通|阅读约 22 分钟

1. 为什么选择Helm部署ArgoCD？

在云原生生态中，Helm和ArgoCD都是重量级选手。Helm作为Kubernetes的包管理工具，就像Linux系统中的apt或yum，能够将复杂的Kubernetes应用打包成可复用的Chart。而ArgoCD则是GitOps理念的标杆实现，它像一位尽职的仓库管理员，时刻对比集群实际状态与Git仓库中的声明式配置。

当这两个工具相遇时，Helm提供标准化的打包方案，ArgoCD提供持续同步能力。使用Helm部署ArgoCD的优势在于：

版本管理标准化：Helm Chart天然支持版本控制，升级回滚都有迹可循
参数配置集中化：通过values.yaml文件统一管理配置项，避免散落各处的配置碎片
依赖处理自动化：Chart可以声明依赖关系，自动解决ArgoCD所需的各种组件（如Redis）

重要提示：生产环境建议使用Helm 3.8+版本，其对OCI仓库的支持更完善，与ArgoCD的集成也更稳定。

需要模型API调用？免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。

2. 环境准备与工具链配置

2.1 Helm客户端安装验证

首先需要确保本地已安装helm客户端。以下是各平台的安装方式：

MacOS用户：

bash复制brew install helm

Linux用户：

bash复制curl https://raw.githubusercontent.com/helm/helm/main/scripts/get-helm-3 | bash

验证安装成功：

bash复制helm version --short
# 应输出类似：v3.12.0+g8f4cc6f

2.2 Kubernetes集群准备

ArgoCD需要运行在Kubernetes集群上。本地测试推荐以下方案：

Minikube（适合本地开发）：

bash复制minikube start --cpus=4 --memory=8192 --disk-size=20g
kubectl config use-context minikube

Kind（轻量级集群）：

bash复制kind create cluster --name argocd --image kindest/node:v1.26.0

检查集群状态：

bash复制kubectl cluster-info
kubectl get nodes

3. Helm部署ArgoCD全流程

3.1 添加ArgoCD Helm仓库

ArgoCD官方维护了Helm Chart仓库，首先需要添加：

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

验证仓库添加成功：

bash复制helm search repo argo/argo-cd
# 应看到类似输出：
# NAME          CHART VERSION APP VERSION DESCRIPTION
# argo/argo-cd  5.0.0         v2.6.0      A Helm chart for Argo CD

3.2 定制化values.yaml配置

创建自定义配置文件values-custom.yaml：

yaml复制# values-custom.yaml
server:
  service:
    type: NodePort  # 方便本地访问
  ingress:
    enabled: true
    hosts:
      - argocd.local
  config:
    repositories: |
      - url: https://github.com/your-git-repo
        type: git
        name: my-apps

redis:
  enabled: true  # ArgoCD依赖Redis做缓存

关键配置说明：

server.service.type：生产环境建议LoadBalancer，本地测试用NodePort
server.ingress：如需通过域名访问需要配置
config.repositories：预先配置常用Git仓库地址

3.3 执行Helm安装命令

使用Helm安装ArgoCD到argocd命名空间：

bash复制kubectl create namespace argocd
helm install argocd argo/argo-cd -n argocd -f values-custom.yaml

安装过程监控：

bash复制kubectl get pods -n argocd --watch
# 等待所有Pod状态变为Running

3.4 获取访问凭证

ArgoCD默认会生成admin用户和随机密码，获取方式：

bash复制kubectl -n argocd get secret argocd-initial-admin-secret -o jsonpath="{.data.password}" | base64 -d; echo

暴露服务到本地端口：

bash复制kubectl port-forward svc/argocd-server -n argocd 8080:443

现在可以通过 https://localhost:8080 访问ArgoCD Web UI，用户名admin，密码为刚才获取的随机密码。

4. 部署hot100应用实战

4.1 准备hot100应用配置

假设hot100是一个包含100个微服务的演示项目，我们为其创建Application配置：

yaml复制# hot100-application.yaml
apiVersion: argoproj.io/v1alpha1
kind: Application
metadata:
  name: hot100
  namespace: argocd
spec:
  project: default
  source:
    repoURL: https://github.com/hot100-demo/repo.git
    targetRevision: HEAD
    path: kustomize/overlays/prod
  destination:
    server: https://kubernetes.default.svc
    namespace: hot100
  syncPolicy:
    automated:
      prune: true
      selfHeal: true
    syncOptions:
      - CreateNamespace=true

关键参数解析：

syncPolicy.automated：开启自动同步和自动修复
syncOptions.CreateNamespace：自动创建目标命名空间
path：指向Kustomize的prod环境配置

4.2 提交应用到ArgoCD

通过kubectl提交Application配置：

bash复制kubectl apply -f hot100-application.yaml

或者通过ArgoCD CLI：

bash复制argocd app create hot100 \
  --repo https://github.com/hot100-demo/repo.git \
  --path kustomize/overlays/prod \
  --dest-server https://kubernetes.default.svc \
  --dest-namespace hot100 \
  --sync-policy automated \
  --auto-prune \
  --self-heal

4.3 监控部署状态

查看应用状态：

bash复制argocd app get hot100

典型输出示例：

code复制Name:               hot100
Project:            default
Server:             https://kubernetes.default.svc
Namespace:          hot100
URL:                https://localhost:8080/applications/hot100
Repo:               https://github.com/hot100-demo/repo.git
Target:             HEAD
Path:               kustomize/overlays/prod
SyncWindow:         Sync Allowed
Sync Policy:        Automated (Prune)
Sync Status:        Synced to HEAD (abc1234)
Health Status:      Healthy

5. 生产环境调优指南

5.1 高可用配置调整

生产环境需要修改values.yaml中的高可用配置：

yaml复制# values-prod.yaml
controller:
  replicas: 3
  resources:
    limits:
      cpu: 1
      memory: 1Gi

server:
  replicas: 2
  autoscaling:
    enabled: true
    minReplicas: 2
    maxReplicas: 5

redis-ha:
  enabled: true
  redis:
    resources:
      limits:
        cpu: 500m
        memory: 512Mi

5.2 安全加固措施

禁用匿名访问：

yaml复制server:
  config:
    anonymous.enabled: "false"

配置SSO集成（以GitHub为例）：

yaml复制server:
  config:
    dex.config: |
      connectors:
        - type: github
          id: github
          name: GitHub
          config:
            clientID: $GITHUB_CLIENT_ID
            clientSecret: $GITHUB_CLIENT_SECRET
            orgs:
              - name: your-org

网络策略限制：

yaml复制networkPolicy:
  enabled: true
  ingress:
    - from:
        - podSelector:
            matchLabels:
              app.kubernetes.io/name: argocd-server
      ports:
        - port: 8080
          protocol: TCP

5.3 性能优化技巧

调整Repo服务器参数：

yaml复制repoServer:
  resources:
    limits:
      cpu: 2
      memory: 2Gi
  extraArgs:
    - --git-timeout=180s
    - --git-attempts=3

配置缓存策略：

yaml复制configs:
  cm:
    resource.customizations: |
      caching.enabled: "true"
      caching.expiration: "24h"

大集群优化：

yaml复制controller:
  extraArgs:
    - --app-resync=180
    - --status-processors=20
    - --operation-processors=10

6. 常见问题排查手册

6.1 同步失败：证书验证问题

错误现象：

code复制rpc error: code = Unknown desc = `git fetch origin --tags --force` failed exit status 128: fatal: unable to access 'https://github.com/.../': SSL certificate problem: unable to get local issuer certificate

解决方案：

yaml复制repoServer:
  volumeMounts:
    - name: git-tls-certs
      mountPath: /etc/ssl/certs/ca-certificates.crt
      subPath: ca-certificates.crt
  volumes:
    - name: git-tls-certs
      configMap:
        name: custom-ca-cert

6.2 Pod卡在Pending状态

可能原因：

资源配额不足
节点选择器不匹配
PVC无法绑定

诊断步骤：

bash复制kubectl describe pod -n argocd <pod-name>
kubectl get events --sort-by=.metadata.creationTimestamp

6.3 配置漂移处理

当集群状态与Git声明不一致时：

手动触发同步：

bash复制argocd app sync hot100

查看差异：

bash复制argocd app diff hot100

强制覆盖（谨慎使用）：

bash复制argocd app sync hot100 --force

7. 进阶：ArgoCD自动化流水线

7.1 与CI工具集成

在GitHub Actions中添加ArgoCD同步步骤：

yaml复制# .github/workflows/deploy.yaml
jobs:
  deploy:
    steps:
      - name: Sync ArgoCD
        run: |
          argocd login $ARGOCD_SERVER --username $ARGOCD_USERNAME --password $ARGOCD_PASSWORD
          argocd app sync hot100
        env:
          ARGOCD_SERVER: argocd.example.com
          ARGOCD_USERNAME: ${{ secrets.ARGOCD_USERNAME }}
          ARGOCD_PASSWORD: ${{ secrets.ARGOCD_PASSWORD }}

7.2 自动生成Application

使用ApplicationSet实现动态应用创建：

yaml复制# applicationset.yaml
apiVersion: argoproj.io/v1alpha1
kind: ApplicationSet
metadata:
  name: hot100-services
spec:
  generators:
    - git:
        repoURL: https://github.com/hot100-demo/repo.git
        revision: HEAD
        directories:
          - path: "services/*"
  template:
    metadata:
      name: '{{path.basename}}'
    spec:
      project: default
      source:
        repoURL: https://github.com/hot100-demo/repo.git
        targetRevision: HEAD
        path: '{{path}}'
      destination:
        server: https://kubernetes.default.svc
        namespace: hot100
      syncPolicy:
        automated:
          prune: true
          selfHeal: true

7.3 监控与告警配置

集成Prometheus监控ArgoCD：

yaml复制server:
  metrics:
    enabled: true
    serviceMonitor:
      enabled: true
      additionalLabels:
        release: prometheus-operator

示例告警规则：

yaml复制groups:
- name: argocd-alerts
  rules:
  - alert: ArgoCDAppOutOfSync
    expr: argocd_app_info{sync_status="OutOfSync"} == 1
    for: 5m
    labels:
      severity: warning
    annotations:
      summary: "Application {{ $labels.name }} is out of sync"
      description: "The application {{ $labels.name }} has been out of sync for more than 5 minutes"