本文作者：丁辉

Deployment的使用

官方文档

命令部署一个应用

kubectl create deployment nginx --image=nginx:alpine

Yaml 部署一个 Deployment 应用

1. 部署应用(最小化 Yaml)

   cat <<EOF | kubectl apply -f -
   apiVersion: apps/v1
   kind: Deployment
   metadata:
     name: nginx-deployment
     labels:
       app: nginx
   spec:
     replicas: 3
     selector:
       matchLabels:
         app: nginx
     template:
       metadata:
         labels:
           app: nginx
       spec:
         containers:
         - name: nginx
           image: nginx:alpine
           ports:
           - containerPort: 80
   EOF

2. 验证

   kubectl get deployments

更新和回滚

Deployment 支持两种更新策略：滚动更新（RollingUpdate，默认）和删除式更新（Recreate，又称单批次更新）。

• ReCreate

  删除式更新（Recreate）：更新时先删除所有运行中的 Pod，待其彻底终止后创建新 ReplicaSet 及对应 Pod，更新期间服务暂不可用。

  spec:
    strategy:
      type: Recreate

• RollingUpdate

  滚动更新（RollingUpdate）：分批更新 Pod，待一批更新后的 Pod 就绪后再更新下一批，实现服务不中断；更新过程中会存在新老版本应用共存的情况，不同客户端可能获取不同版本响应。

  spec:
    strategy:
      type: RollingUpdate

更新

1. 更新镜像

   在这里，deployment/nginx-deployment 表明 Deployment 的名称，nginx 表明需要进行更新的容器， 而 nginx:latest 则表示镜像的新版本以及它的标签。

   kubectl set image deployment/nginx-deployment nginx=nginx:latest

2. 查看进度

   kubectl rollout status deployment/nginx-deployment

3. 查看状态

   kubectl get rs

回滚

1. 查看 Deployment 修订历史

   kubectl rollout history deployment/nginx-deployment

   设置 CHANGE-CAUSE 消息

   kubectl annotate deployment/nginx-deployment kubernetes.io/change-cause="image updated to latest"

2. 查看修订历史的详细信息

   kubectl rollout history deployment/nginx-deployment --revision=2

3. 回滚

   kubectl rollout undo deployment/nginx-deployment

   或回滚到特定版本

   kubectl rollout undo deployment/nginx-deployment --to-revision=2

重启

kubectl rollout restart deployment deployment/nginx-deployment

副本数调整

kubectl scale deployment/nginx-deployment --replicas=3

暂停、恢复 Deployment 的上线过程

1. 暂停上线

   kubectl rollout pause deployment/nginx-deployment

2. 更新 Deployment 镜像

   kubectl set image deployment/nginx-deployment nginx=nginx:latest

   你可以根据需要执行很多更新操作，例如，可以要使用的资源

   kubectl set resources deployment/nginx-deployment -c=nginx --limits=cpu=200m,memory=512Mi

3. 最终，恢复 Deployment 上线并观察新的 ReplicaSet 的创建过程，其中包含了所应用的所有更新

   kubectl rollout resume deployment/nginx-deployment

4. 监视上线的状态，直到完成

   watch kubectl get rs

更新失败标记为 “Failed” 状态

kubectl patch deployment/nginx-deployment -p '{"spec":{"progressDeadlineSeconds":600}}'

progressDeadlineSeconds

• 作用: 定义 Deployment 滚动更新（Rolling Update）的最大允许时间
• 值 600: 表示 600 秒（1 分钟）
• 默认值: 通常为 600 秒，但显式设置可确保明确性
• 工作逻辑:
  1. 当 Deployment 开始更新（如镜像版本升级）时启动计时
  2. 如果更新过程超过 600 秒仍未完成
  3. Kubernetes 会将 Deployment 标记为 “Failed” 状态
  4. 并自动回滚到之前的稳定版本（如果配置了回滚策略）

配置 ReplicaSet 清理策略

你可以在 Deployment 中设置 .spec.revisionHistoryLimit 字段以指定保留此 Deployment 的多少个旧有 ReplicaSet。其余的 ReplicaSet 将在后台被垃圾回收。 默认情况下，此值为 10。

kubectl patch deployment/nginx-deployment -p '{"spec":{"revisionHistoryLimit":10}}'

金丝雀部署

官方文档

通过副本数控制

操作步骤：

1. 先部署稳定版本（v1，9个副本）

2. 部署金丝雀版本（v2，1个副本）

3. Service会自动将约9%的流量（1/10）导向v2

4. 观察监控，如果v2正常，逐步增加v2副本数，减少v1副本数

5. 部署 Pod-1

   cat <<EOF | kubectl apply -f -
   apiVersion: apps/v1
   kind: Deployment
   metadata:
     name: nginx-deployment-1
     labels:
       app: nginx
   spec:
     replicas: 9
     strategy:
       type: RollingUpdate
     selector:
       matchLabels:
         app: nginx
     template:
       metadata:
         labels:
           app: nginx
           version: v1
       spec:
         containers:
         - name: nginx
           image: registry.cn-hangzhou.aliyuncs.com/offends/demo:nginx-alpine-v1
           ports:
           - containerPort: 80
   EOF

6. 部署 Pod-2

   cat <<EOF | kubectl apply -f -
   apiVersion: apps/v1
   kind: Deployment
   metadata:
     name: nginx-deployment-2
     labels:
       app: nginx
   spec:
     replicas: 1
     strategy:
       type: RollingUpdate
     selector:
       matchLabels:
         app: nginx
     template:
       metadata:
         labels:
           app: nginx
           version: v2
       spec:
         containers:
         - name: nginx
           image: registry.cn-hangzhou.aliyuncs.com/offends/demo:nginx-alpine-v2
           ports:
           - containerPort: 80
   EOF

7. 部署 Service（同时选择v1和v2的Pod）

   cat <<EOF | kubectl apply -f -
   apiVersion: v1
   kind: Service
   metadata:
     name: nginx-deployment-service
   spec:
     selector:
       app: nginx  # 同时选择两个版本的Pod
     ports:
     - port: 80
       targetPort: 80
   EOF

8. 修改权重将流量导向 v2

   • 增加 v2

     kubectl scale deployment/nginx-deployment-2 --replicas=10

   • 降低 v1

     kubectl scale deployment/nginx-deployment-1 --replicas=0

通过 Ingress 实现基于权重的金丝雀

方法类似于前者，只是对象从副本数变换为 Ingress控制

1. 创建两个 Service

   cat <<EOF | kubectl apply -f -
   apiVersion: v1
   kind: Service
   metadata:
     name: nginx-deployment-service-1
   spec:
     selector:
       app: nginx
       version: v1
     ports:
     - port: 80
       targetPort: 80
   ---
   apiVersion: v1
   kind: Service
   metadata:
     name: nginx-deployment-service-2
   spec:
     selector:
       app: nginx
       version: v2
     ports:
     - port: 80
       targetPort: 80
   EOF

2. 创建 Ingress 资源

   cat <<EOF | kubectl apply -f -
   # 金丝雀 Ingress 对象为 v1 版本
   apiVersion: networking.k8s.io/v1
   kind: Ingress
   metadata:
     name: nginx-ingress-1
   spec:
     rules:
     - host: demo.offends.cn
       http:
         paths:
         - path: /
           pathType: Prefix
           backend:
             service:
               name: nginx-deployment-service-1
               port:
                 number: 80
   ---
   # 金丝雀 Ingress 对象为 v2 版本
   apiVersion: networking.k8s.io/v1
   kind: Ingress
   metadata:
     name: nginx-ingress-2
     annotations:
       nginx.ingress.kubernetes.io/canary: "true"
       nginx.ingress.kubernetes.io/canary-weight: "10" # 10%流量到金丝雀
   spec:
     rules:
     - host: demo.offends.cn
       http:
         paths:
         - path: /
           pathType: Prefix
           backend:
             service:
               name: nginx-deployment-service-2
               port:
                 number: 80
   EOF

3. 慢慢调整 nginx-ingress-2 流量到 100%，即完成更新