4. Argo CD 安装与配置：在 K8s 集群中安装 Argo CD，配置 SSH/HTTPS 仓库连接，Web UI 初探

4.1 安装前提与版本选择

在开始安装 Argo CD 之前，需要确认 Kubernetes 集群满足以下最低要求：

4.2 安装 Argo CD 到 K8s 集群

Argo CD 提供两种安装方式：快速安装（install.yaml）和高可用安装（ha/install.yaml）。本课程采用快速安装方式，适合实验与中小规模生产环境。

# 创建命名空间
kubectl create namespace argocd

# 安装 Argo CD 核心组件
kubectl apply -n argocd -f https://raw.githubusercontent.com/argoproj/argo-cd/stable/manifests/install.yaml

# 验证所有 Pod 处于 Running 状态
kubectl get pods -n argocd -w

安装完成后，集群中会运行以下核心 Pod：

4.3 获取初始管理员密码与 CLI 配置

安装完成后，Argo CD 自动生成管理员密码，存储在 Secret 中：

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

# 下载并安装 Argo CD CLI
curl -sSL -o /usr/local/bin/argocd \
  https://github.com/argoproj/argo-cd/releases/latest/download/argocd-linux-amd64
chmod +x /usr/local/bin/argocd

# 登录 Argo CD（先暴露服务，见 4.4 节）
argocd login <ARGOCD_SERVER>:443 --username admin --password <PASSWORD> --insecure

4.4 配置 Web UI 外部访问

Argo CD Server 默认以 ClusterIP 方式暴露。本课程提供三种访问方式，推荐使用 Ingress 方案：

Ingress 配置示例（nginx-ingress）：

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

4.5 配置 Git 仓库连接（SSH / HTTPS）

Argo CD 通过 argocd repo add 命令或 Web UI 添加 Git 仓库。本课程演示两种协议配置：

4.5.1 HTTPS 仓库连接（推荐用于快速开始）

# 添加公开 HTTPS 仓库（无需认证）
argocd repo add https://github.com/example/gitops-manifests.git \
  --name my-helm-repo \
  --type helm

# 添加私有 HTTPS 仓库（使用 Personal Access ）
argocd repo add https://github.com/example/private-repo.git \
  --username gitops-bot \
  --password <GITHUB_PAT> \
  --insecure-skip-server-verification

4.5.2 SSH 仓库连接（生产环境推荐）

# 生成专用 SSH 密钥（无密码短语）
ssh-keygen -t ed25519 -C "argocd@example.com" -f /tmp/argocd-ssh-key

# 将公钥添加到 Git 仓库的 Deploy Keys 中（GitHub / GitLab / Bitbucket）

# 添加 SSH 仓库
argocd repo add git@github.com:example/gitops-manifests.git \
  --ssh-private-key-path /tmp/argocd-ssh-key \
  --name production-repo

# 验证仓库连接状态
argocd repo list

4.6 Web UI 初探与核心界面导航

访问 https://argocd.example.com（或 Port Forward 地址），使用 admin 与初始密码登录。Web UI 主要功能区如下：

Web UI 核心操作路径：

1. 应用列表：左侧面板展示所有 Application，通过颜色/图标快速识别同步状态（Synced / OutOfSync / Unknown）。
2. 同步状态卡片：顶部展示当前选中应用的 Sync Status 与 Health Status，一目了然。
3. 资源树：可视化展示 K8s 资源层级关系，支持点击查看 YAML 详情与事件日志。
4. 操作按钮：SYNC 触发手动同步，ROLLBACK 进入回滚选择界面，REFRESH 强制重新拉取 Git 仓库。
5. 设置入口：右上角 Settings 可管理仓库连接、项目 RBAC、通知配置等。

4.7 验证安装与仓库连接

完成上述步骤后，执行以下验证清单：