# 使用 Deployment 运行一个无状态应用 LLMS index: [llms.txt](/llms.txt) --- 本文介绍如何通过 Kubernetes Deployment 对象去运行一个应用。 ## 教程目标 - 创建一个 nginx Deployment。 - 使用 kubectl 列举该 Deployment 的相关信息。 - 更新该 Deployment。 ## 准备开始

你必须拥有一个 Kubernetes 的集群，且必须配置 kubectl 命令行工具让其与你的集群通信。 建议运行本教程的集群至少有两个节点，且这两个节点不能作为控制平面主机。 如果你还没有集群，你可以通过 Minikube 构建一个你自己的集群，或者你可以使用下面的 Kubernetes 练习环境之一：

你的 Kubernetes 服务器版本必须不低于版本 v1.9.

要获知版本信息，请输入 kubectl version.

## 创建并了解一个 nginx Deployment 你可以通过创建一个 Kubernetes Deployment 对象来运行一个应用, 且你可以在一个 YAML 文件中描述 Deployment。例如，下面这个 YAML 文件描述了一个运行 nginx:1.14.2 Docker 镜像的 Deployment：
application/deployment.yaml 
apiVersion: apps/v1
kind: Deployment
metadata:
  name: nginx-deployment
spec:
  selector:
    matchLabels:
      app: nginx
  replicas: 2 # 告知 Deployment 运行 2 个与该模板匹配的 Pod
  template:
    metadata:
      labels:
        app: nginx
    spec:
      containers:
      - name: nginx
        image: nginx:1.14.2
        ports:
        - containerPort: 80
1. 通过 YAML 文件创建一个 Deployment： ```shell kubectl apply -f https://k8s.io/examples/application/deployment.yaml ``` 2. 显示该 Deployment 的相关信息： ```shell kubectl describe deployment nginx-deployment ``` 输出类似于这样： ``` Name: nginx-deployment Namespace: default CreationTimestamp: Tue, 30 Aug 2016 18:11:37 -0700 Labels: app=nginx Annotations: deployment.kubernetes.io/revision=1 Selector: app=nginx Replicas: 2 desired | 2 updated | 2 total | 2 available | 0 unavailable StrategyType: RollingUpdate MinReadySeconds: 0 RollingUpdateStrategy: 1 max unavailable, 1 max surge Pod Template: Labels: app=nginx Containers: nginx: Image: nginx:1.14.2 Port: 80/TCP Environment: Mounts: Volumes: Conditions: Type Status Reason ---- ------ ------ Available True MinimumReplicasAvailable Progressing True NewReplicaSetAvailable OldReplicaSets: NewReplicaSet: nginx-deployment-1771418926 (2/2 replicas created) No events. ``` 3. 列出该 Deployment 创建的 Pod： ```shell kubectl get pods -l app=nginx ``` 输出类似于这样： ``` NAME READY STATUS RESTARTS AGE nginx-deployment-1771418926-7o5ns 1/1 Running 0 16h nginx-deployment-1771418926-r18az 1/1 Running 0 16h ``` 4. 展示某一个 Pod 信息： ```shell kubectl describe pod ``` 这里的 `` 是某一 Pod 的名称。 ## 更新 Deployment 你可以通过应用一个新的 YAML 文件来更新 Deployment。下面的 YAML 文件指定该 Deployment 镜像更新为 nginx 1.16.1。
application/deployment-update.yaml 
apiVersion: apps/v1
kind: Deployment
metadata:
  name: nginx-deployment
spec:
  selector:
    matchLabels:
      app: nginx
  replicas: 2
  template:
    metadata:
      labels:
        app: nginx
    spec:
      containers:
      - name: nginx
        image: nginx:1.16.1 # 将 nginx 版本从 1.14.2 更新为 1.16.1
        ports:
        - containerPort: 80
1. 应用新的 YAML： ```shell kubectl apply -f https://k8s.io/examples/application/deployment-update.yaml ``` 2. 查看该 Deployment 以新的名称创建 Pod 同时删除旧的 Pod： ```shell kubectl get pods -l app=nginx ``` ## 通过增加副本数来扩缩应用 你可以通过应用新的 YAML 文件来增加 Deployment 中 Pod 的数量。 下面的 YAML 文件将 `replicas` 设置为 4，指定该 Deployment 应有 4 个 Pod：
application/deployment-scale.yaml 
apiVersion: apps/v1
kind: Deployment
metadata:
  name: nginx-deployment
spec:
  selector:
    matchLabels:
      app: nginx
  replicas: 4 # 将副本数从 2 更新为 4
  template:
    metadata:
      labels:
        app: nginx
    spec:
      containers:
      - name: nginx
        image: nginx:1.16.1
        ports:
        - containerPort: 80
1. 应用新的 YAML 文件： ```shell kubectl apply -f https://k8s.io/examples/application/deployment-scale.yaml ``` 2. 验证该 Deployment 有 4 个 Pod： ```shell kubectl get pods -l app=nginx ``` 输出的结果类似于： ``` NAME READY STATUS RESTARTS AGE nginx-deployment-148880595-4zdqq 1/1 Running 0 25s nginx-deployment-148880595-6zgi1 1/1 Running 0 25s nginx-deployment-148880595-fxcez 1/1 Running 0 2m nginx-deployment-148880595-rwovn 1/1 Running 0 2m ``` 有关包括副本缩容和缩容至零副本在内的详细扩缩过程， 请参阅[手动扩缩 Deployment](/zh-cn/docs/tasks/run-application/scale-deployment/)。 ## 删除 Deployment 基于名称删除 Deployment： ```shell kubectl delete deployment nginx-deployment ``` ## ReplicationController —— 旧的方式 创建一个多副本应用首选方法是使用 Deployment，该 Deployment 内部将轮流使用 ReplicaSet。 在 Deployment 和 ReplicaSet 被引入到 Kubernetes 之前，多副本应用通过 [ReplicationController](/zh-cn/docs/concepts/workloads/controllers/replicationcontroller/) 来配置。 ## 接下来 - 进一步了解 [Deployment 对象](/zh-cn/docs/concepts/workloads/controllers/deployment/)。 - 进一步了解如何[在不中断服务的情况下更新 Deployment](/zh-cn/docs/tasks/run-application/update-deployment-rolling/)。