对象名称和 ID

集群中的每个 对象 都有一个对于该类型资源唯一的 名称。每个 Kubernetes 对象还有一个在整个集群中唯一的 UID

例如,在同一个 命名空间 内,您只能有一个名为 myapp-1234 的 Pod,但您可以拥有一个 Pod 和一个都名为 myapp-1234 的 Deployment。

对于非唯一的用户提供的属性,Kubernetes 提供了 标签注解

名称

客户端提供的字符串,用于引用资源 URL 中的对象,例如 /api/v1/pods/some-name

给定类型的对象在同一时间只能有一个给定的名称。但是,如果您删除该对象,则可以使用相同的名称创建新对象。

名称在同一资源的所有 API 版本 中必须唯一。API 资源通过其 API 组、资源类型、命名空间(对于命名空间资源)和名称来区分。换句话说,API 版本在此上下文中无关紧要。

以下是资源常用的四种名称约束类型。

DNS 子域名

大多数资源类型都需要一个可以用作 DNS 子域名的名称,如 RFC 1123 中所定义。这意味着名称必须

  • 包含不超过 253 个字符
  • 仅包含小写字母数字字符、“-” 或“.”
  • 以字母数字字符开头
  • 以字母数字字符结尾

RFC 1123 标签名称

某些资源类型要求其名称遵循 RFC 1123 中定义的 DNS 标签标准。这意味着名称必须

  • 包含最多 63 个字符
  • 仅包含小写字母数字字符或“-”
  • 以字母数字字符开头
  • 以字母数字字符结尾

RFC 1035 标签名称

某些资源类型要求其名称遵循 RFC 1035 中定义的 DNS 标签标准。这意味着名称必须

  • 包含最多 63 个字符
  • 仅包含小写字母数字字符或“-”
  • 以字母字符开头
  • 以字母数字字符结尾

路径段名称

某些资源类型要求其名称能够安全地编码为路径段。换句话说,名称不能是“.”或“..”,并且名称不能包含“/”或“%”。

这是一个名为 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。

下一步

上次修改时间:2023 年 12 月 14 日上午 10:25 PST:应用代码审查中的建议 (b1bdd62775)