ArgoCD

安装 ArgoCD

官方文档:https://argo-cd.readthedocs.io/en/stable/

直接使用yaml文件安装

  1. 创建 namespace
kubectl create namespace argocd
  1. 下载 yaml 并部署
wget https://raw.githubusercontent.com/argoproj/argo-cd/stable/manifests/install.yaml
kubectl apply -n argocd -f install.yaml -n argocd
  1. 等待 argocd 命名空间所有的工作负载处于就绪状态。
$ kubectl wait --for=condition=Ready pods --all -n argocd --timeout 300s
pod/argocd-application-controller-0 condition met
pod/argocd-applicationset-controller-57bfc6fdb8-x5jxc condition met
......
  1. 查看是否安装完毕
root@devops01:~# kubectl get -n argocd all
NAME                                                    READY   STATUS    RESTARTS   AGE
pod/argocd-applicationset-controller-7d4b8488b8-6zm8n   1/1     Running   0          7m43s
pod/argocd-notifications-controller-67bdc84d96-npqln    1/1     Running   0          7m43s
pod/argocd-repo-server-6488456fd-mkhpg                  1/1     Running   0          7m43s
pod/argocd-application-controller-0                     1/1     Running   0          7m43s
pod/argocd-server-b7898877f-w6kzn                       1/1     Running   0          7m43s
pod/argocd-redis-649b8bc987-hbsc7                       1/1     Running   0          7m43s
pod/argocd-dex-server-67c94bf946-62k9f                  1/1     Running   0          7m43s

NAME                                              TYPE        CLUSTER-IP      EXTERNAL-IP   PORT(S)                      AGE
service/argocd-applicationset-controller          ClusterIP   10.43.154.157   <none>        7000/TCP,8080/TCP            7m43s
service/argocd-dex-server                         ClusterIP   10.43.62.73     <none>        5556/TCP,5557/TCP,5558/TCP   7m43s
service/argocd-metrics                            ClusterIP   10.43.35.21     <none>        8082/TCP                     7m43s
service/argocd-notifications-controller-metrics   ClusterIP   10.43.200.6     <none>        9001/TCP                     7m43s
service/argocd-redis                              ClusterIP   10.43.207.203   <none>        6379/TCP                     7m43s
service/argocd-repo-server                        ClusterIP   10.43.15.103    <none>        8081/TCP,8084/TCP            7m43s
service/argocd-server                             ClusterIP   10.43.104.76    <none>        80/TCP,443/TCP               7m43s
service/argocd-server-metrics                     ClusterIP   10.43.107.39    <none>        8083/TCP                     7m43s

NAME                                               READY   UP-TO-DATE   AVAILABLE   AGE
deployment.apps/argocd-applicationset-controller   1/1     1            1           7m43s
deployment.apps/argocd-notifications-controller    1/1     1            1           7m43s
deployment.apps/argocd-repo-server                 1/1     1            1           7m43s
deployment.apps/argocd-server                      1/1     1            1           7m43s
deployment.apps/argocd-redis                       1/1     1            1           7m43s
deployment.apps/argocd-dex-server                  1/1     1            1           7m43s
  1. 此时通过 ClusterIP 方式暴露的服务是无法在集群外访问的,需要修改 argocd-server 的 svc,将其变为 NodePort 形式。或者使用 Ingress。

可以修改第2步下载的yaml

apiVersion: v1
kind: Service
metadata:
  labels:
    app.kubernetes.io/component: server
    app.kubernetes.io/name: argocd-server
    app.kubernetes.io/part-of: argocd
  name: argocd-server
spec:
  # 指定 NodePort 方式
  type: NodePort
  ports:
  - name: http
    port: 80
    protocol: TCP
    targetPort: 8080
    # 指定端口,需要在 kind 创建集群的时候也执行暴露对应端口
    nodePort: 30080
  - name: https
    port: 443
    protocol: TCP
    targetPort: 8080
  selector:
    app.kubernetes.io/name: argocd-server
  1. 获取默认登录密码,用户名为 admin
kubectl -n argocd get secret argocd-initial-admin-secret -o jsonpath="{.data.password}" | base64 -d
  1. 登录页面

helm 安装

values.yaml

configs:
  secret:
    argocdServerAdminPassword: $2a$10$.NeEDuo4qmMNzuwHBLMvDuIpvqT52TdzW.1Zg9/dDssaiSRN.xa3u #password123
  cm:
    timeout.reconciliation: 30s
  params:
    server.insecure: true

server:
  ingress:
    enabled: true
    ingressClassName: nginx
    hosts:
      - "argocd.wangwei.devopscamp.us"
% helm repo add argo https://argoproj.github.io/argo-helm
"argo" has been added to your repositories

% helm repo update
Hang tight while we grab the latest from your chart repositories...
...Successfully got an update from the "argo" chart repository
Update Complete. ⎈Happy Helming!⎈

edit ./vaules.yaml ingress host
helm upgrade --install -n argocd argocd argo/argo-cd -f ./values.yaml --create-namespace
access argocd.${prefix}.${domain}
login with username: admin, password: <ARGOCD_INITIAL_ADMIN_PASSWORD>

GitOps工作流

在创建 GitOps 工作流之前,我们先来认识一下一个完整 GitOps 工作流都需要哪些关键步骤。

我们可以把这个完整的 GitOps 工作流分成三个部分来看。

第一部分是开发者推送代码到 GitHub 仓库,然后触发 GitHub Action 自动构建。

第二部分是 GitHub Action 自动构建,它包括下面三个步骤。

1. 构建示例应用的镜像。
2. 将示例应用的镜像推送到 Docker Registry 镜像仓库。
3. 更新代码仓库中 Helm Chart values.yaml 文件的镜像版本。

第三部分的核心是 ArgoCD,它包括下面两个步骤。

4. 通过定期 Poll 的方式持续拉取 Git 仓库,并判断是否有新的 commit。
5. 从 Git 仓库获取 Kubernetes 对象,与集群对象进行实时比较,自动更新集群内有差异的资源。

在之前的课程中,我们已经为示例应用创建好了 GitHub Action 来自动构建镜像,但还缺少自动更新 Helm Chart values.yaml 文件的镜像版本逻辑,我会在稍后进行配置。

现在,我们开始创建 GitOps 工作流中的第三部分,也就是创建 ArgoCD 应用,实现 Kubernetes 资源的自动同步。

创建 Argo CD 应用

  1. 创建应用定义仓库

    1. https://github.com/devops-advanced-camp/code/tree/main/iac/week-6/demo-1/vote/helm-example
  2. 创建 Argo CD 应用

    1. UI 界面创建
    2. 声明式创建 https://github.com/devops-advanced-camp/code/blob/main/iac/week-6/demo-2/application.yaml
    # https://argo-cd.readthedocs.io/en/stable/operator-manual/declarative-setup/#applications
    apiVersion: argoproj.io/v1alpha1
    kind: Application
    metadata:
      name: vote-dev
      namespace: argocd
    spec:
      project: default
      source:
        repoURL: https://github.com/devops-advanced-camp/vote-helm.git
        targetRevision: HEAD
        path: demo-2
        helm:
          valueFiles:
            - values.yaml
      destination:
        server: https://kubernetes.default.svc
        namespace: vote-dev
      syncPolicy:
        automated:
          prune: true
          selfHeal: true
        syncOptions:
          - CreateNamespace=true
    
  3. 编辑 demo-2/values.yaml result 镜像版本,查看 GitOps 效果

关于同步的一些配置

  1. automated: 是否自动同步(定期检测 Git 仓库提交)
  2. prune:修剪,当开启时,如果集群内的资源已经在 Git 仓库删除,则将该资源从集群内删除
  3. selfHeal:自愈能力,当 selfHeal 开启时,对集群实时所做的更改会触发自动同步并被强行覆盖

设置资源的高级同步策略(可选)

https://argo-cd.readthedocs.io/en/stable/user-guide/sync-options/

metadata:
  annotations:
    argocd.argoproj.io/sync-options: Prune=false
    argocd.argoproj.io/sync-options: Validate=false
    argocd.argoproj.io/sync-options: SkipDryRunOnMissingResource=true
    argocd.argoproj.io/sync-options: Delete=false
    argocd.argoproj.io/sync-options: PruneLast=true
    argocd.argoproj.io/sync-options: Replace=true
    argocd.argoproj.io/sync-options: ServerSideApply=true

触发同步的三种方式:

  1. 手动修改应用定义

手动修改应用定义仓库,Argo CD 默认以 3min 频率检查仓库变更(Demo2)

  1. 提供 CI 流水线修改

在 CI 流水线里修改应用定义仓库并推送

  1. Argo Image Updater

自动监听镜像仓库变更,当出现新版本镜像时触发同步

Argo Image Updater 案例

  1. 安装 Argo Image Updater
kubectl apply -n argocd -f https://raw.githubusercontent.com/argoprojlabs/argocd-image-updater/stable/manifests/install.yaml

修改 Argo Image Updater 启动参数,镜像检查时间从 2min 修改为 20s

  1. 部署用于 Argo Image Updater 拉取镜像的 Secret

https://github.com/devops-advanced-camp/code/blob/main/iac/week-6/demo-3/harbor-pull-secret.yaml

  1. 为 Application 添加 annotations,并部署

https://github.com/devops-advanced-camp/code/blob/main/iac/week-6/demo-3/application.yaml

  1. 本地构建 result 镜像,并推送到镜像仓库

    1. 检查 image updater 日志
    2. 检查应用定义仓库新 commit

通过 Webhook 触发 Argo CD 同步

Webhook 地址:https://argocd.${prefix}.${domain}/api/webhook

为 Git 仓库配置上述 Webhook 地址

安装 ArgoCD CLI

为了更加方便地配置 ArgoCD,官方还为我们提供了 CLI 工具。不同操作系统的安装方法有所差异,这里以 MacOS 和 Windows 为例简单介绍。

MacOS 可以通过 Brew 来安装。

$ brew install argocd

也可以在 这个链接 下载最新版本的 Binary 二进制文件,并移动到 /usr/local/bin/ 目录下。

Windows 则需要在下载过后,将可执行文件移动到 PATH 下。

更详细的方法可以查看 这份文档。