3.2.2 metadata 嵌套字段

metadata 字段用于描述对象的属性信息，其内嵌多个字段用于定义资源的元数据，例如name和lables等，这些字段大体可分为必要字段和可选字段两大类。名称空间级别的资源的必选字段包括如下三项：

• namespace：指定当前对象隶属的名称空间，默认值为 default。
• name：设定当前对象的名称，在其所属的名称空间的同一类型中必须唯一。
• uid：当前对象的唯一标识符，其唯一性仅发生在特定的时间段和名称空间中：此标识符主要是用于区别拥有同样名字的“已删除”和“重新创建”的同一个名称的对象。

可选字段通常是指由 Kubernetes 系统自行维护的设置，或者存在默认，或者本身允许使用空值等类型的字段，常用的有如下几个：

• lables：设定用于标识当前对象的标签，键值数据，常被用作挑选条件。
• annotations：非标识型键值数据，用来作为挑选条件，用于 lables 的补充。
• resourceVersion：当前对象的内部版本标识符，用于让客户端确定对象变动与否。
• generation：用于标识当前对象目标状态的代别。
• creationTimestamp：当前对象创建日期的时间戳。
• deletionTimestamp：当前对象删除日期的时间戳。

此外，用户通过配置清单创建资源时，通常仅需要给出必选字段，可选字段可按需指定，对于用户未明确定义的嵌套字段，则需要由一系列的finalizer组件自动予以填充。而用户需要对资源创建的目标资源对象进行强制校验，或者在修改时需要用到 initializer 组件完成，例如，为每个待创建的Pod对象添加一个 Sidecar 容器等。不同的资源类型也会存在一些专有的嵌套字段，例如，ConfigMap 资源还支持使用 clusterName 等。