Skip to content

Commit 75ee2c9

Browse files
committed
[zh-cn] sync debug-pods.md
1 parent 74b603b commit 75ee2c9

File tree

1 file changed

+54
-0
lines changed

1 file changed

+54
-0
lines changed

content/zh-cn/docs/tasks/debug/debug-application/debug-pods.md

Lines changed: 54 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -127,6 +127,60 @@ There are three things to check:
127127
* 确保镜像已被推送到镜像仓库。
128128
* 尝试手动是否能拉取镜像。例如,如果你在你的 PC 上使用 Docker,请运行 `docker pull <镜像>`
129129

130+
<!--
131+
#### My pod stays terminating
132+
133+
If a Pod is stuck in the `Terminating` state, it means that a deletion has been
134+
issued for the Pod, but the control plane is unable to delete the Pod object.
135+
136+
This typically happens if the Pod has a [finalizer](/docs/concepts/overview/working-with-objects/finalizers/)
137+
and there is an [admission webhook](/docs/reference/access-authn-authz/extensible-admission-controllers/)
138+
installed in the cluster that prevents the control plane from removing the
139+
finalizer.
140+
-->
141+
#### Pod 停滞在 terminating 状态 {#my-pod-stays-terminating}
142+
143+
如果 Pod 停滞在 `Terminating` 状态,表示已发出删除 Pod 的请求,
144+
但控制平面无法删除该 Pod 对象。
145+
146+
如果 Pod 拥有 [Finalizer](/zh-cn/docs/concepts/overview/working-with-objects/finalizers/)
147+
并且集群中安装了[准入 Webhook](/zh-cn/docs/reference/access-authn-authz/extensible-admission-controllers/)
148+
可能会导致控制平面无法移除 Finalizer,从而导致 Pod 出现此问题。
149+
150+
<!--
151+
To identify this scenario, check if your cluster has any
152+
ValidatingWebhookConfiguration or MutatingWebhookConfiguration that target
153+
`UPDATE` operations for `pods` resources.
154+
155+
If the webhook is provided by a third-party:
156+
- Make sure you are using the latest version.
157+
- Disable the webhook for `UPDATE` operations.
158+
- Report an issue with the corresponding provider.
159+
-->
160+
要确认这种情况,请检查你的集群中是否有针对 `pods` 资源进行 `UPDATE`
161+
操作的 ValidatingWebhookConfiguration 或 MutatingWebhookConfiguration。
162+
163+
如果 Webhook 是由第三方提供的:
164+
- 确保你使用的是最新版。
165+
- 禁用 `UPDATE` 操作的 Webhook。
166+
- 向相关供应商报告问题。
167+
168+
<!--
169+
If you are the author of the webhook:
170+
- For a mutating webhook, make sure it never changes immutable fields on
171+
`UPDATE` operations. For example, changes to containers are usually not allowed.
172+
- For a validating webhook, make sure that your validation policies only apply
173+
to new changes. In other words, you should allow Pods with existing violations
174+
to pass validation. This allows Pods that were created before the validating
175+
webhook was installed to continue running.
176+
-->
177+
如果你是 Webhook 的作者:
178+
- 对于变更性质的 Webhook,请确保在 `UPDATE` 操作中永远不要更改不可变字段。
179+
例如,一般不允许更改容器。
180+
- 对于验证性质的 Webhook,请确保你的验证策略仅适用于新的更改。换句话说,
181+
你应该允许存在违规的现有 Pod 通过验证。这样可以确保在安装验证性质的 Webhook
182+
之前创建的 Pod 可以继续运行。
183+
130184
<!--
131185
#### My pod is crashing or otherwise unhealthy
132186

0 commit comments

Comments
 (0)