对象名称和 ID
集群中的每个 对象 都有一个对于该类型资源唯一的 名称。每个 Kubernetes 对象还有一个在整个集群中唯一的 UID。
例如,在同一个 命名空间 内,您只能有一个名为 myapp-1234
的 Pod,但您可以拥有一个 Pod 和一个都名为 myapp-1234
的 Deployment。
对于非唯一的用户提供的属性,Kubernetes 提供了 标签 和 注解。
名称
客户端提供的字符串,用于引用资源 URL 中的对象,例如 /api/v1/pods/some-name
。
给定类型的对象在同一时间只能有一个给定的名称。但是,如果您删除该对象,则可以使用相同的名称创建新对象。
名称在同一资源的所有 API 版本 中必须唯一。API 资源通过其 API 组、资源类型、命名空间(对于命名空间资源)和名称来区分。换句话说,API 版本在此上下文中无关紧要。
注意
如果对象表示物理实体(例如表示物理主机的节点),则在未删除和重新创建节点的情况下以相同名称重新创建主机时,Kubernetes 会将新主机视为旧主机,这可能会导致不一致。以下是资源常用的四种名称约束类型。
DNS 子域名
大多数资源类型都需要一个可以用作 DNS 子域名的名称,如 RFC 1123 中所定义。这意味着名称必须
- 包含不超过 253 个字符
- 仅包含小写字母数字字符、“-” 或“.”
- 以字母数字字符开头
- 以字母数字字符结尾
RFC 1123 标签名称
某些资源类型要求其名称遵循 RFC 1123 中定义的 DNS 标签标准。这意味着名称必须
- 包含最多 63 个字符
- 仅包含小写字母数字字符或“-”
- 以字母数字字符开头
- 以字母数字字符结尾
RFC 1035 标签名称
某些资源类型要求其名称遵循 RFC 1035 中定义的 DNS 标签标准。这意味着名称必须
- 包含最多 63 个字符
- 仅包含小写字母数字字符或“-”
- 以字母字符开头
- 以字母数字字符结尾
注意
RFC 1035 和 RFC 1123 标签标准之间的唯一区别是,RFC 1123 标签允许以数字开头,而 RFC 1035 标签只能以小写字母字符开头。路径段名称
某些资源类型要求其名称能够安全地编码为路径段。换句话说,名称不能是“.”或“..”,并且名称不能包含“/”或“%”。
这是一个名为 nginx-demo
的 Pod 的示例清单。
apiVersion: v1
kind: Pod
metadata:
name: nginx-demo
spec:
containers:
- name: nginx
image: nginx:1.14.2
ports:
- containerPort: 80
注意
某些资源类型对其名称还有其他限制。UID
Kubernetes 系统生成的字符串,用于唯一标识对象。
在 Kubernetes 集群的整个生命周期中创建的每个对象都有一个不同的 UID。它旨在区分相似实体的历史出现。
Kubernetes UID 是通用唯一标识符(也称为 UUID)。UUID 标准化为 ISO/IEC 9834-8 和 ITU-T X.667。
下一步
- 阅读有关 Kubernetes 中的 标签 和 注解 的信息。
- 请参阅 Kubernetes 中的标识符和名称 设计文档。