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 集合。

Deployment、Pod 与 Service 的声明式关系

要让 Service 正确发现 Pod,最关键的是让 spec.selector.matchLabels、Pod 模板中的 metadata.labels 和 Service 的 spec.selector 使用一致的标签。任何一个值不一致,都可能出现 Deployment 正常但 Service 没有后端端点的情况。

编写最小可部署清单

下面的文件同时定义 Deployment 和 Service。示例镜像使用占位仓库地址,实际部署时应替换成 CI 流水线已经推送的不可变镜像标签。

yaml
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: ClusterIP

replicas: 2 让控制器维持两个 Pod;containerPort 描述容器监听端口;Service 的 port 是集群内访问端口,targetPort 是转发到 Pod 的端口。ClusterIP 适合先完成集群内部验证,是否暴露到集群外应由 Ingress、Gateway 或其他入口方案单独决定。

部署并检查对象状态

把清单保存为 <PATH>/k8s.yaml,然后执行:

bash
kubectl apply -f <PATH>/k8s.yaml
kubectl get deployment demo-app
kubectl get pods -l app=demo
kubectl get service demo-app

预期输出

text
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:

bash
kubectl get endpointslice -l kubernetes.io/service-name=demo-app

预期输出

text
NAME            ADDRESSTYPE   PORTS   ENDPOINTS        AGE
demo-app-<ID>   IPv4          8080    <IP>,<IP>        <TIME>

如果 ENDPOINTS 为空,优先对比 Service 的 spec.selector 与 Pod 的实际标签,而不是反复重建 Service。Deployment、Pod 标签和 Service 选择器形成同一条匹配链后,这份清单才真正具备可重复部署的基础。

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

目录与阅读设置

阅读设置

17

记录一个想法

准备 Kubernetes 部署清单

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

登录哪都通