[zh] Tidy up and fix links in tasks section (1/10)

2020-08-09 19:17:48 +08:00
parent 664464806c
commit 15845b3223
9 changed files with 635 additions and 1103 deletions
@@ -4,77 +4,54 @@ content_type: task
 ---

 <!-- overview -->
-
-此任务展示如何调试StatefulSet。
-
-
+<!--
+This task shows you how to debug a StatefulSet.
+-->
+此任务展示如何调试 StatefulSet。

 ## {{% heading "prerequisites" %}}

-
-
-* 你需要有一个Kubernetes集群，通过必要的配置使kubectl命令行工具与您的集群进行通信。
-* 你应该有一个运行中的StatefulSet，以便用于调试。
-
-
+<!--
+* You need to have a Kubernetes cluster, and the kubectl command-line tool must be configured to communicate with your cluster.
+* You should have a StatefulSet running that you want to investigate.
+-->
+* 你需要有一个 Kubernetes 集群，已配置好的 kubectl 命令行工具与你的集群进行通信。
+* 你应该有一个运行中的 StatefulSet，以便用于调试。

 <!-- steps -->

-## 调试StatefulSet
+<!--
+## Debugging a StatefulSet

-由于StatefulSet在创建时设置了`app=myapp`标签，列出仅属于该StatefulSet的所有pod时，可以使用以下命令：
+In order to list all the pods which belong to a StatefulSet, which have a label `app=myapp` set on them,
+you can use the following:
+-->
+## 调试 StatefulSet   {#debuggin-a-statefulset}
+
+StatefulSet 在创建 Pod 时为其设置了 `app=myapp` 标签，列出仅属于某 StatefulSet
+的所有 Pod 时，可以使用以下命令：

 ```shell
 kubectl get pods -l app=myapp
 ```

-如果您发现列出的任何Pods长时间处于`Unknown` 或`Terminating`状态，关于如何处理它们的说明任务,请参阅[删除 StatefulSet Pods](/docs/tasks/manage-stateful-set/delete-pods/)。您可以参考[调试 Pods](/docs/user-guide/debugging-pods-and-replication-controllers/#debugging-pods)指南来调试StatefulSet中的各个Pod。
-
-StatefulSets提供调试机制，可以使用注解来暂停所有控制器在Pod上的操作。在任何StatefulSet Pod上设置`pod.alpha.kubernetes.io/initialized`注解为`"false"`将*暂停* StatefulSet的所有操作。暂停时，StatefulSet将不执行任何伸缩操作。一旦调试钩子设置完成后，就可以在StatefulSet pod的容器内执行命令，而不会造成伸缩操作的干扰。您可以通过执行以下命令将注解设置为`"false"`：
-
-```shell
-kubectl annotate pods <pod-name> pod.alpha.kubernetes.io/initialized="false" --overwrite
-```
-
-当注解设置为`"false"`时，StatefulSet在其Pods变得不健康或不可用时将不会响应。StatefulSet不会创建副本Pod直到每个Pod上删除注解或将注解设置为`"true"`。
-
-### 逐步初始化
-
-创建StatefulSet之前，您可以通过使用和上文相同的注解，即将yaml文件中`.spec.template.metadata.annotations`里的`pod.alpha.kubernetes.io/initialized`字段设置为`"false"`，对竞态条件的StatefulSet进行调试。
-
-```yaml
-apiVersion: apps/v1beta1
-kind: StatefulSet
-metadata:
-  name: my-app
-spec:
-  serviceName: "my-app"
-  replicas: 3
-  template:
-    metadata:
-      labels:
-        app: my-app
-      annotations:
-        pod.alpha.kubernetes.io/initialized: "false"
-...
-...
-...
-
-```
-
-设置注解后，如果创建了StatefulSet，您可以等待每个Pod来验证它是否正确初始化。StatefulSet将不会创建任何后续的Pods，直到在已经创建的每个Pod上将调试注解设置为`"true"` (或删除)。 您可以通过执行以下命令将注解设置为`"true"`：
-
-```shell
-kubectl annotate pods <pod-name> pod.alpha.kubernetes.io/initialized="true" --overwrite
-```
-
-
+<!--
+If you find that any Pods listed are in `Unknown` or `Terminating` state for an extended period of time,
+refer to the [Deleting StatefulSet Pods](/docs/tasks/manage-stateful-set/delete-pods/) task for
+instructions on how to deal with them.
+You can debug individual Pods in a StatefulSet using the
+[Debugging Pods](/docs/tasks/debug-application-cluster/debug-pod-replication-controller/) guide.
+-->
+如果你发现列出的任何 Pod 长时间处于 `Unknown` 或 `Terminating` 状态，请参阅
+[删除 StatefulSet Pods](/zh/docs/tasks/manage-stateful-set/delete-pods/)
+了解如何处理它们的说明。
+你可以参考[调试 Pods](/zh/docs/tasks/debug-application-cluster/debug-application/)
+来调试 StatefulSet 中的各个 Pod。

 ## {{% heading "whatsnext" %}}

-
-点击链接[调试init-container](/docs/tasks/troubleshoot/debug-init-containers/)，了解更多信息。
-
-
-
+<!--
+Learn more about [debugging an init-container](/docs/tasks/debug-application-cluster/debug-init-containers/).
+-->
+* 进一步了解如何[调试 Init 容器](/zh/docs/tasks/debug-application-cluster/debug-init-containers/)