Merge pull request #23190 from tengqm/zh-resync-updateds
[zh] Resync update-daemon-set task
This commit is contained in:
Kubernetes Prow Robot
GitHub
commit
dc5d9d1a9c
|
|
@ -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 以前的版本类似。
|
||||
* RollingUpdate: 这是默认的更新策略。使用 `RollingUpdate` 更新策略时，在更新 DaemonSet 模板后，老的 DaemonSet pods 将被终止，并且将以受控方式自动创建新的 DaemonSet pods。
|
||||
* OnDelete: 使用 `OnDelete` 更新策略时，在更新 DaemonSet 模板后，只有当你手动删除老的
|
||||
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
|
||||
--->
|
||||
### 步骤 1: 检查 DaemonSet 的滚动更新策略
|
||||
### Creating a DaemonSet with `RollingUpdate` update strategy
|
||||
|
||||
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
|
||||
--->
|
||||
### 步骤 2：使用 `RollingUpdate` 更新策略创建 DaemonSet
|
||||
### Updating a DaemonSet template
|
||||
|
||||
<!--
|
||||
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.
|
||||
--->
|
||||
对 `RollingUpdate` DaemonSet `.spec.template` 的任何更新都将触发滚动更新。这可以通过几个不同的 `kubectl` 命令来完成。
|
||||
update. Let's update the DaemonSet by applying a new YAML file. This can be done with several different `kubectl` commands.
|
||||
-->
|
||||
### 更新 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
|
||||
[configuration files](/docs/concepts/overview/object-management-kubectl/declarative-config/),
|
||||
use `kubectl apply`:
|
||||
--->
|
||||
如果您使用[配置文件](/docs/concepts/overview/object-management-kubectl/declarative-config/)来更新 DaemonSets，请使用 `kubectl apply`:
|
||||
如果你使用
|
||||
[配置文件](/zh/docs/tasks/manage-kubernetes-objects/declarative-config/)
|
||||
来更新 DaemonSet，请使用 `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`:
|
||||
--->
|
||||
如果您使用[命令式命令](/docs/concepts/overview/object-management-kubectl/imperative-command/)来更新 DaemonSets，请使用`kubectl edit` 或者 `kubectl patch`:
|
||||
use `kubectl edit`:
|
||||
-->
|
||||
#### 指令式命令
|
||||
|
||||
如果你使用
|
||||
[指令式命令](/zh/docs/tasks/manage-kubernetes-objects/imperative-command/)
|
||||
来更新 DaemonSets，请使用`kubectl edit`：
|
||||
|
||||
```shell
|
||||
kubectl edit ds/<daemonset-name>
|
||||
```
|
||||
|
||||
```shell
|
||||
kubectl patch ds/<daemonset-name> -p=<strategic-merge-patch>
|
||||
kubectl edit ds/fluentd-elasticsearch -n kube-system
|
||||
```
|
||||
|
||||
<!--
|
||||
##### 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，上述操作将导致服务中断。
|
||||
同时，上述操作也不会考虑 [PodDisruptionBudget](/docs/tasks/configure-pod-container/configure-pod-disruption-budget/) 所施加的约束。
|
||||
当所删除的 Pod 不受任何控制器管理，也不是多副本的 Pod时，上述操作将导致服务中断。
|
||||
同时，上述操作也不会考虑
|
||||
[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 以适应现有的 DaemonSet pods](/docs/concepts/workloads/controllers/daemonset/)
|
||||
|
||||
-->
|
||||
* 查看[任务：在 DaemonSet 上执行回滚](/zh/docs/tasks/manage-daemon/rollback-daemon-set/)
|
||||
* 查看[概念：创建 DaemonSet 以收养现有 DaemonSet Pod](/zh/docs/concepts/workloads/controllers/daemonset/)
|
||||
|
||||
|
|
|
|||
Loading…
Reference in New Issue