diff --git a/content/zh/docs/reference/labels-annotations-taints/_index.md b/content/zh/docs/reference/labels-annotations-taints/_index.md index 1fd14e8b6d..faca42d237 100644 --- a/content/zh/docs/reference/labels-annotations-taints/_index.md +++ b/content/zh/docs/reference/labels-annotations-taints/_index.md @@ -26,15 +26,151 @@ Kubernetes 将所有标签和注解保留在 kubernetes.io Namespace中。 +## API 对象上使用的标签、注解和污点 + +### app.kubernetes.io/component + +例子: `app.kubernetes.io/component=database` + +用于: 所有对象 + +架构中的组件。 + +[推荐标签](/zh/docs/concepts/overview/working-with-objects/common-labels/#labels)之一。 + + +### app.kubernetes.io/created-by + +示例:`app.kubernetes.io/created-by=controller-manager` + +用于:所有对象 + +创建此资源的控制器/用户。 + +[推荐标签](/zh/docs/concepts/overview/working-with-objects/common-labels/#labels)之一。 + + +### app.kubernetes.io/instance + +示例:`app.kubernetes.io/instance=mysql-abcxzy` + +用于:所有对象 + +标识应用实例的唯一名称。 + +[推荐标签](/zh/docs/concepts/overview/working-with-objects/common-labels/#labels)之一。 + + +### app.kubernetes.io/managed-by + +示例:`app.kubernetes.io/managed-by=helm` + +用于:所有对象 + +用于管理应用操作的工具。 + +[推荐标签](/zh/docs/concepts/overview/working-with-objects/common-labels/#labels)之一。 + + + +### app.kubernetes.io/name + +示例:`app.kubernetes.io/name=mysql` + +用于:所有对象 + +应用的名称。 + +[推荐标签](/zh/docs/concepts/overview/working-with-objects/common-labels/#labels)之一。 + + +### app.kubernetes.io/part-of + +示例:`app.kubernetes.io/part-of=wordpress` + +用于:所有对象 + +此应用所属的更高级别应用的名称。 + +[推荐标签](/zh/docs/concepts/overview/working-with-objects/common-labels/#labels)之一。 + + +### app.kubernetes.io/version + +示例:`app.kubernetes.io/version="5.7.21"` + +用于:所有对象 + +应用的当前版本(例如,语义版本、修订哈希等)。 + +[推荐标签](/zh/docs/concepts/overview/working-with-objects/common-labels/#labels)之一。 + + -## API 对象上使用的标签、注解和污点 +The Kubelet populates this with `runtime.GOARCH` as defined by Go. This can be handy if you are mixing arm and x86 nodes. --> ### kubernetes.io/arch {#kubernetes-io-arch} @@ -185,8 +321,6 @@ Used on: Pod This annotation is used to set [Pod Deletion Cost](/docs/concepts/workloads/controllers/replicaset/#pod-deletion-cost) which allows users to influence ReplicaSet downscaling order. The annotation parses into an `int32` type. - -### beta.kubernetes.io/instance-type (deprecated) --> ### controller.kubernetes.io/pod-deletion-cost {#pod-deletion-cost} @@ -194,8 +328,85 @@ which allows users to influence ReplicaSet downscaling order. The annotation par 用于:Pod -该注解用于设置 [Pod 删除成本](/docs/concepts/workloads/controllers/replicaset/#pod-deletion-cost) 允许用户影响 ReplicaSet 缩减顺序。注解解析为 `int32` 类型。 +该注解用于设置 [Pod 删除成本](/docs/concepts/workloads/controllers/replicaset/#pod-deletion-cost)允许用户影响 ReplicaSet 缩减顺序。注解解析为 `int32` 类型。 + + +### kubernetes.io/ingress-bandwidth + +{{< note >}} +入站流量控制注解是一项实验性功能。 +如果要启用流量控制支持,必须将`bandwidth`插件添加到 CNI 配置文件(默认为`/etc/cni/net.d`) +并确保二进制文件包含在你的 CNI bin 目录中(默认为`/opt/cni/bin`)。 +{{< /note >}} + +示例:`kubernetes.io/ingress-bandwidth: 10M` + +用于:Pod + +你可以对 Pod 应用服务质量流量控制并有效限制其可用带宽。 +入站流量(到 Pod)通过控制排队的数据包来处理,以有效地处理数据。 +要限制 Pod 的带宽,请编写对象定义 JSON 文件并使用 `kubernetes.io/ingress-bandwidth` +注解指定数据流量速度。 用于指定入站的速率单位是每秒, +作为[量纲(Quantity)](/zh/docs/reference/kubernetes-api/common-definitions/quantity/)。 +例如,`10M`表示每秒 10 兆比特。 + + + +### kubernetes.io/egress-bandwidth + +{{< note >}} +出站流量控制注解是一项实验性功能。 +如果要启用流量控制支持,必须将`bandwidth`插件添加到 CNI 配置文件(默认为`/etc/cni/net.d`) +并确保二进制文件包含在你的 CNI bin 目录中(默认为`/opt/cni/bin`)。 +{{< /note >}} + +示例:`kubernetes.io/egress-bandwidth: 10M` + +用于:Pod + +出站流量(来自 pod)由策略控制,策略只是丢弃超过配置速率的数据包。 +你为一个 Pod 所设置的限制不会影响其他 Pod 的带宽。 +要限制 Pod 的带宽,请编写对象定义 JSON 文件并使用 `kubernetes.io/egress-bandwidth` 注解指定数据流量速度。 +用于指定出站的速率单位是每秒比特数, +以[量纲(Quantity)](/zh/docs/reference/kubernetes-api/common-definitions/quantity/)的形式给出。 +例如,`10M` 表示每秒 10 兆比特。 + + ### beta.kubernetes.io/instance-type (已弃用) {#beta-kubernetes-io-instance-type} ## 用于审计的注解 {#annonations-used-for-audit} -- [`pod-security.kubernetes.io/exempt`](/zh/docs/reference/labels-annotations-taints/audit-annotations/#pod-security-kubernetes-io-exempt) -- [`pod-security.kubernetes.io/enforce-policy`](/zh/zh/docs/reference/labels-annotations-taints/audit-annotations/#pod-security-kubernetes-io-enforce-policy) +- [`authorization.k8s.io/decision`](/zh/docs/reference/labels-annotations-taints/audit-annotations/#authorization-k8s-io-decision) +- [`authorization.k8s.io/reason`](/zh/docs/reference/labels-annotations-taints/audit-annotations/#authorization-k8s-io-reason) - [`pod-security.kubernetes.io/audit-violations`](/zh/docs/reference/labels-annotations-taints/audit-annotations/#pod-security-kubernetes-io-audit-violations) +- [`pod-security.kubernetes.io/enforce-policy`](/zh/zh/docs/reference/labels-annotations-taints/audit-annotations/#pod-security-kubernetes-io-enforce-policy) +- [`pod-security.kubernetes.io/exempt`](/zh/docs/reference/labels-annotations-taints/audit-annotations/#pod-security-kubernetes-io-exempt) 在[审计注解](/zh/docs/reference/labels-annotations-taints/audit-annotations/)页面上查看更多详细信息。 \ No newline at end of file