Skip to content

Commit 5b22362

Browse files
authored
Merge pull request #54325 from qlijin/sync-file-2026-02-06
[zh-cn] sync file labels-annotations-taints/_index.md
2 parents 47d64de + cc8c667 commit 5b22362

File tree

1 file changed

+138
-0
lines changed
  • content/zh-cn/docs/reference/labels-annotations-taints

1 file changed

+138
-0
lines changed

content/zh-cn/docs/reference/labels-annotations-taints/_index.md

Lines changed: 138 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -696,6 +696,109 @@ adhere to. This helps enforce security policies and isolation for your container
696696

697697
所指定的配置文件定义了容器进程必须遵守的规则集和限制集。这有助于针对容器实施安全策略和隔离措施。
698698

699+
<!--
700+
### deployment.kubernetes.io/desired-replicas
701+
702+
Type: Annotation
703+
704+
Example: `deployment.kubernetes.io/desired-replicas: "3"`
705+
706+
Used on: ReplicaSet
707+
708+
This annotation is set by the Deployment controller on ReplicaSets it manages.
709+
The value represents the desired number of replicas (`.spec.replicas`) from the Deployment
710+
that owns this ReplicaSet. The Deployment controller uses this annotation to track the
711+
desired state during rolling updates and scaling operations.
712+
713+
This is an internal annotation used by the Deployment controller and should not be
714+
modified manually.
715+
-->
716+
### deployment.kubernetes.io/desired-replicas {#deployment-kubernetes-io-desired-replicas}
717+
718+
类别:注解
719+
720+
例子:`deployment.kubernetes.io/desired-replicas: "3"`
721+
722+
用于:ReplicaSet
723+
724+
此注解由 Deployment 控制器在其所管理的 ReplicaSet 上进行设置。
725+
注解值代表拥有该 ReplicaSet 所属 Deployment 期望的副本数(`.spec.replicas`)。
726+
Deployment 控制器利用此注解在滚动更新和扩缩容操作期间追踪期望状态。
727+
728+
这是一个供 Deployment 控制器使用的内部注解,不应手动修改。
729+
730+
731+
<!--
732+
### deployment.kubernetes.io/max-replicas
733+
734+
Type: Annotation
735+
736+
Example: `deployment.kubernetes.io/max-replicas: "5"`
737+
738+
Used on: ReplicaSet
739+
740+
This annotation is set by the Deployment controller on ReplicaSets it manages.
741+
The value represents the maximum number of replicas that this ReplicaSet is allowed to have
742+
during a rolling update. This is used to implement the `maxSurge` parameter of the
743+
Deployment's rolling update strategy, which controls how many extra Pods can be created
744+
above the desired number during an update.
745+
746+
This is an internal annotation used by the Deployment controller and should not be
747+
modified manually.
748+
-->
749+
### deployment.kubernetes.io/max-replicas {#deployment-kubernetes-io-max-replicas}
750+
751+
类别:注解
752+
753+
例子:`deployment.kubernetes.io/max-replicas: "5"`
754+
755+
用于:ReplicaSet
756+
757+
此注解由 Deployment 控制器在其所管理的 ReplicaSet 上进行设置。
758+
注解值代表在滚动更新期间,该 ReplicaSet 允许拥有的最大副本数。
759+
这用于实现 Deployment 滚动更新策略中的 `maxSurge`参数,
760+
该参数控制了在更新过程中允许在期望副本数之外额外创建多少个 Pod。
761+
762+
这是一个供 Deployment 控制器使用的内部注解,不应手动修改。
763+
764+
<!--
765+
### deployment.kubernetes.io/revision
766+
767+
Type: Annotation
768+
769+
Example: `deployment.kubernetes.io/revision: "2"`
770+
771+
Used on: ReplicaSet
772+
773+
This annotation is set by the Deployment controller on ReplicaSets it manages.
774+
The value represents the revision number of the Deployment. Each time the Deployment's
775+
Pod template (`.spec.template`) is changed, the revision number is incremented.
776+
This annotation is used to track the rollout history and enables rollback to previous
777+
revisions using `kubectl rollout undo`.
778+
779+
The revision number is also visible when running `kubectl rollout history deployment/<name>`.
780+
781+
This is an internal annotation used by the Deployment controller and should not be
782+
modified manually.
783+
-->
784+
### deployment.kubernetes.io/revision {#deployment-kubernetes-io-revision}
785+
786+
类别:注解
787+
788+
例子:`deployment.kubernetes.io/revision: "2"`
789+
790+
用于:ReplicaSet
791+
792+
此注解由 Deployment 控制器在其所管理的 ReplicaSet 上进行设置。
793+
此注解的值表示 Deployment 的修订版本号。每当 Deployment 的
794+
Pod 模板(`.spec.template`)发生变更时,该修订版本号都会递增。
795+
此注解用于跟踪发布历史,并支持使用 `kubectl rollout undo` 回滚到之前的修订版本。
796+
797+
在执行 `kubectl rollout history deployment/<name>` 命令时,也可以查看到对应的修订版本号。
798+
799+
这是一个供 Deployment 控制器使用的内部注解,不应手动修改。
800+
801+
699802
<!--
700803
### internal.config.kubernetes.io/* (reserved prefix) {#internal.config.kubernetes.io-reserved-wildcard}
701804
@@ -1667,6 +1770,41 @@ that the Pod is already using, the Pod continues to run.
16671770
如果 Pod 已经在运行,并且你将 `kubernetes.io/enforce-mountable-secrets` 注解更改为 true,
16681771
或者你编辑关联的 ServiceAccount 以移除 Pod 已经在使用的对 Secret 的引用,那么 Pod 将继续运行。
16691772

1773+
1774+
<!--
1775+
### node.alpha.kubernetes.io/ttl (deprecated)
1776+
1777+
Type: Label
1778+
1779+
Example: `node.alpha.kubernetes.io/ttl: "0"`
1780+
1781+
Used on: Node
1782+
1783+
This label was used historically by some tools (such as minikube) to set a time-to-live
1784+
value for nodes. The label is deprecated and should not be used in new deployments.
1785+
1786+
{{< note >}}
1787+
This label is deprecated and has no effect in current Kubernetes versions.
1788+
It may still be set by older tools for backward compatibility.
1789+
{{< /note >}}
1790+
-->
1791+
### node.alpha.kubernetes.io/ttl(已弃用) {#node-alpha-kubernetes-io-ttl-deprecated}
1792+
1793+
类别:标签
1794+
1795+
示例:`node.alpha.kubernetes.io/ttl: "0"`
1796+
1797+
用于:Node
1798+
1799+
此标签在历史上曾被某些工具(如 minikube)用于为节点设置存活时间(TTL)值。
1800+
此标签已弃用,不应在新的部署中继续使用。
1801+
1802+
{{< note >}}
1803+
此标签已弃用,在当前的 Kubernetes 版本中已无任何影响。
1804+
出于向后兼容的目的,旧版本的工具可能仍会设置此标签。
1805+
{{< /note >}}
1806+
1807+
16701808
<!--
16711809
### node.kubernetes.io/exclude-from-external-load-balancers
16721810

0 commit comments

Comments
 (0)