[zh] Tidy up and fix links in tasks section (5/10)
This commit is contained in:
@@ -4,11 +4,9 @@ content_type: task
|
||||
weight: 140
|
||||
---
|
||||
<!--
|
||||
---
|
||||
title: Attach Handlers to Container Lifecycle Events
|
||||
content_type: task
|
||||
weight: 140
|
||||
---
|
||||
-->
|
||||
|
||||
<!-- overview -->
|
||||
@@ -23,33 +21,26 @@ Container is terminated.
|
||||
当一个容器启动后,Kubernetes 将立即发送 postStart 事件;在容器被终结之前,
|
||||
Kubernetes 将发送一个 preStop 事件。
|
||||
|
||||
|
||||
|
||||
|
||||
## {{% heading "prerequisites" %}}
|
||||
|
||||
|
||||
{{< include "task-tutorial-prereqs.md" >}} {{< version-check >}}
|
||||
|
||||
|
||||
|
||||
<!-- steps -->
|
||||
|
||||
<!--
|
||||
## Define postStart and preStop handlers
|
||||
-->
|
||||
## 定义 postStart 和 preStop 处理函数
|
||||
|
||||
<!--
|
||||
In this exercise, you create a Pod that has one Container. The Container has handlers
|
||||
for the postStart and preStop events.
|
||||
-->
|
||||
## 定义 postStart 和 preStop 处理函数
|
||||
|
||||
在本练习中,你将创建一个包含一个容器的 Pod,该容器为 postStart 和 preStop 事件提供对应的处理函数。
|
||||
|
||||
<!--
|
||||
Here is the configuration file for the Pod:
|
||||
-->
|
||||
下面是对应 Pod 的配置文件
|
||||
下面是对应 Pod 的配置文件:
|
||||
|
||||
{{< codenew file="pods/lifecycle-events.yaml" >}}
|
||||
|
||||
@@ -59,55 +50,58 @@ file to the Container's `/usr/share` directory. The preStop command shuts down
|
||||
nginx gracefully. This is helpful if the Container is being terminated because of a failure.
|
||||
-->
|
||||
在上述配置文件中,你可以看到 postStart 命令在容器的 `/usr/share` 目录下写入文件 `message`。
|
||||
命令 preStop 负责优雅地终止 nginx 服务。当因为失效而导致容器终止时,这一处理方式很有用。```
|
||||
命令 preStop 负责优雅地终止 nginx 服务。当因为失效而导致容器终止时,这一处理方式很有用。
|
||||
|
||||
<!--
|
||||
Create the Pod:
|
||||
-->
|
||||
创建 Pod:
|
||||
|
||||
kubectl apply -f https://k8s.io/examples/pods/lifecycle-events.yaml
|
||||
```shell
|
||||
kubectl apply -f https://k8s.io/examples/pods/lifecycle-events.yaml
|
||||
```
|
||||
|
||||
<!--
|
||||
Verify that the Container in the Pod is running:
|
||||
-->
|
||||
验证 Pod 中的容器已经运行:
|
||||
|
||||
kubectl get pod lifecycle-demo
|
||||
```shell
|
||||
kubectl get pod lifecycle-demo
|
||||
```
|
||||
|
||||
<!--
|
||||
Get a shell into the Container running in your Pod:
|
||||
-->
|
||||
使用 shell 连接到你的 Pod 里的容器:
|
||||
|
||||
kubectl exec -it lifecycle-demo -- /bin/bash
|
||||
```
|
||||
kubectl exec -it lifecycle-demo -- /bin/bash
|
||||
```
|
||||
|
||||
<!--
|
||||
In your shell, verify that the `postStart` handler created the `message` file:
|
||||
-->
|
||||
在 shell 中,验证 `postStart` 处理函数创建了 `message` 文件:
|
||||
|
||||
root@lifecycle-demo:/# cat /usr/share/message
|
||||
```
|
||||
root@lifecycle-demo:/# cat /usr/share/message
|
||||
```
|
||||
|
||||
<!--
|
||||
The output shows the text written by the postStart handler:
|
||||
-->
|
||||
命令行输出的是 `postStart` 处理函数所写入的文本
|
||||
|
||||
Hello from the postStart handler
|
||||
|
||||
|
||||
|
||||
|
||||
```
|
||||
Hello from the postStart handler
|
||||
```
|
||||
|
||||
<!-- discussion -->
|
||||
|
||||
<!--
|
||||
## Discussion
|
||||
-->
|
||||
## 讨论
|
||||
|
||||
<!--
|
||||
Kubernetes sends the postStart event immediately after the Container is created.
|
||||
There is no guarantee, however, that the postStart handler is called before
|
||||
the Container's entrypoint is called. The postStart handler runs asynchronously
|
||||
@@ -115,9 +109,13 @@ relative to the Container's code, but Kubernetes' management of the container
|
||||
blocks until the postStart handler completes. The Container's status is not
|
||||
set to RUNNING until the postStart handler completes.
|
||||
-->
|
||||
Kubernetes 在容器创建后立即发送 postStart 事件。然而,postStart 处理函数的调用不保证早于容器的入口点(entrypoint)
|
||||
## 讨论
|
||||
|
||||
Kubernetes 在容器创建后立即发送 postStart 事件。
|
||||
然而,postStart 处理函数的调用不保证早于容器的入口点(entrypoint)
|
||||
的执行。postStart 处理函数与容器的代码是异步执行的,但 Kubernetes
|
||||
的容器管理逻辑会一直阻塞等待 postStart 处理函数执行完毕。只有 postStart 处理函数执行完毕,容器的状态才会变成
|
||||
的容器管理逻辑会一直阻塞等待 postStart 处理函数执行完毕。
|
||||
只有 postStart 处理函数执行完毕,容器的状态才会变成
|
||||
RUNNING。
|
||||
|
||||
<!--
|
||||
@@ -128,34 +126,28 @@ unless the Pod's grace period expires. For more details, see
|
||||
-->
|
||||
Kubernetes 在容器结束前立即发送 preStop 事件。除非 Pod 宽限期限超时,Kubernetes 的容器管理逻辑
|
||||
会一直阻塞等待 preStop 处理函数执行完毕。更多的相关细节,可以参阅
|
||||
[Pods 的结束](/docs/user-guide/pods/#termination-of-pods)。
|
||||
[Pods 的结束](/zh/docs/concepts/workloads/pods/pod-lifecycle/#pod-termination)。
|
||||
|
||||
<!--
|
||||
{{< note >}}
|
||||
Kubernetes only sends the preStop event when a Pod is *terminated*.
|
||||
This means that the preStop hook is not invoked when the Pod is *completed*.
|
||||
This limitation is tracked in [issue #55087](https://github.com/kubernetes/kubernetes/issues/55807).
|
||||
{{< /note >}}
|
||||
-->
|
||||
{{< note >}}
|
||||
Kubernetes 只有在 Pod *结束(Terminated)* 的时候才会发送 preStop 事件,这意味着在 Pod *完成(Completed)* 时
|
||||
Kubernetes 只有在 Pod *结束(Terminated)* 的时候才会发送 preStop 事件,
|
||||
这意味着在 Pod *完成(Completed)* 时
|
||||
preStop 的事件处理逻辑不会被触发。这个限制在
|
||||
[issue #55087](https://github.com/kubernetes/kubernetes/issues/55807) 中被追踪。
|
||||
{{< /note >}}
|
||||
|
||||
|
||||
|
||||
|
||||
## {{% heading "whatsnext" %}}
|
||||
|
||||
|
||||
<!--
|
||||
* Learn more about [Container lifecycle hooks](/docs/concepts/containers/container-lifecycle-hooks/).
|
||||
* Learn more about the [lifecycle of a Pod](/docs/concepts/workloads/pods/pod-lifecycle/).
|
||||
-->
|
||||
* 进一步了解[容器生命周期回调](/docs/concepts/containers/container-lifecycle-hooks/)。
|
||||
* 进一步了解[Pod 的生命周期](/docs/concepts/workloads/pods/pod-lifecycle/)。
|
||||
|
||||
* 进一步了解[容器生命周期回调](/zh/docs/concepts/containers/container-lifecycle-hooks/)。
|
||||
* 进一步了解[Pod 的生命周期](/zh/docs/concepts/workloads/pods/pod-lifecycle/)。
|
||||
|
||||
<!--
|
||||
### Reference
|
||||
@@ -170,6 +162,3 @@ preStop 的事件处理逻辑不会被触发。这个限制在
|
||||
* [Container](/docs/reference/generated/kubernetes-api/{{< param "version" >}}/#container-v1-core)
|
||||
* 参阅 [PodSpec](/docs/reference/generated/kubernetes-api/{{< param "version" >}}/#podspec-v1-core) 中关于`terminationGracePeriodSeconds` 的部分
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
Reference in New Issue
Block a user