diff --git a/content/zh-cn/blog/_posts/2022-09-14-pod-has-network-condition.md b/content/zh-cn/blog/_posts/2022-09-14-pod-has-network-condition.md index e952d2b3d7..d1240fc122 100644 --- a/content/zh-cn/blog/_posts/2022-09-14-pod-has-network-condition.md +++ b/content/zh-cn/blog/_posts/2022-09-14-pod-has-network-condition.md @@ -6,7 +6,7 @@ slug: pod-has-network-condition --- @@ -26,7 +26,7 @@ state of a pod from the perspective of pod sandbox creation and network configuration by a container runtime (typically in coordination with CNI plugins). The kubelet starts to pull container images and start individual containers (including init containers) after the status of the `PodHasNetwork` -condition is set to `True`. Metrics collection services that report latency of +condition is set to `"True"`. Metrics collection services that report latency of pod initialization from a cluster infrastructural perspective (i.e. agnostic of per container characteristics like image size or payload) can utilize the `PodHasNetwork` condition to accurately generate Service Level Indicators @@ -37,7 +37,7 @@ repeatedly fail to come up. Kubernetes 1.25 引入了对 kubelet 所管理的新的 Pod 状况 `PodHasNetwork` 的 Alpha 支持, 该状况位于 Pod 的 status 字段中 。对于工作节点,kubelet 将使用 `PodHasNetwork` 状况从容器运行时 (通常与 CNI 插件协作)创建 Pod 沙箱和网络配置的角度准确地了解 Pod 的初始化状态。 -在 `PodHasNetwork` 状况的 status 设置为 `True` 后,kubelet 开始拉取容器镜像并启动独立的容器 +在 `PodHasNetwork` 状况的 status 设置为 `"True"` 后,kubelet 开始拉取容器镜像并启动独立的容器 (包括 Init 容器)。从集群基础设施的角度报告 Pod 初始化延迟的指标采集服务 (无需知道每个容器的镜像大小或有效负载等特征)就可以利用 `PodHasNetwork` 状况来准确生成服务水平指标(Service Level Indicator,SLI)。 @@ -55,31 +55,32 @@ the status field of a pod depending on the presence of init containers in a pod. -如果 Pod 指定了 Init 容器,则 Pod 状态中的 `Initialized` 状况的 status 将不会设置为 `True`, +如果 Pod 指定了 Init 容器,则 Pod 状态中的 `Initialized` 状况的 status 将不会设置为 `"True"`, 直到该 Pod 的所有 Init 容器都成功为止。但是,用户配置的 Init 容器可能会出现错误(有效负载崩溃、无效镜像等), 并且 Pod 中配置的 Init 容器数量可能因工作负载不同而异。 因此,关于 Pod 初始化的集群范围基础设施 SLI 不能依赖于 Pod 的 `Initialized` 状况。 如果 Pod 未指定 Init 容器,则在 Pod 生命周期的早期, -Pod 状态中的 `Initialized` 状况的 status 会被设置为 `True`。 +Pod 状态中的 `Initialized` 状况的 status 会被设置为 `"True"`。 这一设置发生在 kubelet 开始创建 Pod 运行时沙箱及配置网络之前。 因此,即使容器运行时未能成功初始化 Pod 沙箱环境,没有 Init 容器的 -Pod 也会将 `Initialized` 状况的 status 报告为 `True`。 +Pod 也会将 `Initialized` 状况的 status 报告为 `"True"`。 +### 特殊场景 + +如果一个 Pod 指定 `hostNetwork` 为 `"True"`, +系统会根据 Pod 沙箱创建操作是否成功来决定要不要将 `PodHasNetwork` 状况设置为 `"True"`, +设置此状况时会忽略 Pod 沙箱的网络配置状态。这是因为 Pod 的 `hostNetwork` 被设置为 +`"True"` 时 CRI 实现通常会跳过所有 Pod 沙箱网络配置。 + + -请注意,节点代理可以通过监视指定附加网络配置(例如 `k8s.v1.cni.cncf.io/networks`)的 Pod 注解变化, +节点代理可以通过监视指定附加网络配置(例如 `k8s.v1.cni.cncf.io/networks`)的 Pod 注解变化, 来动态地为 Pod 重新配置网络接口。Pod 沙箱被 Kubelet 初始化(结合容器运行时)之后 Pod 网络配置的动态更新不反映在 `PodHasNetwork` 状况中。 @@ -110,14 +127,14 @@ field of a pod, please enable the `PodHasNetworkCondition` feature gate on the kubelet. For a pod whose runtime sandbox has been successfully created and has networking -configured, the kubelet will report the `PodHasNetwork` condition with status set to `True`: +configured, the kubelet will report the `PodHasNetwork` condition with status set to `"True"`: --> ### 试用 Pod 的 `PodHasNetwork` 状况 为了让 kubelet 在 Pod 的 status 字段中报告 `PodHasNetwork` 状况,需在 kubelet 上启用 `PodHasNetworkCondition` 特性门控。 -对于已成功创建运行时沙箱并已配置网络的 Pod,在 status 设置为 `True` 后, +对于已成功创建运行时沙箱并已配置网络的 Pod,在 status 设置为 `"True"` 后, kubelet 将报告 `PodHasNetwork` 状况: ``` @@ -137,9 +154,9 @@ Conditions: -对于尚未创建运行时沙箱(也未配置网络)的 Pod,在 status 设置为 `False` 后, +对于尚未创建运行时沙箱(也未配置网络)的 Pod,在 status 设置为 `"False"` 后, kubelet 将报告 `PodHasNetwork` 状况: ```