3. 安装与部署：Helm Chart 安装 Argo CD、命名空间规划、高可用部署模式选择

在生产环境中部署 Argo CD 时，安装方式、命名空间隔离策略以及高可用模式的选择直接决定了平台的稳定性与运维成本。本章将围绕 Helm Chart 安装、多环境命名空间规划以及高可用架构选型三个核心维度展开，提供可直接落地的部署方案。

3.1 使用 Helm Chart 安装 Argo CD

Argo CD 官方维护的 Helm Chart 是生产部署的首选方式。它提供了丰富的参数化配置能力，支持自定义镜像仓库、Ingress 控制器、TLS 证书以及高可用开关。

3.1.1 添加 Helm 仓库与版本选择

# 添加 Argo CD 官方 Helm 仓库
helm repo add argo https://argoproj.github.io/argo-helm
helm repo update

# 查询可用版本（建议选择最新的稳定版）
helm search repo argo/argo-cd --versions --devel | head -10

3.1.2 基础安装命令

# 创建命名空间
kubectl create namespace argocd

# 使用 Helm 安装（单副本模式，适用于测试环境）
helm install argocd argo/argo-cd \
  --namespace argocd \
  --set server.service.type=LoadBalancer \
  --set configs.params."server\.insecure"=true

3.1.3 关键 values 参数速查表

3.2 命名空间规划策略

合理的命名空间规划能够实现租户隔离、资源配额管理以及运维权限的精细化控制。推荐采用“双层命名空间”模型：系统命名空间 与 业务命名空间。

3.2.1 推荐命名空间布局

3.2.2 命名空间隔离最佳实践

• 禁止在 argocd 命名空间内部署业务应用，避免组件间资源争抢。
• 使用 NetworkPolicy 限制 argocd 命名空间只允许 Ingress 控制器和集群内部 API Server 访问。
• 为每个业务命名空间创建独立的 ResourceQuota 和 LimitRange，防止单个团队耗尽集群资源。
• 通过 Argo CD 的 Project 资源绑定目标命名空间，实现 GitOps 粒度的权限控制。

3.3 高可用部署模式选择

Argo CD 的高可用部署并非简单的“多副本 + 负载均衡”，需要根据集群规模、故障域以及运维能力选择不同的模式。以下对比三种主流模式。

3.3.1 高可用模式对比

3.3.2 高可用部署参数示例（多副本 + 内置 Redis Sentinel）

# ha-values.yaml
server:
  replicas: 3
  autoscaling:
    enabled: false  # 生产建议固定副本，避免 HPA 抖动

repoServer:
  replicas: 3

applicationSet:
  replicas: 2

redis:
  enabled: true
  architecture: replication  # 主从模式
  master:
    persistence:
      enabled: true
      size: 10Gi
  replica:
    replicaCount: 2
    persistence:
      enabled: true
      size: 10Gi
  sentinel:
    enabled: true
    replicas: 3

configs:
  params:
    server.insecure: false  # 生产必须启用 TLS

3.3.3 高可用架构示意图

3.4 部署验证与健康检查

安装完成后，执行以下命令验证组件状态：

# 检查所有 Pod 是否 Running
kubectl get pods -n argocd

# 查看 Service 端点
kubectl get svc -n argocd

# 获取初始管理员密码
kubectl -n argocd get secret argocd-initial-admin-secret \
  -o jsonpath="{.data.password}" | base64 -d

# 端口转发访问 UI（本地调试）
kubectl port-forward svc/argocd-server -n argocd 8080:443

3.5 生产部署决策树

根据集群规模与可靠性要求，参考以下决策路径选择部署模式：

3.6 常见部署问题与排查