CI/CD / 系统课时
准备 Kubernetes 部署清单
准备 Kubernetes 部署清单
本课把一个已经构建好的容器镜像整理成可重复部署的 Kubernetes 清单。完成后,你会得到一组最小但完整的 Deployment 与 Service 定义,并能用 kubectl 部署、检查 Pod 副本和验证 Service 选择器是否正确命中应用实例。
学习目标
- 能用
Deployment声明应用副本、镜像、标签和容器端口 - 能用
Service通过标签选择器稳定访问一组 Pod - 能部署清单并检查 Deployment、Pod 与 Service 的关联结果
先确定清单中的对象关系
Deployment 负责声明“应该运行多少个应用实例”,控制器会据此创建 ReplicaSet,再由 ReplicaSet 维持 Pod 数量。Service 不直接指向 Deployment,而是通过 selector 匹配 Pod 标签,把一个稳定的虚拟访问入口映射到动态变化的 Pod 集合。

要让 Service 正确发现 Pod,最关键的是让 spec.selector.matchLabels、Pod 模板中的 metadata.labels 和 Service 的 spec.selector 使用一致的标签。任何一个值不一致,都可能出现 Deployment 正常但 Service 没有后端端点的情况。
编写最小可部署清单
下面的文件同时定义 Deployment 和 Service。示例镜像使用占位仓库地址,实际部署时应替换成 CI 流水线已经推送的不可变镜像标签。
apiVersion: apps/v1
kind: Deployment
metadata:
name: demo-app
spec:
replicas: 2
selector:
matchLabels:
app: demo
template:
metadata:
labels:
app: demo
spec:
containers:
- name: demo-app
image: registry.example.com/demo-app:1.0.0
imagePullPolicy: IfNotPresent
ports:
- name: http
containerPort: 8080
---
apiVersion: v1
kind: Service
metadata:
name: demo-app
spec:
selector:
app: demo
ports:
- name: http
port: 80
targetPort: 8080
type: ClusterIPreplicas: 2 让控制器维持两个 Pod;containerPort 描述容器监听端口;Service 的 port 是集群内访问端口,targetPort 是转发到 Pod 的端口。ClusterIP 适合先完成集群内部验证,是否暴露到集群外应由 Ingress、Gateway 或其他入口方案单独决定。
部署并检查对象状态
把清单保存为 <PATH>/k8s.yaml,然后执行:
kubectl apply -f <PATH>/k8s.yaml
kubectl get deployment demo-app
kubectl get pods -l app=demo
kubectl get service demo-app预期输出
deployment.apps/demo-app created
service/demo-app created
NAME READY UP-TO-DATE AVAILABLE AGE
demo-app 2/2 2 2 <TIME>
NAME READY STATUS RESTARTS AGE
demo-app-<ID> 1/1 Running 0 <TIME>
demo-app-<ID> 1/1 Running 0 <TIME>
NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) AGE
demo-app ClusterIP <IP> <none> 80/TCP <TIME>Pod 名称、集群 IP 和时间值由集群动态生成,所以实际值会不同。关键是 Deployment 显示 2/2 可用,两个 Pod 为 Running,Service 已创建且端口为 80/TCP。
验证 Service 是否真正选中了 Pod
对象存在不代表流量链路已经成立。可以直接查看 Service 生成的 EndpointSlice:
kubectl get endpointslice -l kubernetes.io/service-name=demo-app预期输出
NAME ADDRESSTYPE PORTS ENDPOINTS AGE
demo-app-<ID> IPv4 8080 <IP>,<IP> <TIME>如果 ENDPOINTS 为空,优先对比 Service 的 spec.selector 与 Pod 的实际标签,而不是反复重建 Service。Deployment、Pod 标签和 Service 选择器形成同一条匹配链后,这份清单才真正具备可重复部署的基础。