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,那么在滚动更新时,更新策略是:
- 更新期间最多会有 10 个 Pod(8 个所需的 Pod + 2 个 maxSurge Pod)处于运行状态;
- 更新期间至少会有 6 个 Pod(8 个所需的 Pod - 2 个 maxUnavailable Pod)处于运行状态。
工作负载明细里的最后一行的 NewReplicaSet 指的是由 Deployment 创建并管理的 ReplicaSet 名称。
-
负责编排无状态应用的基础控制器是 ReplicaSet,相应的资源类型通过三个关键组件定义如何编排一个无状态应用
-
replicas:期望运行的 Pod 副本数。
-
selector:标签选择器。
- matchLabels: 等值
- matchExpressions: 标签选择器表达式
-
template:Pod 模板
-
metadata:
- labels: # 注意:同一个命名空间下不要使用同样的 label 以防意外。
-
spec:
-
-
-
Deployment 是建立在 ReplicaSet 控制器上层的更高级的控制器
-
借助于 ReplicaSet 完成无状态应用的基本编排任务
-
它位于 ReplicaSet 更上面一层,基于 ReplicaSet 提供了滚动更新、回滚等更为强大的应用编排功能
-
是 ReplicaSet 资源的编排工具
- Deployment 编排 ReplicaSet
- ReplicaSet 编排 Pod
-
但是,应该直接定义 Deployment 资源来编排 Pod 应用,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。
触发更新
-
触发滚动更新
-
最为常见的更新需求是应用升级,即镜像文件更新,常用方法
$ kubectl set image (-f FILENAME | TYPE NAME) CONTAINER_NAME_1=CONTAINER_IMAGE_1 ... $ kubectl patch (-f FILENAME | TYPE NAME) [-p PATCH|--patch-file FILE] [options]- 直接更新原配置文件,而后使用“kubectl apply”命令触发更新
-
上面第二和第三种方法可用于模板中任何必要配置的更新
-
-
查看更新
- 更新状态:kubectl rollout status (TYPE NAME | TYPE/NAME) [flags] [options]
- 更新历史:kubectl rollout history (TYPE NAME | TYPE/NAME) [flags] [options]
-
回滚
- 回滚到前一版本: kubectl rollout undo (TYPE NAME | TYPE/NAME)
- 回滚到指定版本: kubectl rollout undo (TYPE NAME | TYPE/NAME) --to-revision=X
配置滚动更新策略
-
.spec.strategy策略指定用于用新 Pod 替换旧 Pod 的策略。.spec.strategy.type可以是 “Recreate” 或 “RollingUpdate”。“RollingUpdate” 是默认值。 -
重新创建 Deployment
- 如果
.spec.strategy.type==Recreate,在创建新 Pod 之前,所有现有的 Pod 会被杀死。
- 如果
-
滚动更新 Deployment
- Deployment 会在
.spec.strategy.type==RollingUpdate时,采取滚动更新的方式更新 Pod。可以指定maxUnavailable和maxSurge来控制滚动更新过程。 - 最大不可用:
.spec.strategy.rollingUpdate.maxUnavailable用来指定更新过程中不可用的 Pod 的个数上限。该值可以是绝对数字(例如,5),也可以是所需 Pod 的百分比(例如,10%)。百分比值会转换成绝对数并去除小数部分。 如果.spec.strategy.rollingUpdate.maxSurge为 0,则此值不能为 0。 默认值为 25%。 - 最大峰值:
.spec.strategy.rollingUpdate.maxSurge用来指定可以创建的超出期望 Pod 个数的 Pod 数量。此值可以是绝对数(例如,5)或所需 Pod 的百分比(例如,10%)。 如果MaxUnavailable为 0,则此值不能为 0。百分比值会通过向上取整转换为绝对数。 此字段的默认值为 25%。
- Deployment 会在
-
存在的问题:必须以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
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
扩容和缩容
-
容量管理类型
- 横向伸缩:增加或减少Pod数量
- 纵向(垂直)伸缩:调整Pod上的资源需求和资源限制
-
变动Deployment资源对象中的replicas字段的值即会触发应用规模的扩容或缩容
- 扩容和缩容是ReplicaSet的功能,具体操作由ReplicaSet完成
- 根据应用规模的需要进行手动配置
-
操作方法
-
scale 命令
# kubectl scale deploy deploy名称 --replicas=pod数量 -n 命名空间 # kubectl scale deploy pc-deployment --replicas=5 -n dev -
patch 命令
kubectl patch (-f FILENAME | TYPE NAME) [-p PATCH|--patch-file FILE] [options] 例如:kubectl patch deployment deploy-example -p '{"spec":{"replicas":3}}' -
直接更新 deployment
# kubectl edit deploy deploy名字 -n 命名空间 # kubectl edit deploy pc-deployment -n dev -
直接更新原配置文件,而后使用“kubectl apply”命令触发更新
-
-
扩展:自动扩容和缩容
- HPA(Horizontal Pod Autoscaler)控制器
- VPA(Vertical Pod Autoscaler)控制器