CI/CD / 系统课时

让第一个应用从 Git 进入集群

让第一个应用从 Git 进入集群

这一课建立最小但完整的 GitOps 链路:把 Kubernetes 声明提交到 Git,由 Argo CD 读取仓库、计算期望状态并同步到集群。重点不是手工创建 Deployment,而是观察 Git 如何成为应用部署状态的来源。

学习目标

  • 建立可被 Argo CD 读取的最小 Kubernetes 清单目录
  • 创建 Application 并理解 Git、Argo CD 与集群之间的数据流
  • 通过同步状态和 Kubernetes 资源验证首次 GitOps 部署

准备最小 Git 仓库

创建一个 Git 仓库,并在其中建立 apps/hello 目录。这里直接使用原生 Kubernetes YAML,让第一次链路验证不受 Helm 模板等额外因素干扰。

下面是片段示例,需要保存为仓库中的 apps/hello/deployment.yaml。镜像使用公开的 NGINX 镜像,Deployment 创建一个副本。

yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: hello
spec:
  replicas: 1
  selector:
    matchLabels:
      app: hello
  template:
    metadata:
      labels:
        app: hello
    spec:
      containers:
        - name: nginx
          image: nginx:1.27-alpine
          ports:
            - containerPort: 80

这份配置本身不会因为存在于 Git 中而自动进入集群。提交并推送后,仓库只是保存了期望状态;真正负责读取和同步它的是 Argo CD。

使用自己的仓库地址完成提交:

bash
git add apps/hello/deployment.yaml
git commit -m "add hello application"
git push origin main

预期输出

text
[main <ID>] add hello application
...
To <GIT-REPOSITORY>
...

提交 ID、文件统计和远端输出会不同。关键结果是 main 分支已经包含 apps/hello/deployment.yaml,并且 Argo CD 所在环境能够访问该仓库。

创建 Argo CD Application

Application 是 Argo CD 的核心自定义资源,它把三个关键信息关联起来:从哪个 Git 仓库读取、读取哪个目录、同步到哪个 Kubernetes 目标位置。

Git 到 Argo CD 再到 Kubernetes 的首次同步链路

下面是片段示例,需要将 <GIT-REPOSITORY> 替换成实际 Git 仓库 URL,并保存为本地 application.yaml。CreateNamespace=true 允许同步时自动创建目标命名空间 demo。

yaml
apiVersion: argoproj.io/v1alpha1
kind: Application
metadata:
  name: hello
  namespace: argocd
spec:
  project: default
  source:
    repoURL: <GIT-REPOSITORY>
    targetRevision: main
    path: apps/hello
  destination:
    server: https://kubernetes.default.svc
    namespace: demo
  syncPolicy:
    syncOptions:
      - CreateNamespace=true

配置生效行为是:Argo CD 跟踪 main 分支的 apps/hello 路径,并把其中的资源以当前集群的 demo 命名空间为目标。首次练习暂不启用自动同步,这样可以明确观察“发现差异”和“执行同步”是两个阶段。

应用该资源并查询状态:

bash
kubectl apply -f application.yaml
argocd app get hello

预期输出

text
application.argoproj.io/hello created
Name:               argocd/hello
Project:            default
Server:             https://kubernetes.default.svc
Namespace:          demo
...
Sync Status:        OutOfSync
...

首次比较完成后通常会看到 OutOfSync,因为 Git 中已经声明 Deployment,而目标集群还没有对应资源。状态输出的字段顺序和附加信息可能随版本变化。

执行第一次同步

确认 Argo CD 已成功读取仓库后,再主动执行同步。同步命令会要求 Argo CD 将集群实际状态向 Git 中描述的目标状态收敛。

bash
argocd app sync hello

预期输出

text
Name:               argocd/hello
Project:            default
Server:             https://kubernetes.default.svc
Namespace:          demo
...
Sync Status:        Synced
...

不要只以命令退出成功作为部署完成依据。同步成功表示资源声明已经应用,还应继续检查 Kubernetes 工作负载是否真正达到可用状态。

从集群侧验证结果

查询目标命名空间中的 Deployment 和 Pod,可以把 Argo CD 的同步结果与 Kubernetes 实际资源对应起来。

bash
kubectl get deployment,pods -n demo

预期输出

text
NAME                    READY   UP-TO-DATE   AVAILABLE   AGE
deployment.apps/hello   1/1     1            1           <TIME>

NAME                         READY   STATUS    RESTARTS   AGE
pod/hello-<ID>               1/1     Running   0          <TIME>

Pod 后缀和运行时间是动态值。此时链路已经闭合:Git 保存 Deployment 的期望状态,Argo CD 读取并比较状态,同步动作创建 Kubernetes 资源,最终 Pod 在 demo 命名空间运行。

验证 Git 才是变更入口

把仓库中 replicas 从 1 改成 2,提交并推送,但暂时不要执行 kubectl scale。这样可以观察 Argo CD 如何发现 Git 与集群之间的新差异。

bash
git add apps/hello/deployment.yaml
git commit -m "scale hello to two replicas"
git push origin main
argocd app get hello --refresh

预期输出

text
[main <ID>] scale hello to two replicas
...
Sync Status:        OutOfSync
...

随后再次运行 argocd app sync hello,并用 kubectl get deployment,pods -n demo 验证副本数收敛到 2。这一步体现了 GitOps 的关键工作方式:部署意图先进入 Git,Argo CD 负责检测差异并让集群向声明状态收敛,而不是把人工修改集群作为正常发布入口。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

让第一个应用从 Git 进入集群

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通