Merge pull request #23190 from tengqm/zh-resync-updateds

[zh] Resync update-daemon-set task

content/zh/docs/tasks/manage-daemon/update-daemon-set.md

@@ -1,50 +1,38 @@
 ---
-reviewers:
-- janetkuo
 title: 对 DaemonSet 执行滚动更新
 content_type: task
+weight: 10
 ---
 
 <!--
----
 reviewers:
 - janetkuo
 title: Perform a Rolling Update on a DaemonSet
 content_type: task
----
+-->
---->
 
 <!-- overview -->
-
 <!--
 This page shows how to perform a rolling update on a DaemonSet.
---->
+-->
 本文介绍了如何对 DaemonSet 执行滚动更新。
 
-
-
-
 ## {{% heading "prerequisites" %}}
 
-
 <!--
 * The DaemonSet rolling update feature is only supported in Kubernetes version 1.6 or later.
---->
+-->
 * Kubernetes 1.6 或者更高版本中才支持 DaemonSet 滚动更新功能。
 
-
-
-
 <!-- steps -->
 
 <!--
 ## DaemonSet Update Strategy
---->
+
+DaemonSet has two update strategy types:
+-->
 ## DaemonSet 更新策略
 
-<!--
-DaemonSet has two update strategy types:
---->
 DaemonSet 有两种更新策略：
 
 <!--
@@ -56,282 +44,283 @@ DaemonSet 有两种更新策略：
   With `RollingUpdate` update strategy, after you update a
   DaemonSet template, old DaemonSet pods will be killed, and new DaemonSet pods
   will be created automatically, in a controlled fashion.
---->
+  At most one pod of the DaemonSet will be running on each node during the whole update process.
+-->
 
-* OnDelete:  使用 `OnDelete` 更新策略时，在更新 DaemonSet 模板后，只有当您手动删除老的 DaemonSet pods 之后，新的 DaemonSet pods *才会*被自动创建。跟 Kubernetes 1.6 以前的版本类似。
+* OnDelete:  使用 `OnDelete` 更新策略时，在更新 DaemonSet 模板后，只有当你手动删除老的
-* RollingUpdate: 这是默认的更新策略。使用 `RollingUpdate` 更新策略时，在更新 DaemonSet 模板后，老的 DaemonSet pods 将被终止，并且将以受控方式自动创建新的 DaemonSet pods。
+  DaemonSet pods 之后，新的 DaemonSet Pod *才会*被自动创建。跟 Kubernetes 1.6 以前的版本类似。
+* RollingUpdate: 这是默认的更新策略。使用 `RollingUpdate` 更新策略时，在更新 DaemonSet 模板后，
+  老的 DaemonSet pods 将被终止，并且将以受控方式自动创建新的 DaemonSet pods。
+  更新期间，最多只能有 DaemonSet 的一个 Pod 运行于每个节点上。
 
 <!--
 ## Performing a Rolling Update
---->
-## 执行滚动更新
 
-<!--
 To enable the rolling update feature of a DaemonSet, you must set its
 `.spec.updateStrategy.type` to `RollingUpdate`.
---->
+-->
+## 执行滚动更新
+
 要启用 DaemonSet 的滚动更新功能，必须设置 `.spec.updateStrategy.type` 为 `RollingUpdate`。
 
 <!--
 You may want to set [`.spec.updateStrategy.rollingUpdate.maxUnavailable`](/docs/concepts/workloads/controllers/deployment/#max-unavailable) (default
 to 1) and [`.spec.minReadySeconds`](/docs/concepts/workloads/controllers/deployment/#min-ready-seconds) (default to 0) as well.
---->
+-->
-您可能想设置[`.spec.updateStrategy.rollingUpdate.maxUnavailable`](/docs/concepts/workloads/controllers/deployment/#max-unavailable) (默认为 1) 和[`.spec.minReadySeconds`](/docs/concepts/workloads/controllers/deployment/#min-ready-seconds) (默认为 0)。 
+你可能想设置
+[`.spec.updateStrategy.rollingUpdate.maxUnavailable`](/zh/docs/concepts/workloads/controllers/deployment/#max-unavailable) (默认为 1) 和
+[`.spec.minReadySeconds`](/zh/docs/concepts/workloads/controllers/deployment/#min-ready-seconds) (默认为 0)。 
 
 <!--
-### Step 1: Checking DaemonSet `RollingUpdate` update strategy
+### Creating a DaemonSet with `RollingUpdate` update strategy
---->
+
-### 步骤 1: 检查 DaemonSet 的滚动更新策略
+This YAML file specifies a DaemonSet with an update strategy as 'RollingUpdate'
+-->
+### 创建带有 `RollingUpdate` 更新策略的 DaemonSet
+
+下面的 YAML 包含一个 DaemonSet，其更新策略为 'RollingUpdate'：
+
+{{< codenew file="controllers/fluentd-daemonset.yaml" >}}
 
 <!--
-First, check the update strategy of your DaemonSet, and make sure it's set to
+After verifying the update strategy of the DaemonSet manifest, create the DaemonSet:
+-->
+检查了 DaemonSet 清单中更新策略的设置之后，创建 DaemonSet：
+
+```shell
+kubectl create -f https://k8s.io/examples/controllers/fluentd-daemonset.yaml
+```
+
+<!--
+Alternatively, use `kubectl apply` to create the same DaemonSet if you plan to
+update the DaemonSet with `kubectl apply`.
+-->
+另一种方式是如果你希望使用 `kubectl apply` 来更新 DaemonSet 的话，也可以
+使用 `kubectl apply` 来创建 DaemonSet：
+
+```shell
+kubectl apply -f https://k8s.io/examples/controllers/fluentd-daemonset.yaml
+```
+
+<!--
+### Checking DaemonSet `RollingUpdate` update strategy
+
+Check the update strategy of your DaemonSet, and make sure it's set to
 `RollingUpdate`:
---->
+-->
+### 检查 DaemonSet 的滚动更新策略
+
 首先，检查 DaemonSet 的更新策略，确保已经将其设置为 `RollingUpdate`:
 
 ```shell
-kubectl get ds/<daemonset-name> -o go-template='{{.spec.updateStrategy.type}}{{"\n"}}'
+kubectl get ds/fluentd-elasticsearch -o go-template='{{.spec.updateStrategy.type}}{{"\n"}}' -n kube-system
 ```
 
 <!--
 If you haven't created the DaemonSet in the system, check your DaemonSet
 manifest with the following command instead:
---->
+-->
 如果还没在系统中创建 DaemonSet，请使用以下命令检查 DaemonSet 的清单：
 
 ```shell
-kubectl create -f ds.yaml --dry-run -o go-template='{{.spec.updateStrategy.type}}{{"\n"}}'
+kubectl apply -f https://k8s.io/examples/controllers/fluentd-daemonset.yaml --dry-run=client -o go-template='{{.spec.updateStrategy.type}}{{"\n"}}'
 ```
+
 <!--
 The output from both commands should be:
---->
+-->
 两个命令的输出都应该为：
 
-```shell
+```
 RollingUpdate
 ```
 
 <!--
 If the output isn't `RollingUpdate`, go back and modify the DaemonSet object or
 manifest accordingly.
---->
+-->
 如果输出不是 `RollingUpdate`，请返回并相应地修改 DaemonSet 对象或者清单。
 
 <!--
-### Step 2: Creating a DaemonSet with `RollingUpdate` update strategy
+### Updating a DaemonSet template
---->
-### 步骤 2：使用 `RollingUpdate` 更新策略创建 DaemonSet
 
-<!--
-If you have already created the DaemonSet, you may skip this step and jump to
-step 3.
---->
-如果已经创建了 DaemonSet，则可以跳过该步骤并跳转到步骤 3。
-
-<!--
-After verifying the update strategy of the DaemonSet manifest, create the DaemonSet:
---->
-验证 DaemonSet 清单的更新策略后，创建 DaemonSet：
-
-```shell
-kubectl create -f ds.yaml
-```
-
-<!--
-Alternatively, use `kubectl apply` to create the same DaemonSet if you plan to
-update the DaemonSet with `kubectl apply`.
---->
-或者，您打算使用 `kubectl apply` 更新 DaemonSet，请使用 `kubectl apply` 创建相同的 DaemonSet。
-
-```shell
-kubectl apply -f ds.yaml
-```
-
-<!--
-### Step 3: Updating a DaemonSet template
---->
-### 步骤 3：更新 DaemonSet 模板
-
-<!--
 Any updates to a `RollingUpdate` DaemonSet `.spec.template` will trigger a rolling
-update. This can be done with several different `kubectl` commands.
+update. Let's update the DaemonSet by applying a new YAML file. This can be done with several different `kubectl` commands.
---->
+-->
-对 `RollingUpdate` DaemonSet `.spec.template` 的任何更新都将触发滚动更新。这可以通过几个不同的 `kubectl` 命令来完成。
+### 更新 DaemonSet 模板
+
+对 `RollingUpdate` DaemonSet 的 `.spec.template` 的任何更新都将触发滚动更新。
+这可以通过几个不同的 `kubectl` 命令来完成。
+
+{{< codenew file="controllers/fluentd-daemonset-update.yaml" >}}
 
 <!--
 #### Declarative commands
---->
+
+If you update DaemonSets using
+[configuration files](/docs/tasks/manage-kubernetes-objects/declarative-config/),
+use `kubectl apply`:
+-->
 #### 声明式命令
 
-<!--
+如果你使用
-If you update DaemonSets using
+[配置文件](/zh/docs/tasks/manage-kubernetes-objects/declarative-config/)
-[configuration files](/docs/concepts/overview/object-management-kubectl/declarative-config/),
+来更新 DaemonSet，请使用 `kubectl apply`:
-use `kubectl apply`:
---->
-如果您使用[配置文件](/docs/concepts/overview/object-management-kubectl/declarative-config/)来更新 DaemonSets，请使用 `kubectl apply`:
 
 ```shell
-kubectl apply -f ds-v2.yaml
+kubectl apply -f https://k8s.io/examples/controllers/fluentd-daemonset-update.yaml
 ```
 
 <!--
 #### Imperative commands
---->
-#### 命令式命令
 
-<!--
 If you update DaemonSets using
 [imperative commands](/docs/concepts/overview/object-management-kubectl/imperative-command/),
-use `kubectl edit` or `kubectl patch`:
+use `kubectl edit`:
---->
+-->
-如果您使用[命令式命令](/docs/concepts/overview/object-management-kubectl/imperative-command/)来更新 DaemonSets，请使用`kubectl edit` 或者 `kubectl patch`:
+#### 指令式命令
+
+如果你使用
+[指令式命令](/zh/docs/tasks/manage-kubernetes-objects/imperative-command/)
+来更新 DaemonSets，请使用`kubectl edit`：
 
 ```shell
-kubectl edit ds/<daemonset-name>
+kubectl edit ds/fluentd-elasticsearch -n kube-system
-```
-
-```shell
-kubectl patch ds/<daemonset-name> -p=<strategic-merge-patch>
 ```
 
 <!--
 ##### Updating only the container image
---->
-##### 只更新容器镜像
 
-<!--
 If you just need to update the container image in the DaemonSet template, i.e.
 `.spec.template.spec.containers[*].image`, use `kubectl set image`:
 --->
-如果您只需要更新 DaemonSet 模板里的容器镜像，比如，`.spec.template.spec.containers[*].image`, 请使用 `kubectl set image`:
+##### 只更新容器镜像
+
+如果你只需要更新 DaemonSet 模板里的容器镜像，比如，`.spec.template.spec.containers[*].image`, 
+请使用 `kubectl set image`:
 
 ```shell
-kubectl set image ds/<daemonset-name> <container-name>=<container-new-image>
+kubectl set image ds/fluentd-elasticsearch fluentd-elasticsearch=quay.io/fluentd_elasticsearch/fluentd:v2.6.0 -n kube-system
 ```
 
 <!--
 ### Step 4: Watching the rolling update status
---->
-### 步骤 4：查看滚动更新状态
 
-<!--
 Finally, watch the rollout status of the latest DaemonSet rolling update:
---->
+-->
+### 监视滚动更新状态
+
 最后，观察 DaemonSet 最新滚动更新的进度：
 
 ```shell
-kubectl rollout status ds/<daemonset-name>
+kubectl rollout status ds/fluentd-elasticsearch -n kube-system
 ```
 
 <!--
 When the rollout is complete, the output is similar to this:
---->
+-->
 当滚动更新完成时，输出结果如下：
 
-```shell
+```
-daemonset "<daemonset-name>" successfully rolled out
+daemonset "fluentd-elasticsearch" successfully rolled out
 ```
 
 <!--
 ## Troubleshooting
---->
+
+### DaemonSet rolling update is stuck
+-->
 ## 故障排查
 
-<!--
-### DaemonSet rolling update is stuck
---->
 ### DaemonSet 滚动更新卡住
 
-<!--
-Sometimes, a DaemonSet rolling update may be stuck. Here are some possible
-causes:
---->
-有时，DaemonSet 滚动更新可能会卡住。可能原因如下：
-
-<!--
-#### Some nodes run out of resources
---->
-#### 一些节点资源用尽
-
 <!--
 The rollout is stuck because new DaemonSet pods can't be scheduled on at least one
 node. This is possible when the node is
 [running out of resources](/docs/tasks/administer-cluster/out-of-resource/).
---->
-由于新 DaemonSet pods 无法调度到至少一个节点时，滚动更新就会卡住。这可能是由于节点已经[资源用尽](/docs/tasks/administer-cluster/out-of-resource/)。
 
-<!--
 When this happens, find the nodes that don't have the DaemonSet pods scheduled on
 by comparing the output of `kubectl get nodes` and the output of:
---->
+-->
-发生这种情况时，通过对 `kubectl get nodes` 和下面命令行的输出作比较，找出没有调度部署 DaemonSet pods 的节点：
+有时，DaemonSet 滚动更新可能会卡住，其 Pod 至少在某个节点上无法调度运行。
+当节点上[可用资源耗尽](/zh/docs/tasks/administer-cluster/out-of-resource/)时，
+这是可能的。
+
+发生这种情况时，通过对 `kubectl get nodes` 和下面命令行的输出作比较，
+找出没有调度部署 DaemonSet Pods 的节点：
 
 ```shell
-kubectl get pods -l <daemonset-selector-key>=<daemonset-selector-value> -o wide
+kubectl get pods -l name=fluentd-elasticsearch -o wide -n kube-system
 ```
 
 <!--
 Once you've found those nodes, delete some non-DaemonSet pods from the node to
 make room for new DaemonSet pods.
---->
+-->
-一旦找到这些节点，从节点上删除一些非 DaemonSet pods，为新的 DaemonSet pods 腾出空间。
+一旦找到这些节点，从节点上删除一些非 DaemonSet Pod，为新的 DaemonSet Pod 腾出空间。
 
 <!--
-{{< note >}}
 This will cause service disruption when deleted pods are not controlled by any controllers or pods are not
 replicated. This does not respect [PodDisruptionBudget](/docs/tasks/configure-pod-container/configure-pod-disruption-budget/)
 either.
-{{< /note >}}
+-->
---->
 {{< note >}}
-当所删除的 pods 不受任何控制器管理，也不是多副本的 pods，上述操作将导致服务中断。
+当所删除的 Pod 不受任何控制器管理，也不是多副本的 Pod时，上述操作将导致服务中断。
-同时，上述操作也不会考虑 [PodDisruptionBudget](/docs/tasks/configure-pod-container/configure-pod-disruption-budget/) 所施加的约束。
+同时，上述操作也不会考虑
+[PodDisruptionBudget](/zh/docs/tasks/configure-pod-container/configure-pod-disruption-budget/)
+所施加的约束。
 {{< /note >}}
 
 <!--
 #### Broken rollout
---->
 
-#### 滚动更新中断
-
-
-<!--
 If the recent DaemonSet template update is broken, for example, the container is
 crash looping, or the container image doesn't exist (often due to a typo),
 DaemonSet rollout won't progress.
---->
+-->
-如果最近的 DaemonSet 模板更新被破坏了，比如，容器处于崩溃循环状态或者容器镜像不存在(通常由于拼写错误)，就会发生 DaemonSet 滚动更新中断。
+#### 不完整的滚动更新
+
+如果最近的 DaemonSet 模板更新被破坏了，比如，容器处于崩溃循环状态或者容器镜像不存在
+（通常由于拼写错误），就会发生 DaemonSet 滚动更新中断。
 
 <!--
 To fix this, just update the DaemonSet template again. New rollout won't be
 blocked by previous unhealthy rollouts.
---->
+-->
 要解决此问题，只需再次更新 DaemonSet 模板即可。以前不健康的滚动更新不会阻止新的滚动更新。
 
 <!--
 #### Clock skew
---->
-#### 时钟偏差
 
-<!--
 If `.spec.minReadySeconds` is specified in the DaemonSet, clock skew between
 master and nodes will make DaemonSet unable to detect the right rollout
 progress.
---->
+-->
-如果在 DaemonSet 中指定了 `.spec.minReadySeconds`，主节点和工作节点之间的时钟偏差会使 DaemonSet 无法检测到正确的滚动更新进度。
+#### 时钟偏差
 
+如果在 DaemonSet 中指定了 `.spec.minReadySeconds`，主控节点和工作节点之间的时钟偏差会使
+DaemonSet 无法检测到正确的滚动更新进度。
 
+<!--
+## Clean up
 
+Delete DaemonSet from a namespace :
+-->
+## 清理
+
+从名字空间中删除 DaemonSet：
+
+```shell
+kubectl delete ds fluentd-elasticsearch -n kube-system
+```
 
 ## {{% heading "whatsnext" %}}
 
-
 <!--
 * See [Task: Performing a rollback on a
   DaemonSet](/docs/tasks/manage-daemon/rollback-daemon-set/)
 * See [Concepts: Creating a DaemonSet to adopt existing DaemonSet pods](/docs/concepts/workloads/controllers/daemonset/)
---->
+-->
-* 查看[任务: 在 DaemonSet 上执行回滚](/docs/tasks/manage-daemon/rollback-daemon-set/)
+* 查看[任务：在 DaemonSet 上执行回滚](/zh/docs/tasks/manage-daemon/rollback-daemon-set/)
-* 查看[概念: 创建 DaemonSet 以适应现有的 DaemonSet pods](/docs/concepts/workloads/controllers/daemonset/)
+* 查看[概念：创建 DaemonSet 以收养现有 DaemonSet Pod](/zh/docs/concepts/workloads/controllers/daemonset/)
-