From ba2dc02c77dc93a26d1202fff114ff3d3aa9286f Mon Sep 17 00:00:00 2001
From: Jinhua Tan <312841925@qq.com>
Date: Thu, 6 Jun 2019 13:28:10 +0800
Subject: [PATCH] Translate
 docs/tasks/configure-pod-container/attach-handler-lifecycle-event in Chinese
 (#14605)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* Add zh/docs/tasks/configure-pod-container/attach-handler-lifecycle-event.md
Add zh/examples/pods/lifecycle-events.yaml

Translate zh/includes/task-tutorial-prereqs.md to chinese

* Apply suggestions from code review

Thanks for tengqm's review

Co-Authored-By: Qiming <tengqim@cn.ibm.com>

* Apply suggestions from code review

Thanks for tengqm's help again

Co-Authored-By: Qiming <tengqim@cn.ibm.com>

* Modify the order of text in markdown format

* Unified translation into 处理函数
---
 .../attach-handler-lifecycle-event.md         | 174 ++++++++++++++++++
 .../zh/examples/pods/lifecycle-events.yaml    |  16 ++
 content/zh/includes/task-tutorial-prereqs.md  |   5 +
 3 files changed, 195 insertions(+)
 create mode 100644 content/zh/docs/tasks/configure-pod-container/attach-handler-lifecycle-event.md
 create mode 100644 content/zh/examples/pods/lifecycle-events.yaml

diff --git a/content/zh/docs/tasks/configure-pod-container/attach-handler-lifecycle-event.md b/content/zh/docs/tasks/configure-pod-container/attach-handler-lifecycle-event.md
new file mode 100644
index 0000000000..746c123a3d
--- /dev/null
+++ b/content/zh/docs/tasks/configure-pod-container/attach-handler-lifecycle-event.md
@@ -0,0 +1,174 @@
+---
+title: 为容器的生命周期事件设置处理函数
+content_template: templates/task
+weight: 140
+---
+<!--
+---
+title: Attach Handlers to Container Lifecycle Events
+content_template: templates/task
+weight: 140
+---
+-->
+
+{{% capture overview %}}
+
+<!--
+This page shows how to attach handlers to Container lifecycle events. Kubernetes supports
+the postStart and preStop events. Kubernetes sends the postStart event immediately
+after a Container is started, and it sends the preStop event immediately before the
+Container is terminated.
+-->
+这个页面将演示如何为容器的生命周期事件挂接处理函数。Kubernetes 支持 postStart 和 preStop 事件。
+当一个容器启动后，Kubernetes 将立即发送 postStart 事件；在容器被终结之前，
+Kubernetes 将发送一个 preStop 事件。
+
+{{% /capture %}}
+
+
+{{% capture prerequisites %}}
+
+{{< include "task-tutorial-prereqs.md" >}} {{< version-check >}}
+
+{{% /capture %}}
+
+
+{{% capture 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.
+-->
+在本练习中，你将创建一个包含一个容器的 Pod，该容器为 postStart 和 preStop 事件提供对应的处理函数。 
+
+<!--
+Here is the configuration file for the Pod:
+-->
+下面是对应 Pod 的配置文件
+
+{{< codenew file="pods/lifecycle-events.yaml" >}}
+
+<!--
+In the configuration file, you can see that the postStart command writes a `message`
+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 服务。当因为失效而导致容器终止时，这一处理方式很有用。```
+
+<!--
+Create the Pod:
+-->
+创建 Pod：
+
+    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
+
+<!--
+Get a shell into the Container running in your Pod:
+-->
+使用 shell 连接到你的 Pod 里的容器：
+
+    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
+
+<!--
+The output shows the text written by the postStart handler:
+-->
+命令行输出的是 `postStart` 处理函数所写入的文本
+
+    Hello from the postStart handler
+
+{{% /capture %}}
+
+
+
+{{% capture 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
+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）
+的执行。postStart 处理函数与容器的代码是异步执行的，但 Kubernetes
+的容器管理逻辑会一直阻塞等待 postStart 处理函数执行完毕。只有 postStart 处理函数执行完毕，容器的状态才会变成
+RUNNING。
+
+<!--
+Kubernetes sends the preStop event immediately before the Container is terminated.
+Kubernetes' management of the Container blocks until the preStop handler completes,
+unless the Pod's grace period expires. For more details, see
+[Termination of Pods](/docs/user-guide/pods/#termination-of-pods).
+-->
+Kubernetes 在容器结束前立即发送 preStop 事件。除非 Pod 宽限期限超时，Kubernetes 的容器管理逻辑
+会一直阻塞等待 preStop 处理函数执行完毕。更多的相关细节，可以参阅
+[Pods 的结束](/docs/user-guide/pods/#termination-of-pods)。
+
+<!--
+{{< 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）* 时
+preStop 的事件处理逻辑不会被触发。这个限制在
+[issue #55087](https://github.com/kubernetes/kubernetes/issues/55807) 中被追踪。
+{{< /note >}}
+
+{{% /capture %}}
+
+
+{{% capture 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/)。
+
+
+<!--
+### Reference
+
+* [Lifecycle](/docs/reference/generated/kubernetes-api/{{< param "version" >}}/#lifecycle-v1-core)
+* [Container](/docs/reference/generated/kubernetes-api/{{< param "version" >}}/#container-v1-core)
+* See `terminationGracePeriodSeconds` in [PodSpec](/docs/reference/generated/kubernetes-api/{{< param "version" >}}/#podspec-v1-core)
+-->
+### 参考
+
+* [Lifecycle](/docs/reference/generated/kubernetes-api/{{< param "version" >}}/#lifecycle-v1-core)
+* [Container](/docs/reference/generated/kubernetes-api/{{< param "version" >}}/#container-v1-core)
+* 参阅 [PodSpec](/docs/reference/generated/kubernetes-api/{{< param "version" >}}/#podspec-v1-core) 中关于`terminationGracePeriodSeconds` 的部分
+
+{{% /capture %}}
+
+
diff --git a/content/zh/examples/pods/lifecycle-events.yaml b/content/zh/examples/pods/lifecycle-events.yaml
new file mode 100644
index 0000000000..4b79d7289c
--- /dev/null
+++ b/content/zh/examples/pods/lifecycle-events.yaml
@@ -0,0 +1,16 @@
+apiVersion: v1
+kind: Pod
+metadata:
+  name: lifecycle-demo
+spec:
+  containers:
+  - name: lifecycle-demo-container
+    image: nginx
+    lifecycle:
+      postStart:
+        exec:
+          command: ["/bin/sh", "-c", "echo Hello from the postStart handler > /usr/share/message"]
+      preStop:
+        exec:
+          command: ["/bin/sh","-c","nginx -s quit; while killall -0 nginx; do sleep 1; done"]
+
diff --git a/content/zh/includes/task-tutorial-prereqs.md b/content/zh/includes/task-tutorial-prereqs.md
index 6f1407fe45..a9de9e7844 100644
--- a/content/zh/includes/task-tutorial-prereqs.md
+++ b/content/zh/includes/task-tutorial-prereqs.md
@@ -1,8 +1,13 @@
+你必须拥有一个 Kubernetes 的集群，同时你的 Kubernetes 集群必须带有 kubectl 命令行工具。
+如果你还没有集群，你可以通过 [Minikube](/docs/getting-started-guides/minikube) 构建一
+个你自己的集群，或者你可以使用下面任意一个 Kubernetes 工具构建：
+<!--
 You need to have a Kubernetes cluster, and the kubectl command-line tool must
 be configured to communicate with your cluster. If you do not already have a
 cluster, you can create one by using
 [Minikube](/docs/getting-started-guides/minikube),
 or you can use one of these Kubernetes playgrounds:
+-->
 
 * [Katacoda](https://www.katacoda.com/courses/kubernetes/playground)
 * [Play with Kubernetes](http://labs.play-with-k8s.com/)