3. Argo CD 安装与配置：Helm 安装、Ingress、TLS 与管理员密码获取

本章将使用 Helm Chart 在 Kubernetes 集群中部署 Argo CD，并完成生产环境所需的 Ingress 配置、TLS 证书挂载以及初始管理员密码的获取。这是搭建 GitOps 压测沙盘的基础步骤，所有后续的配额压测与容量预测实验都依赖此环境的正确性。

3.1 环境准备与 Helm 仓库添加

在安装之前，请确保集群已就绪，并且 kubectl 上下文指向目标集群。Argo CD 官方推荐使用 argoproj/argo-cd Helm Chart 进行部署。

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

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

3.2 使用 Helm 安装 Argo CD

创建一个命名空间 argocd，然后使用 Helm 安装。以下命令包含了生产环境常用的配置参数：

kubectl create namespace argocd

helm install argocd argo-cd/argo-cd \
  --namespace argocd \
  --set server.service.type=ClusterIP \
  --set server.ingress.enabled=true \
  --set server.ingress.hosts[0]=argocd.example.com \
  --set server.ingress.tls[0].hosts[0]=argocd.example.com \
  --set server.ingress.tls[0].secretName=argocd-tls \
  --set configs.params."server\.insecure"=true \
  --set controller.replicas=1 \
  --set server.replicas=1 \
  --set repoServer.replicas=1 \
  --set applicationSet.replicas=1

安装完成后，检查 Pod 状态：

kubectl get pods -n argocd

预期输出应包含以下核心组件：

3.3 Ingress 配置与 TLS 证书挂载

Argo CD 的 Ingress 配置支持多种 Ingress Controller（如 Nginx、Traefik、AWS ALB）。以下以 Nginx Ingress Controller 为例，展示完整的 YAML 配置。

首先，创建 TLS 证书 Secret。如果使用自签名证书用于测试环境：

openssl req -x509 -nodes -days 365 -newkey rsa:2048 \
  -keyout argocd-tls.key \
  -out argocd-tls.crt \
  -subj "/CN=argocd.example.com" \
  -addext "subjectAltName=DNS:argocd.example.com"

kubectl create secret tls argocd-tls \
  --cert=argocd-tls.crt \
  --key=argocd-tls.key \
  -n argocd

然后，通过 Helm values 文件或直接编辑 Ingress 对象来配置。以下是完整的 Ingress 资源定义：

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: argocd-ingress
  namespace: argocd
  annotations:
    nginx.ingress.kubernetes.io/backend-protocol: "HTTP"
    nginx.ingress.kubernetes.io/ssl-passthrough: "false"
    nginx.ingress.kubernetes.io/force-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: 80

验证 Ingress 是否生效：

kubectl get ingress -n argocd
# 预期输出显示 ADDRESS 已分配，且 TLS 状态正常

3.4 初始管理员密码获取

Argo CD 安装完成后，初始管理员密码由系统自动生成并存储在 Secret 中。获取密码的官方方法如下：

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

如果 Secret 不存在（常见于某些 Helm 版本或自定义配置），可以通过以下方式重置密码：

# 方法一：直接修改 admin 用户的密码哈希
kubectl exec -n argocd deploy/argocd-server -- \
  argocd account update-password \
  --current-password <old-password> \
  --new-password <new-password>

# 方法二：通过 argocd CLI 重置（需要先登录）
argocd account update-password

3.5 安装验证与访问测试

完成上述步骤后，通过浏览器访问 https://argocd.example.com，使用 admin 和获取到的密码登录。验证以下关键功能：

• UI 加载： 页面正常渲染，无证书告警（自签名证书除外）
• CLI 连接： argocd login argocd.example.com --username admin --password <password> --insecure 成功
• 集群状态： argocd cluster list 显示当前集群为 in-cluster
• 组件健康： 所有 Pod 处于 Running 状态，且 Readiness 探测通过

3.6 常见问题与排错