Merge pull request #53248 from my-git9/npe-7081

[zh-cn]sync deployment-v1

Author: k8s-ci-robot

content/zh-cn/docs/reference/kubernetes-api/workload-resources/deployment-v1.md

@@ -51,16 +51,16 @@ Deployment 使得 Pod 和 ReplicaSet 能够进行声明式更新。
   Most recently observed status of the Deployment.
 -->
 - **metadata** (<a href="{{< ref "../common-definitions/object-meta#ObjectMeta" >}}">ObjectMeta</a>)
-  
+
   标准的对象元数据。更多信息：
   https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
 
 - **spec** (<a href="{{< ref "../workload-resources/deployment-v1#DeploymentSpec" >}}">DeploymentSpec</a>)
-  
+
   Deployment 预期行为的规约。
 
 - **status** (<a href="{{< ref "../workload-resources/deployment-v1#DeploymentStatus" >}}">DeploymentStatus</a>)
-  
+
   最近观测到的 Deployment 状态。
 
 ## DeploymentSpec {#DeploymentSpec}
@@ -82,12 +82,12 @@ DeploymentSpec 定义 Deployment 预期行为的规约。
   Template describes the pods that will be created. The only allowed template.spec.restartPolicy value is "Always".
 -->
 - **selector** (<a href="{{< ref "../common-definitions/label-selector#LabelSelector" >}}">LabelSelector</a>)，必需
-  
+
   供 Pod 所用的标签选择算符。通过此字段选择现有 ReplicaSet 的 Pod 集合，
   被选中的 ReplicaSet 将受到这个 Deployment 的影响。此字段必须与 Pod 模板的标签匹配。
 
 - **template** (<a href="{{< ref "../workload-resources/pod-template-v1#PodTemplateSpec" >}}">PodTemplateSpec</a>)，必需
-  
+
   template 描述将要创建的 Pod。`template.spec.restartPolicy`
   唯一被允许的值是 `Always`。
 
@@ -101,19 +101,19 @@ DeploymentSpec 定义 Deployment 预期行为的规约。
   Minimum number of seconds for which a newly created pod should be ready without any of its container crashing, for it to be considered available. Defaults to 0 (pod will be considered available as soon as it is ready)
 -->
 - **replicas** (int32)
-  
+
   预期 Pod 的数量。这是一个指针，用于辨别显式零和未指定的值。默认为 1。
 
 - **minReadySeconds** (int32)
-  
+
   新建的 Pod 在没有任何容器崩溃的情况下就绪并被系统视为可用的最短秒数。
   默认为 0（Pod 就绪后即被视为可用）。
 
 <!--
 - **strategy** (DeploymentStrategy)
 
   *Patch strategy: retainKeys*
-  
+
   The deployment strategy to use to replace existing pods with new ones.
 
   <a name="DeploymentStrategy"></a>
@@ -132,26 +132,35 @@ DeploymentSpec 定义 Deployment 预期行为的规约。
   - **strategy.type** (string)
 
     Type of deployment. Can be "Recreate" or "RollingUpdate". Default is RollingUpdate.
-    
+
+    Possible enum values:
+     - `"Recreate"` Kill all existing pods before creating new ones.
+     - `"RollingUpdate"` Replace the old ReplicaSets by new one using rolling update i.e gradually scale down the old ReplicaSets and scale up the new one.
+  -->
+  - **strategy.type** (string)
+
+    部署的类型。取值可以是 “Recreate” 或 “RollingUpdate”。默认为 RollingUpdate。
+
+    可能的枚举值：
+     - `"Recreate"`：在创建新实例之前杀死所有现有的 Pod。
+     - `"RollingUpdate"`：使用滚动更新替换旧的 ReplicaSet，即逐渐缩小旧的 ReplicaSet 并扩大新的 ReplicaSet。
+
+  <!--
   - **strategy.rollingUpdate** (RollingUpdateDeployment)
 
     Rolling update config params. Present only if DeploymentStrategyType = RollingUpdate.
 
     <a name="RollingUpdateDeployment"></a>
     *Spec to control the desired behavior of rolling update.*
   -->
-
-  - **strategy.type** (string)
-    
-    部署的类型。取值可以是 “Recreate” 或 “RollingUpdate”。默认为 RollingUpdate。
 
   - **strategy.rollingUpdate** (RollingUpdateDeployment)
-    
+
     滚动更新这些配置参数。仅当 DeploymentStrategyType = RollingUpdate 时才出现。
 
     <a name="RollingUpdateDeployment"></a>
     **控制滚动更新预期行为的规约。**
-    
+
     <!--
     - **strategy.rollingUpdate.maxSurge** (IntOrString)
 
@@ -162,19 +171,19 @@ DeploymentSpec 定义 Deployment 预期行为的规约。
     -->
 
     - **strategy.rollingUpdate.maxSurge** (IntOrString)
-      
+
       超出预期的 Pod 数量之后可以调度的最大 Pod 数量。该值可以是一个绝对数（例如：
       5）或一个预期 Pod 的百分比（例如：10%）。如果 MaxUnavailable 为 0，则此字段不能为 0。
       通过向上取整计算得出一个百分比绝对数。默认为 25%。例如：当此值设为 30% 时，
       如果滚动更新启动，则可以立即对 ReplicaSet 扩容，从而使得新旧 Pod 总数不超过预期 Pod 数量的 130%。
       一旦旧 Pod 被杀死，则可以再次对新的 ReplicaSet 扩容，
       确保更新期间任何时间运行的 Pod 总数最多为预期 Pod 数量的 130%。
-      
+
       <a name="IntOrString"></a>
       **IntOrString 是可以保存 int32 或字符串的一个类型。
       当用于 JSON 或 YAML 编组和取消编组时，它会产生或消费内部类型。
       例如，这允许你拥有一个可以接受名称或数值的 JSON 字段。**
-    
+
     <!--
     - **strategy.rollingUpdate.maxUnavailable** (IntOrString)
 
@@ -185,14 +194,14 @@ DeploymentSpec 定义 Deployment 预期行为的规约。
     -->
 
     - **strategy.rollingUpdate.maxUnavailable** (IntOrString)
-      
+
       更新期间可能不可用的最大 Pod 数量。该值可以是一个绝对数（例如：
       5）或一个预期 Pod 的百分比（例如：10%）。通过向下取整计算得出一个百分比绝对数。
       如果 MaxSurge 为 0，则此字段不能为 0。默认为 25%。
       例如：当此字段设为 30%，则在滚动更新启动时 ReplicaSet 可以立即缩容为预期 Pod 数量的 70%。
       一旦新的 Pod 就绪，ReplicaSet 可以再次缩容，接下来对新的 ReplicaSet 扩容，
       确保更新期间任何时间可用的 Pod 总数至少是预期 Pod 数量的 70%。
-      
+
       <a name="IntOrString"></a>
       **IntOrString 是可以保存 int32 或字符串的一个类型。
       当用于 JSON 或 YAML 编组和取消编组时，它会产生或消费内部类型。
@@ -216,13 +225,13 @@ DeploymentSpec 定义 Deployment 预期行为的规约。
   保留允许回滚的旧 ReplicaSet 的数量。这是一个指针，用于辨别显式零和未指定的值。默认为 10。
 
 - **progressDeadlineSeconds** (int32)
-  
+
   Deployment 在被视为失败之前取得进展的最大秒数。Deployment 控制器将继续处理失败的 Deployment，
   原因为 ProgressDeadlineExceeded 的状况将被显示在 Deployment 状态中。
   请注意，在 Deployment 暂停期间将不会估算进度。默认为 600s。
 
 - **paused** (boolean)
-  
+
   指示 Deployment 被暂停。
 
 ## DeploymentStatus {#DeploymentStatus}
@@ -248,11 +257,11 @@ DeploymentStatus 是最近观测到的 Deployment 状态。
   Total number of non-terminating pods targeted by this Deployment with a Ready Condition.
 -->
 - **replicas** (int32)
-  
+
   此 Deployment 所针对的（其标签与选择算符匹配）未终止 Pod 的总数。
 
 - **availableReplicas** (int32)
-  
+
   此 Deployment 针对的可用（至少 minReadySeconds 才能就绪）非终止的 Pod 总数。
 
 - **readyReplicas** (int32)
@@ -265,7 +274,7 @@ DeploymentStatus 是最近观测到的 Deployment 状态。
   Total number of unavailable pods targeted by this deployment. This is the total number of pods that are still required for the deployment to have 100% available capacity. They may either be pods that are running but not yet available or pods that still have not been created.
 -->
 - **unavailableReplicas** (int32)
-  
+
   此 Deployment 针对的不可用 Pod 总数。这是 Deployment 具有 100% 可用容量时仍然必需的 Pod 总数。
   它们可能是正在运行但还不可用的 Pod，也可能是尚未创建的 Pod。
 
@@ -277,15 +286,15 @@ DeploymentStatus 是最近观测到的 Deployment 状态。
 - **terminatingReplicas** (int32)
 
   Total number of terminating pods targeted by this deployment. Terminating pods have a non-null .metadata.deletionTimestamp and have not yet reached the Failed or Succeeded .status.phase.
-  
+
   This is an alpha field. Enable DeploymentReplicaSetTerminatingReplicas to be able to use this field.
 
 - **collisionCount** (int32)
 
   Count of hash collisions for the Deployment. The Deployment controller uses this field as a collision avoidance mechanism when it needs to create the name for the newest ReplicaSet.
 -->
 - **updatedReplicas** (int32)
-  
+
   此 Deployment 所针对的未终止 Pod 的总数，这些 Pod 采用了预期的模板规约。
 
 - **terminatingReplicas** (int32)
@@ -297,7 +306,7 @@ DeploymentStatus 是最近观测到的 Deployment 状态。
   这是一个 Alpha 字段。要使用该字段，需要启用 DeploymentReplicaSetTerminatingReplicas 特性门控。
 
 - **collisionCount** (int32)
-  
+
   供 Deployment 所用的哈希冲突计数。
   Deployment 控制器在需要为最新的 ReplicaSet 创建名称时将此字段用作冲突预防机制。
 
@@ -314,16 +323,16 @@ DeploymentStatus 是最近观测到的 Deployment 状态。
   *DeploymentCondition describes the state of a deployment at a certain point.*
 -->
 - **conditions** ([]DeploymentCondition)
-  
+
   **补丁策略：按照键 `type` 合并**
 
-  **Map：键 `type` 的唯一值将在合并期间保留**  
+  **Map：键 `type` 的唯一值将在合并期间保留**
 
   表示 Deployment 当前状态的最新可用观测值。
-  
+
   <a name="DeploymentCondition"></a>
   **DeploymentCondition 描述某个点的 Deployment 状态。**
-  
+
   <!--
   - **conditions.status** (string), required
 
@@ -339,9 +348,9 @@ DeploymentStatus 是最近观测到的 Deployment 状态。
     状况的状态，取值为 True、False 或 Unknown 之一。
 
   - **conditions.type** (string)，必需
-    
+
     Deployment 状况的类型。
-  
+
   <!--
   - **conditions.lastTransitionTime** (Time)
 
@@ -352,13 +361,13 @@ DeploymentStatus 是最近观测到的 Deployment 状态。
   -->
 
   - **conditions.lastTransitionTime** (Time)
-    
+
     状况上次从一个状态转换为另一个状态的时间。
-    
+
     <a name="Time"></a>
     **Time 是对 time.Time 的封装。Time 支持对 YAML 和 JSON 进行正确封包。
     为 time 包的许多函数方法提供了封装器。**
-  
+
   <!--
   - **conditions.lastUpdateTime** (Time)
 
@@ -375,7 +384,7 @@ DeploymentStatus 是最近观测到的 Deployment 状态。
     <a name="Time"></a> 
     **Time 是对 time.Time 的封装。Time 支持对 YAML 和 JSON 进行正确封包。
     为 time 包的许多函数方法提供了封装器。**
-  
+
   <!--
   - **conditions.message** (string)
 
@@ -389,7 +398,7 @@ DeploymentStatus 是最近观测到的 Deployment 状态。
   - **conditions.message** (string)
 
     这是一条人类可读的消息，指示有关上次转换的详细信息。
-  
+
   - **conditions.reason** (string)
 
     状况上次转换的原因。
@@ -400,7 +409,7 @@ DeploymentStatus 是最近观测到的 Deployment 状态。
   The generation observed by the deployment controller.
 -->
 - **observedGeneration** (int64)
-  
+
   Deployment 控制器观测到的代数（Generation）。
 
 ## DeploymentList {#DeploymentList}
@@ -426,11 +435,11 @@ DeploymentList 是 Deployment 的列表。
   Items is the list of Deployments.
 -->
 - **metadata** (<a href="{{< ref "../common-definitions/list-meta#ListMeta" >}}">ListMeta</a>)
-  
+
   标准的列表元数据。
 
 - **items** ([]<a href="{{< ref "../workload-resources/deployment-v1#Deployment" >}}">Deployment</a>)，必需
-  
+
   items 是 Deployment 的列表。
 
 <!--
@@ -547,19 +556,19 @@ GET /apis/apps/v1/namespaces/{namespace}/deployments
 #### 参数
 
 - **namespace** (**路径参数**): string，必需
-  
+
   <a href="{{< ref "../common-parameters/common-parameters#namespace" >}}">namespace</a>
 
 - **allowWatchBookmarks** (**查询参数**): boolean
-  
+
   <a href="{{< ref "../common-parameters/common-parameters#allowWatchBookmarks" >}}">allowWatchBookmarks</a>
 
 - **continue** (**查询参数**): string
-  
+
   <a href="{{< ref "../common-parameters/common-parameters#continue" >}}">continue</a>
 
 - **fieldSelector** (**查询参数**): string
-  
+
   <a href="{{< ref "../common-parameters/common-parameters#fieldSelector" >}}">fieldSelector</a>
 
 - **labelSelector** (**查询参数**): string