第 11 章 PreprovisioningImage [metal3.io/v1alpha1]
- 描述
- PreprovisioningImage 是预置备镜像 API 的 Schema。
- 类型
-
对象
11.1. 规格
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| APIVersion 定义对象的这个表示法的版本化的 schema。服务器应该将识别的模式转换为最新的内部值，并可拒绝未识别的值。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources |
|
|
| kind 是一个字符串值，代表此对象所代表的 REST 资源。服务器可以从客户端向其提交请求的端点推断。无法更新。采用驼峰拼写法 (CamelCase)。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
|
| 标准对象元数据。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata | |
|
|
| PreprovisioningImageSpec 定义所需的 PreprovisioningImage 状态。 |
|
|
| PreprovisioningImageStatus 定义 PreprovisioningImage 的观察状态。 |
11.1.1. .spec
- 描述
- PreprovisioningImageSpec 定义所需的 PreprovisioningImage 状态。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| acceptFormats 是可接受的镜像格式列表。 |
|
|
| 架构是构建镜像的处理器架构。 |
|
|
| networkDataName 是本地命名空间中的 Secret 名称，其中包含要构建到镜像的网络数据。 |
11.1.2. .status
- 描述
- PreprovisioningImageStatus 定义 PreprovisioningImage 的观察状态。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 架构是构建镜像的处理器架构 |
|
|
| 条件描述了构建镜像的状态 |
|
|
|
条件包含此 API 资源当前状态的一个方面的详情。--- 这个结构旨在直接用作字段路径 .status.conditions 中的数组。例如，输入 FooStatus struct{ // Represents the observations of a foo’s current state. // Known .status.conditions.type are: "Available", "Progressing", and "Degraded" // +patchMergeKey=type // +patchStrategy=merge // +listType=map // +listMapKey=type Conditions []metav1.Condition |
|
|
| extraKernelParams 是一个带有额外参数的字符串，用于在通过网络引导镜像时传递给内核。仅对 initrd 镜像有意义。 |
|
|
| Format 是位于下载 url 中的镜像的类型： iso 或 initrd。 |
|
|
| imageURL 是可以从中下载构建镜像的 URL。 |
|
|
| kernelUrl 是可以从中下载镜像内核的 URL。仅对 initrd 镜像有意义。 |
|
|
| networkData 是对包含用于构建镜像的网络数据的 Secret 版本的引用。 |
11.1.3. .status.conditions
- 描述
- 条件描述了构建镜像的状态
- 类型
-
array
11.1.4. .status.conditions[]
- 描述
-
条件包含此 API 资源当前状态的一个方面的详情。--- 这个结构旨在直接用作字段路径 .status.conditions 中的数组。例如，输入 FooStatus struct{ // Represents the observations of a foo’s current state. // Known .status.conditions.type are: "Available", "Progressing", and "Degraded" // +patchMergeKey=type // +patchStrategy=merge // +listType=map // +listMapKey=type Conditions []metav1.Condition
json:"conditions,omitempty" patchStrategy:"merge" patchMergeKey:"type" protobuf:"bytes,1,rep,name=conditions"// other fields } - 类型
-
object - 必填
-
lastTransitionTime -
message -
reason -
status -
type
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| lastTransitionTime 是条件从一个状态转换到另一个状态最后一次的时间。这应该是底层条件变化的时间。如果为未知，则使用 API 字段更改的时间是可以接受的。 |
|
|
| Message 是人类可读的消息，指示有关转换的详细信息。这可能是一个空字符串。 |
|
|
| observedGeneration 代表 .metadata.generation，这是条件设置所基于的条件。例如，如果 .metadata.generation 目前为 12，但 .status.conditions[x].observedGeneration 是 9，则代表条件与实例的当前状态已不匹配。 |
|
|
| reason 包含程序标识符，指示条件最后一次转换的原因。特定条件类型的制作者可能会定义预期的值和此字段的含义，以及这些值是否被视为有保证的 API。该值应该是 CamelCase 字符串。此字段可能不是空的。 |
|
|
| 条件的状态，True, False, Unknown 之一。 |
|
|
| CamelCase 或 foo.example.com/CamelCase 中的条件类型。-- Many .condition.type 值在资源间是一致的，但因为任意条件可能很有用（请参阅 .node.status.conditions），deconflict 的能力非常重要。它匹配的正则表达式是 (dns1123SubdomainFmt/)? (qualifiedNameFmt) |
11.1.5. .status.networkData
- 描述
- networkData 是对包含用于构建镜像的网络数据的 Secret 版本的引用。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| |
|
|
|
