GitOps实践篇：Argo CD 详解，手把手教你入门

不念不忘少年蓝@ 2024-03-24 15:31 60阅读 0赞

#### **1.Argo CD 能解决什么问题** ####

**1.1 从 GitOps 说起**

GitOps 起源于 Weaveworks 公司在 2017 年发表的一篇博客， GitOps - Operations by Pull Request 。在文中，Alexis 介绍了一种以 Git 为唯一事实来源的部署方式。

在 GitOps 实践中，我们需要将软件设施定义在 Git 仓库中进行管理。其中的软件设施，包括 IaaS、Kubernetes 这样的基础设施，也包括应用本身。每个人都可以通过提交 Pull Request 来修改软件设施，然后通过自动化的程序执行这种修改。

这种方式使得每个人都可以专注于开发新的功能，而不用陷入繁琐的安装、变更、迁移等运维工作。同时，整个过程具有完整的操作记录和权限审批管理。

**1.2 Argo CD 能落地 GitOps**

Argo CD 是以 Kubernetes 为基础设施的 GitOps 持续部署工具。下面是来自 Argo CD 社区的原理图：

![4f9b2231ad543b2d946046f2de233cc8.png][]

1.  Argo CD 从 Git Repo 拉取应用的配置，部署在 Kubernetes 集群中。
2.  当有人新增功能时，提交一个 Pull Requests 到 Git Repo 修改应用的部署配置，等待合并。
3.  在 Pull Requests 合并之后，通过 Webhook 触发 Argo CD 执行更新操作。
4.  应用得到更新，发送通知

理解起来很容易，将运维过程自动化，持续的部署。

**1.3 强大而易扩展的 Argo CD**

对于一般的 Kubernetes 运维场景，上面描述的功能是够用的。但是如果是复杂场景，涉及多云、多平台、多中间件，也是需要考虑的。

![3730b20734181c55d8e240a83c40d1aa.png][]

在 Argo CD 的处理逻辑中，定义了四个组件：

*  Event Source，接入各种事件消息
 *  Sensor，将消息转换为触发的动作
 *  Eventbus，消息订阅路由系统
 *  Trigger，触发外部的实际动作

对于运维人员，需要了解的主要是两点：

*  Argo CD 可以处理什么事件？ AMQP、AWS SNS、AWS SQS、Cron Schedules、GCP PubSub、GitHub、GitLab、HDFS、File Based Events、Kafka、Minio、NATS、MQTT、K8s Resources、Slack、NetApp StorageGrid、Webhooks、Stripe、NSQ、Emitter、Redis、Azure Events Hub
 *  Argo CD 可以处理执行哪些动作？ Argo Workflows、Standard K8s Objects、HTTP Requests、AWS Lambda、NATS Messages、Kafka Messages、Slack Notifications、Argo Rollouts CR、Custom / Build Your Own Triggers、Apache OpenWhisk

#### **2. 在 Kubernetes 上部署 Argo CD** ####

*  新建命名空间，部署 Argo CD

这里选择当前发布的最新版本: 1.8.3

kubectl create namespace argocdkubectl apply -n argocd -f https://raw.githubusercontent.com/argoproj/argo-cd/v1.8.3/manifests/install.yaml

Argo CD 社区还提供了 HA 模式的部署方式，`kubectl apply -n argocd -f https://raw.githubusercontent.com/argoproj/argo-cd/v1.8.3/manifests/ha/install.yaml` 用于生产环境。

*  将服务改为 NodePort 类型，方便访问

kubectl patch svc argocd-server -p '{"spec": {"type": "NodePort"}}' -n argocd

*  查看服务

kubectl -n argocd get svc
    NAME                    TYPE        CLUSTER-IP      EXTERNAL-IP   PORT(S)                      AGEargocd-dex-server       ClusterIP   10.233.34.191   <none>        5556/TCP,5557/TCP,5558/TCP   5m37sargocd-metrics          ClusterIP   10.233.54.3     <none>        8082/TCP                     5m36sargocd-redis            ClusterIP   10.233.18.86    <none>        6379/TCP                     5m36sargocd-repo-server      ClusterIP   10.233.3.171    <none>        8081/TCP,8084/TCP            5m36sargocd-server           NodePort    10.233.61.3     <none>        80:31808/TCP,443:30992/TCP   5m36sargocd-server-metrics   ClusterIP   10.233.36.228   <none>        8083/TCP                     5m36s

*  查看 admin 账户密码

kubectl get pod -n argocd |grep argocd-server
    argocd-server-7d597d9bcd-6nzct        1/1     Running   0          22m

这里 admin 的密码就是 Pod 的名字: argocd-server-7d597d9bcd-6nzct 。

*  登录 Argo CD UI 页面，打开页面 http://\{HOST\_IP\}:31808

![23269350d0a20b7f627a9a26326cb7c1.png][]

使用账户: admin，密码: argocd-server-7d597d9bcd-6nzct 进行登录。

![241c9994c451a70e6897f0d2fd782e4e.png][]

#### **3. 安装 CLI 工具** ####

*  下载 CLI 命令行工具

这里以 Linux 为例进行安装：

curl -sSL -o /usr/local/bin/argocd https://github.com/argoproj/argo-cd/releases/download/v1.8.3/argocd-linux-amd64chmod +x /usr/local/bin/argocd

*  登录 Kubernetes 集群上部署的 Argo CD

将 `HOST_IP` 替换为主机的 IP 地址，使用 CLI 登录集群。

argocd login {HOST_IP}:31808 --username admin --password argocd-server-7d597d9bcd-6nzct
    'admin' logged in successfullyContext '{HOST_IP}:31808' updated

*  更新 admin 密码, 方便下次登录

argocd account update-password --account admin --current-password argocd-server-7d597d9bcd-6nzct --new-password password
    Password updatedContext '{HOST_IP}:31808' updated

这样 admin 密码就被修改为 password 了。

#### **4. 使用 CLI 创建一个应用** ####

*  创建一个应用

可以通过 UI 进行创建应用，但为了能通过复制、粘贴快速体验 Argo CD，这里通过 CLI 工具进行创建。

argocd app create guestbook --repo https://github.com/argoproj/argocd-example-apps.git --path guestbook --dest-server https://kubernetes.default.svc --dest-namespace default

参数说明：

- repo, 指定 Git 仓库- path, 指定部署文件在 Git 仓库中的相对路径- dest-server, 集群的访问地址- dest-namespace, 部署到哪个命名空间

这里 https://github.com/argoproj/argocd-example-apps/tree/master/guestbook 目录下，是一个 deployment 和一个 service 的 yaml 声明。

*  在页面查看创建的服务

![21ff408b9cced98954899fda3e014325.png][]

等待一会儿，查看详情，可以看到应用的拓扑图。

![30573479fc54848696dfbc832483c95c.png][]

*  kubectl 查看创建的服务

kubectl get all -n defaultNAME                                READY   STATUS    RESTARTS   AGEpod/guestbook-ui-65b878495d-wjmxh   1/1     Running   0          60s
    NAME                   TYPE        CLUSTER-IP      EXTERNAL-IP   PORT(S)   AGEservice/guestbook-ui   ClusterIP   10.233.55.230   <none>        80/TCP    61sservice/kubernetes     ClusterIP   10.233.0.1      <none>        443/TCP   12d
    NAME                           READY   UP-TO-DATE   AVAILABLE   AGEdeployment.apps/guestbook-ui   1/1     1            1           60s
    NAME                                      DESIRED   CURRENT   READY   AGEreplicaset.apps/guestbook-ui-65b878495d   1         1         1       60s

*  删除应用，清理环境

argocd app delete guestbook

不仅应用会在 Argo CD 记录中被删除，相关的负载在 Kubernetes 中也会被删除。

#### **5. 总结** ####

本文主要介绍了 Argo CD 非常基础的功能，并通过创建应用对其功能进行了演示。

实际上，Argo CD 的功能并不止于此，比如修改 Git Repo 之后，可以同步到 Kubernetes 中进行更新；修改镜像之后，自动触发更新。从上面的架构图可以看到，通过 Event Source 和 Trigger 可以实现满足很多自动化部署的需求。

另一方面，在更新 Kubernetes 时，Argo CD 还支持 Kustomize、Helm、Ksonnet、Yaml、Json、自定义扩展的资源描述方式，这在使用上会非常方便。

#### **6. 参考** ####

*  https://argoproj.github.io/argo-cd/

[4f9b2231ad543b2d946046f2de233cc8.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/24/31b04ddae7cb4fcaa060e677f170f0a9.png
[3730b20734181c55d8e240a83c40d1aa.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/24/cc077637a7e8437cb393176926effed8.png
[23269350d0a20b7f627a9a26326cb7c1.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/24/3cd22c32c2fd46f6ad6c652edbeaa98e.png
[241c9994c451a70e6897f0d2fd782e4e.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/24/d81d7df7a8344720bd4e22b2ae43f79c.png
[21ff408b9cced98954899fda3e014325.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/24/445112f1d48d436d80ec0bcd6449f4a4.png
[30573479fc54848696dfbc832483c95c.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/24/8897a00282dd4fd682effa2f4318242a.png