Deployments

Deployment 用于管理运行一个应用负载的一组 Pod,通常适用于不保持状态的负载。deployment 管理 replicaset,replicaset 管理 pod。

此外,Deployment 还可以提供横向伸缩能力,配合 HPA 自动进行扩缩容。

所以,在实际项目中,对于无状态应用,Deployment 是最佳的选择。

下面是一个 Deployment 示例。其中创建了一个 ReplicaSet,负责启动三个 nginx Pod:

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:1.14.2
        ports:
        - containerPort: 80

查看 Deployment 运行 kubectl get deployments。输出类似于:

$ kubectl get pod                       
NAME                                READY   STATUS              RESTARTS   AGE
nginx-deployment-d556bf558-jw79t    0/1     ContainerCreating   0          4s
nginx-deployment-d556bf558-kt656    0/1     ContainerCreating   0          4s
nginx-deployment-d556bf558-w62c6    0/1     ContainerCreating   0          4s

$ kubectl get pod                       
NAME                                READY   STATUS    RESTARTS   AGE
nginx-deployment-d556bf558-jw79t    1/1     Running   0          49s
nginx-deployment-d556bf558-kt656    1/1     Running   0          49s
nginx-deployment-d556bf558-w62c6    1/1     Running   0          49

要查看 Deployment 创建的 ReplicaSet(rs),运行 kubectl get rs。 输出类似于:

$ kubectl get rs
NAME                          DESIRED   CURRENT   READY   AGE
nginx-deployment-d556bf558    3         3         3       91s

要查看每个 Pod 自动生成的标签,运行 kubectl get pods --show-labels。 输出类似于:

$ kubectl get pods --show-labels
NAME                                READY   STATUS    RESTARTS   AGE    LABELS
nginx-deployment-d556bf558-jw79t    1/1     Running   0          2m9s   app=nginx,pod-template-hash=d556bf558
nginx-deployment-d556bf558-kt656    1/1     Running   0          2m9s   app=nginx,pod-template-hash=d556bf558
nginx-deployment-d556bf558-w62c6    1/1     Running   0          2m9s   app=nginx,pod-template-hash=d556bf558

要获取工作负载详情,运行 kubectl describe deployment 。输出类似于:

$ kubectl describe deploy nginx-deployment           
Name:                   nginx-deployment
Namespace:              default
......
Replicas:               3 desired | 3 updated | 3 total | 3 available | 0 unavailable
StrategyType:           RollingUpdate
......
RollingUpdateStrategy:  25% max unavailable, 25% max surge
......
OldReplicaSets:  <none>
NewReplicaSet:   nginx-deployment-d556bf558 (3/3 replicas created)

在上面的返回内容中,我们要重点关注几个信息。首先, StrategyType 代表的是部署策略,它默认以 RollingUpdate 也就是滚动更新的方式对 Pod 进行逐个更新,它是默认的更新策略,不会造成业务停机。

RollingUpdateStrategy 是对滚动更新更加精细的控制。max surge 用来指定最大超出期望 Pod 的个数,max unavailable 是允许 Pod 不可用的数量,以期望 8 个副本数的工作负载为例,max unavailable 的值为 25% ,也就是 2,max surge 的值为 25%,也是 2,那么在滚动更新时,更新策略是:

工作负载明细里的最后一行的 NewReplicaSet 指的是由 Deployment 创建并管理的 ReplicaSet 名称。

Pod名字里的那串随机数“75675f5897”就是Pod模板的Hash值,也就是Pod的“版本号”。如果变动了Pod YAML描述,比如把镜像改成 nginx:stable-alpine,或者把容器名字改成 nginx-test,都会生成一个新的应用版本

更新 Deployment

仅当 Deployment Pod 模板(即 .spec.template)发生改变时,例如模板的标签或容器镜像被更新, 才会触发 Deployment 上线。其他更新(如对 Deployment 执行扩缩容的操作)不会触发上线动作。

更新 nginx Pod 以使用 nginx:1.16.1 镜像,而不是 nginx:1.14.2 镜像。

kubectl set image deployment.v1.apps/nginx-deployment nginx=nginx:1.16.1

# 或者
kubectl set image deployment/nginx-deployment nginx=nginx:1.16.1

# 或者,对 Deployment 执行 edit 操作并将 .spec.template.spec.containers[0].image 从 nginx:1.14.2 更改至 nginx:1.16.1。

触发更新

配置滚动更新策略

示例:

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:1.14.2
        ports:
        - containerPort: 80
  strategy:
    type: RollingUpdate
    rollingUpdate:
      maxSurge: 1
      maxUnavailable: 1

如果Pod 数原本只有 1 个,滚动更新会如何处理?

答:根据上述规则判断为:先创建一个 replicaset 和对应的 Pod,等待新的 Pod 成功启动后删除旧 Pod。

验证:

$ kubectl get replicaset --watch 
NAME                          DESIRED   CURRENT   READY   AGE
nginx-deployment-d556bf558    1         1         1       21m
nginx-deployment-567cbc4d7c   1         0         0       0s
nginx-deployment-567cbc4d7c   1         0         0       0s
nginx-deployment-567cbc4d7c   1         1         0       0s
nginx-deployment-567cbc4d7c   1         1         1       101s
nginx-deployment-d556bf558    0         1         1       24m
nginx-deployment-d556bf558    0         1         1       24m
nginx-deployment-d556bf558    0         0         0       24m
$ while true;do sleep 1;date;kubectl get pod | grep nginx;done
2025年 3月21日 星期五 23时28分53秒 CST
nginx-deployment-d556bf558-kt656    1/1     Running   0          22m
2025年 3月21日 星期五 23时28分55秒 CST
nginx-deployment-d556bf558-kt656    1/1     Running   0          22m
......
2025年 3月21日 星期五 23时29分13秒 CST
nginx-deployment-567cbc4d7c-w469c   0/1     ContainerCreating   0          1s
nginx-deployment-d556bf558-kt656    1/1     Running             0          23m
2025年 3月21日 星期五 23时29分14秒 CST
nginx-deployment-567cbc4d7c-w469c   0/1     ContainerCreating   0          2s
nginx-deployment-d556bf558-kt656    1/1     Running             0          23m
...
2025年 3月21日 星期五 23时30分53秒 CST
nginx-deployment-567cbc4d7c-w469c   0/1     ContainerCreating   0          101s
nginx-deployment-d556bf558-kt656    1/1     Running             0          24m
2025年 3月21日 星期五 23时30分54秒 CST
nginx-deployment-567cbc4d7c-w469c   1/1     Running     0          102s
nginx-deployment-d556bf558-kt656    0/1     Completed   0          24m
2025年 3月21日 星期五 23时30分55秒 CST
nginx-deployment-567cbc4d7c-w469c   1/1     Running   0          103s
2025年 3月21日 星期五 23时30分56秒 CST
nginx-deployment-567cbc4d7c-w469c   1/1     Running   0          104s
$ kubectl get pod -w | grep nginx
nginx-deployment-d556bf558-kt656    1/1     Running   0          22m
nginx-deployment-567cbc4d7c-w469c   0/1     Pending   0          0s
nginx-deployment-567cbc4d7c-w469c   0/1     Pending   0          0s
nginx-deployment-567cbc4d7c-w469c   0/1     ContainerCreating   0          0s
nginx-deployment-567cbc4d7c-w469c   1/1     Running             0          101s
nginx-deployment-d556bf558-kt656    1/1     Terminating         0          24m
nginx-deployment-d556bf558-kt656    0/1     Completed           0          24m
nginx-deployment-d556bf558-kt656    0/1     Completed           0          24m
nginx-deployment-d556bf558-kt656    0/1     Completed           0          24m

扩容和缩容