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 创建一个副本。
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。
使用自己的仓库地址完成提交:
git add apps/hello/deployment.yaml
git commit -m "add hello application"
git push origin main预期输出
[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-REPOSITORY> 替换成实际 Git 仓库 URL,并保存为本地 application.yaml。CreateNamespace=true 允许同步时自动创建目标命名空间 demo。
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 命名空间为目标。首次练习暂不启用自动同步,这样可以明确观察“发现差异”和“执行同步”是两个阶段。
应用该资源并查询状态:
kubectl apply -f application.yaml
argocd app get hello预期输出
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 中描述的目标状态收敛。
argocd app sync hello预期输出
Name: argocd/hello
Project: default
Server: https://kubernetes.default.svc
Namespace: demo
...
Sync Status: Synced
...不要只以命令退出成功作为部署完成依据。同步成功表示资源声明已经应用,还应继续检查 Kubernetes 工作负载是否真正达到可用状态。
从集群侧验证结果
查询目标命名空间中的 Deployment 和 Pod,可以把 Argo CD 的同步结果与 Kubernetes 实际资源对应起来。
kubectl get deployment,pods -n demo预期输出
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 与集群之间的新差异。
git add apps/hello/deployment.yaml
git commit -m "scale hello to two replicas"
git push origin main
argocd app get hello --refresh预期输出
[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 负责检测差异并让集群向声明状态收敛,而不是把人工修改集群作为正常发布入口。