3. Argo CD 安装与配置：Helm安装、CLI配置、Ingress配置、高可用部署模式

本章聚焦于生产级 Argo CD 的部署实践。我们将采用 Helm Chart 作为安装载体，依次完成核心组件部署、CLI 工具链配置、Ingress 网关暴露以及高可用模式切换。每一步都附带资源配额校准要点，为后续章节的瓶颈诊断奠定基础。

3.1 环境准备与 Helm 仓库配置

在安装前，请确保目标 Kubernetes 集群满足以下最低要求：

执行以下命令添加官方 Helm 仓库并更新索引：

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

3.2 Helm 安装 Argo CD（基础模式）

使用 Helm 安装时，推荐将自定义 values 保存为独立文件 argo-cd-values.yaml，便于版本管理和审计。以下是一个面向生产的最小化配置：

# argo-cd-values.yaml
global:
  image:
    tag: "v2.10.3"

controller:
  replicas: 2
  resources:
    requests:
      cpu: "500m"
      memory: "512Mi"
    limits:
      cpu: "1"
      memory: "1Gi"

server:
  replicas: 2
  resources:
    requests:
      cpu: "250m"
      memory: "256Mi"
    limits:
      cpu: "500m"
      memory: "512Mi"

repoServer:
  replicas: 2
  resources:
    requests:
      cpu: "250m"
      memory: "256Mi"
    limits:
      cpu: "500m"
      memory: "512Mi"

redis:
  enabled: true
  resources:
    requests:
      cpu: "100m"
      memory: "128Mi"
    limits:
      cpu: "200m"
      memory: "256Mi"

执行安装命令：

helm install argocd argo/argo-cd \
  --namespace argocd \
  --create-namespace \
  -f argo-cd-values.yaml

3.3 CLI 配置与初始密码获取

安装完成后，需要配置 argocd CLI 并与 API Server 建立信任关系。分三步完成：

1. 下载 CLI 二进制：从 GitHub Releases 下载对应平台版本，并放入 /usr/local/bin。
2. 获取初始密码：

kubectl get secret argocd-initial-admin-secret \
  -n argocd \
  -o jsonpath="{.data.password}" | base64 -d

3. 登录并修改密码：

argocd login <ARGOCD_SERVER>:443 --grpc-web
argocd account update-password

3.4 Ingress 配置：暴露 Argo CD Web UI 与 API

Argo CD 同时提供 Web UI（HTTP/HTTPS）和 gRPC API 端点。Ingress 配置需要同时支持两种协议。以下是一个基于 nginx-ingress 的完整示例：

# argocd-ingress.yaml
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: argocd-server-ingress
  namespace: argocd
  annotations:
    nginx.ingress.kubernetes.io/backend-protocol: "HTTPS"
    nginx.ingress.kubernetes.io/ssl-passthrough: "true"
    nginx.ingress.kubernetes.io/ssl-redirect: "true"
spec:
  ingressClassName: nginx
  tls:
  - hosts:
    - argocd.example.com
    secretName: argocd-tls
  rules:
  - host: argocd.example.com
    http:
      paths:
      - path: /
        pathType: Prefix
        backend:
          service:
            name: argocd-server
            port:
              number: 443

应用配置后，通过 https://argocd.example.com 即可访问 Web UI。CLI 登录时使用同一域名：

argocd login argocd.example.com:443 --grpc-web

3.5 高可用部署模式

生产环境必须启用高可用模式。Argo CD 官方 Helm Chart 提供了 ha 子 chart，通过以下 values 启用：

# argo-cd-ha-values.yaml
# 继承基础 values，额外启用 HA 组件
redis:
  enabled: false   # 禁用单机 Redis

ha:
  enabled: true
  redis:
    enabled: true
    replicas: 3
    resources:
      requests:
        cpu: "200m"
        memory: "256Mi"
      limits:
        cpu: "500m"
        memory: "512Mi"

controller:
  replicas: 3
  # 启用 leader election
  metrics:
    enabled: true

server:
  replicas: 3
  # 启用会话亲和性
  service:
    sessionAffinity: ClientIP

repoServer:
  replicas: 3
  # 启用自动扩缩
  autoscaling:
    enabled: true
    minReplicas: 3
    maxReplicas: 10
    targetCPUUtilizationPercentage: 70

HA 模式的核心架构变化如下图所示：

3.6 安装后验证清单

完成部署后，执行以下命令验证所有组件健康状态：

# 检查所有 Pod 状态
kubectl get pods -n argocd

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

# 检查 Ingress 是否正确路由
curl -k -I https://argocd.example.com

# 验证 CLI 连接
argocd version --grpc-web

# 检查 Redis Sentinel 集群状态
kubectl exec -n argocd -it statefulset/argocd-redis-ha-server-0 -- redis-cli -p 26379 SENTINEL MASTERS

至此，Argo CD 已完成生产级安装与配置。下一阶段将进入 GitOps 工作流设计，届时会基于本章部署的集群进行 Application 定义与同步策略配置。