diff --git a/content/zh/docs/reference/kubernetes-api/common-definitions/list-meta.md b/content/zh/docs/reference/kubernetes-api/common-definitions/list-meta.md index a4779fcd4d..2b4169c3e3 100644 --- a/content/zh/docs/reference/kubernetes-api/common-definitions/list-meta.md +++ b/content/zh/docs/reference/kubernetes-api/common-definitions/list-meta.md @@ -74,18 +74,14 @@ ListMeta describes metadata that synthetic resources must have, including lists 更多信息:https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#concurrency-control-and-consistency。 - **selfLink** (string) selfLink 表示此对象的 URL,由系统填充,只读。 - 已弃用。 Kubernetes 将在 1.20 版本中停止传播该字段,并计划在 1.21 版本中删除该字段。 + 已弃用:selfLink 是一个遗留的只读字段,不再由系统填充。 diff --git a/content/zh/docs/reference/kubernetes-api/common-definitions/object-meta.md b/content/zh/docs/reference/kubernetes-api/common-definitions/object-meta.md index e89bdc9e33..ead5072a4e 100644 --- a/content/zh/docs/reference/kubernetes-api/common-definitions/object-meta.md +++ b/content/zh/docs/reference/kubernetes-api/common-definitions/object-meta.md @@ -391,10 +391,11 @@ ObjectMeta 是所有持久化资源必须具有的元数据,其中包括用户 - **clusterName** (string) - 对象所属的集群的名称。这用于区分不同集群中具有相同名称和命名空间的资源。 - 该字段现在没有在任何地方设置,如果在创建或更新请求中设置,apiserver 将忽略它。 + 已弃用:clusterName 是一个总是被系统清除并且从未使用过的遗留字段;它将在 1.25 中完全删除。 + go 结构体中的对应字段名称已更改,以帮助客户端检测意外使用。 diff --git a/content/zh/docs/reference/kubernetes-api/common-parameters/common-parameters.md b/content/zh/docs/reference/kubernetes-api/common-parameters/common-parameters.md index c93149c288..f53524eb9d 100644 --- a/content/zh/docs/reference/kubernetes-api/common-parameters/common-parameters.md +++ b/content/zh/docs/reference/kubernetes-api/common-parameters/common-parameters.md @@ -86,6 +86,32 @@ A selector to restrict the list of returned objects by their fields. Defaults to 根据返回对象的字段限制返回对象列表的选择器。默认为返回所有字段。
+## fieldValidation {#fieldValidation} + + +fieldValidation 指示服务器如何处理请求(POST/PUT/PATCH)中包含未知或重复字段的对象, +前提是 `ServerSideFieldValidation` 特性门控也已启用。 + +有效值为: +- Ignore:这将忽略从对象中默默删除的所有未知字段,并将忽略除解码器遇到的最后一个重复字段之外的所有字段。 + 这是在 v1.23 之前的默认行为,也是当 `ServerSideFieldValidation` 特性门控被禁用时的默认行为。 + +- Warn:这将针对从对象中删除的各个未知字段以及所遇到的各个重复字段,分别通过标准警告响应头发出警告。 + 如果没有其他错误,请求仍然会成功,并且只会保留所有重复字段中的最后一个。 + 这是启用 `ServerSideFieldValidation` 特性门控时的默认值。 + +- Strict:如果从对象中删除任何未知字段,或者存在任何重复字段,将使请求失败并返回 BadRequest 错误。 + +
+ ## force {#force} +例子:`node.kubernetes.io/out-of-service:NoExecute` + +用户可以手动将污点添加到节点,将其标记为停止服务。 +如果 `kube-controller-manager` 上启用了 `NodeOutOfServiceVolumeDetach` +[特性门控](/zh/docs/reference/command-line-tools-reference/feature-gates/), +并且一个节点被这个污点标记为停止服务,如果节点上的 Pod 没有对应的容忍度, +这类 Pod 将被强制删除,并且,针对在节点上被终止 Pod 的卷分离操作将被立即执行。 + +{{< caution >}} + +有关何时以及如何使用此污点的更多详细信息,请参阅[非正常节点关闭](/zh/docs/concepts/architecture/nodes/#non-graceful-node-shutdown)。 +{{< /caution >}} + +例子:`snapshot.storage.kubernetes.io/allowVolumeModeChange: "true"` + +用于:VolumeSnapshotContent + + +值可以是 `true` 或者 `false`。 +这决定了当从 VolumeSnapshot 创建 {{< glossary_tooltip text="PersistentVolumeClaim" term_id="persistent-volume-claim" >}} +时,用户是否可以修改源卷的模式。 +更多信息请参阅[转换快照的卷模式](/zh/docs/concepts/storage/volume-snapshots/#convert-volume-mode)和 +[Kubernetes CSI 开发者文档](https://kubernetes-csi.github.io/docs/)。 + +例子:`kubeadm.alpha.kubernetes.io/cri-socket: unix:///run/containerd/container.sock` + +用于:Node + + +kubeadm 用来保存 `init`/`join` 时提供给 kubeadm 以后使用的 CRI 套接字信息的注解。 +kubeadm 使用此信息为 Node 对象设置注解。 +此注解仍然是 “alpha” 阶段,因为理论上这应该是 KubeletConfiguration 中的一个字段。 + +### kubeadm.kubernetes.io/etcd.advertise-client-urls + + +例子:`kubeadm.kubernetes.io/etcd.advertise-client-urls: https://172.17.0.18:2379` + +用于:Pod + + +kubeadm 为本地管理的 etcd Pod 设置的注解,用来跟踪 etcd 客户端应连接到的 URL 列表。 +这主要用于 etcd 集群健康检查目的。 + +### kubeadm.kubernetes.io/kube-apiserver.advertise-address.endpoint + + +例子:`kubeadm.kubernetes.io/kube-apiserver.advertise-address.endpoint: https//172.17.0.18:6443` + +用于:Pod + + +kubeadm 为本地管理的 kube-apiserver Pod 设置的注解,用以跟踪该 API 服务器实例的公开宣告地址/端口端点。 + +### kubeadm.kubernetes.io/component-config.hash + + +例子:`kubeadm.kubernetes.io/component-config.hash: 2c26b46b68ffc68ff99b453c1d30413413422d706483bfa0f98a5e886266e7ae` + +用于:ConfigMap + + +kubeadm 为它所管理的 ConfigMaps 设置的注解,用于配置组件。它包含一个哈希(SHA-256)值, +用于确定用户是否应用了不同于特定组件的 kubeadm 默认设置的设置。 + +### node-role.kubernetes.io/control-plane + + +用于:Node + +kubeadm 在其管理的控制平面节点上应用的标签。 + +### node-role.kubernetes.io/control-plane + + +例子:`node-role.kubernetes.io/control-plane:NoSchedule` + +用于:Node + + +kubeadm 应用在控制平面节点上的污点,仅允许在其上调度关键工作负载。 + +### node-role.kubernetes.io/master + + +例子:`node-role.kubernetes.io/master:NoSchedule` + +用于:Node + + +kubeadm 应用在控制平面节点上的污点,仅允许在其上调度关键工作负载。 +{{< note >}} +从 v1.20 开始,此污点已弃用,并将在 v1.25 中将其删除,取而代之的是 `node-role.kubernetes.io/control-plane`。 +{{< /note >}} \ No newline at end of file