xelonag/argocd-image-updater-demo

ArgoCD应用部署指南

概述

本文档提供使用ArgoCD在Kubernetes集群中部署应用和服务的详细指南，包括ArgoCD的安装配置、应用部署方法、Git仓库结构设计及实际部署示例，帮助用户通过GitOps方式管理Kubernetes资源。

核心功能与特性

• ArgoCD安装部署：提供完整的命名空间创建、组件部署、初始密码获取及端口转发流程
• 多方式应用部署：支持通过Web界面向导式部署和Manifest文件声明式部署两种方式
• 灵活的Git仓库结构：推荐可扩展的仓库组织方式，适配多集群、多环境管理需求
• 同步策略控制：支持手动同步和自动同步模式，可预览资源变更后再执行部署
• 应用生命周期管理：提供应用概览功能，可视化展示资源变更并支持部分同步

使用场景

适用于需要通过GitOps理念管理Kubernetes应用的团队，尤其适合多集群管理、多环境部署（开发/测试/生产）及需要严格版本控制的场景。

详细使用方法

ArgoCD安装

部署ArgoCD组件

基于官方文档简化步骤：

1. 创建ArgoCD命名空间

bash
kubectl create namespace argocd

2. 部署ArgoCD组件

bash
kubectl apply -n argocd -f https://raw.githubusercontent.com/argoproj/argo-cd/stable/manifests/install.yaml

3. 获取初始管理员密码（需Base64解码）

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

4. 端口转发访问Web界面（示例转发到本地***端口）

bash
kubectl port-forward svc/argocd-server 12443:443 -n argocd

访问 https://localhost:12443 即可打开Web界面

5. 登录系统 使用用户名admin和步骤3获取的初始密码登录

额外提示：如需公开访问，可配置Ingress或修改服务类型为Load***，注意配置基础安全策略

部署ArgoCD应用

通过Web界面部署

1. 登录ArgoCD Web界面

2. （私有仓库需配置）添加仓库

   • 导航至 Settings > Repositories，点击 + Connect Repo
   • 推荐使用SSH方式：输入名称、选择项目、填写Git仓库URL（如bitbucket.org:your-org/argocd-demo.git）并添加SSH私钥
   • 点击 Connect 验证连接状态

3. 创建新应用

   • 导航至 Applications，点击 + New App
   • 填写配置信息：
     • GENERAL：应用名称（如argo-demo-app-prod）、项目（默认default）、同步策略（默认手动）、同步选项（勾选Auto-Create Namespace）
     • SOURCE：选择已配置的仓库URL、应用路径（如cluster/demo-cluster/demo-app-prod/ArgoDemoApp）
     • DESTINATION：集群URL（https://kubernetes.default.svc，指向Kubernetes API）、目标命名空间（如demo-app-prod）

通过Manifest文件部署

ArgoCD应用是Kubernetes CRD，可通过YAML文件定义并部署：

yaml
apiVersion: argoproj.io/v1alpha1
kind: Application
metadata:
  name: argo-demo-app-prod  # 应用名称
  namespace: argocd         # ArgoCD命名空间
spec:
  project: default          # 所属项目
  source:
    repoURL: 'bitbucket.org:xelonvdc/argocd-demo.git'  # Git仓库URL
    path: cluster/demo-cluster/demo-app-prod/ArgoDemoApp  # 应用路径
    targetRevision: HEAD    # 目标分支/标签
  destination:
    server: 'https://kubernetes.default.svc'  # 目标集群API地址
    namespace: demo-app-prod                  # 目标命名空间
  syncPolicy:
    syncOptions:
      - CreateNamespace=true  # 自动创建命名空间

通过kubectl apply -f <manifest-file.yaml>部署应用

ArgoCD Git仓库结构

推荐为ArgoCD配置创建独立仓库，多集群/多客户场景可拆分仓库。建议结构：

<仓库根目录>
└── cluster                # 集群目录
    └── <集群名称>         # 集群标识（如demo-cluster）
        └── <命名空间>     # 命名空间（如demo-app-prod）
            └── <应用名称> # 应用标识（如ArgoDemoApp）
                └── <Manifest文件>  # Kubernetes资源清单

该结构扩展性强，适合复杂架构管理

部署第一个应用示例

部署简单Web服务

1. 准备Manifest文件（如whoami.yaml），放置于上述仓库结构对应路径（如cluster/demo-cluster/demo-app-prod/ArgoDemoApp/）

2. 推送变更至Git仓库

3. 同步应用（手动同步场景）：

   • 登录Web界面，导航至 Applications
   • 选择目标应用，点击 Sync，在弹出窗口点击 Synchronize 完成部署

应用概览功能

修改Manifest并推送后，通过应用概览（Applications > 点击应用）可查看待变更资源，支持选择性同步（如单独更新Service），适合紧急修复场景，但建议遵循GitOps理念保持完整同步

提示：应用概览页面会显示资源变更状态，例如修改Load***端口后，可在同步前预览变更内容