第 11 章 MachineOSBuild [machineconfiguration.openshift.io/v1]
- 描述
- MachineOSBuild 描述了由 MCO 兼容性级别 1 管理和部署的构建过程:在主发行版本中至少为 12 个月或 3 个次版本(以更长的时间为准)。
- 类型
-
object
- 必填
-
spec
-
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 | |
|
| spec 描述机器 os 构建的配置。设置后,它不可变。 |
|
| status 描述了此机器 os 构建的最后观察状态。 |
11.1.1. .spec 复制链接链接已复制到粘贴板!
- 描述
- spec 描述机器 os 构建的配置。设置后,它不可变。
- 类型
-
object
- 必填
-
machineConfig
-
machineOSConfig
-
renderedImagePushSpec
-
属性 | 类型 | 描述 |
---|---|---|
|
| MachineConfig 指向此镜像构建中包含的渲染的 MachineConfig 资源。 |
|
| MachineOSConfig 引用此镜像构建的 MachineOSConfig 资源。 |
|
| renderedImagePushSpec 由 Machine Config Operator 从这个构建附加到的 MachineOSConfig 对象设置。此字段描述最终镜像的位置,该镜像将在构建完成后被构建推送。镜像推送 spec 的格式为:host[:port][/namespace]/name:<tag> 或 svc_name.namespace.svc[:port]/repository/name:<tag>。push spec 的长度必须在 1 到 447 个字符之间。 |
11.1.2. .spec.machineConfig 复制链接链接已复制到粘贴板!
- 描述
- MachineConfig 指向此镜像构建中包含的渲染的 MachineConfig 资源。
- 类型
-
object
- 必填
-
name
-
属性 | 类型 | 描述 |
---|---|---|
|
| name 是渲染的 MachineConfig 对象的名称。这个值应该介于 10 到 253 个字符之间,且必须包含小写字母数字字符、连字符和句点,并且应以字母数字字符开头和结尾。 |
11.1.3. .spec.machineOSConfig 复制链接链接已复制到粘贴板!
- 描述
- MachineOSConfig 引用此镜像构建的 MachineOSConfig 资源。
- 类型
-
object
- 必填
-
name
-
属性 | 类型 | 描述 |
---|---|---|
|
| MachineOSConfig 的名称。名称只能包含小写字母数字字符 '-' 或 '.',并使用字母数字字符开头/结束。 |
11.1.4. .status 复制链接链接已复制到粘贴板!
- 描述
- status 描述了此机器 os 构建的最后观察状态。
- 类型
-
object
属性 | 类型 | 描述 |
---|---|---|
|
| buildEnd 是构建器后端完成的时间戳。在省略构建时,构建尚未启动,或正在进行中。构建完成后将填充构建、失败或中断。 |
|
| buildStart 是构建控制器为此 MachineOSBuild 启动构建后端的时间戳。 |
|
| builder 描述了用于此构建的镜像构建的镜像构建程序后端。 |
|
| 条件是与构建相关的条件。有效类型包括: Prepared、builded、Failed、Interupted 和 Succeeded。当一个构建标记为 Failed、Interupted 或 Succeeded 时,不会设置将来的条件。 |
|
| condition 包含此 API 资源当前状态的一个方面的详细信息。 |
|
| digestedImagePushSpec 描述了此构建生成的完全限定推送规格。push spec 的格式是:host[:port][/namespace]/name@sha256:<digest>,其中摘要长度必须为 64 个字符,且仅包含小写十六进制字符、a-f 和 0-9。整个 spec 的长度必须在 1 到 447 个字符之间。 |
|
| relatedObjects 是临时对象(如 ConfigMap 或 Secret)在构建过程运行时消耗的引用列表。在构建成功或删除此 MachineOSBuild 后,这些临时对象会被删除。如果构建失败,对象将保留,直到构建被删除以允许检查。 |
|
| ObjectReference 包含足够信息供您检查或修改引用的对象。 |
11.1.5. .status.builder 复制链接链接已复制到粘贴板!
- 描述
- builder 描述了用于此构建的镜像构建的镜像构建程序后端。
- 类型
-
object
- 必填
-
imageBuilderType
-
属性 | 类型 | 描述 |
---|---|---|
|
| imageBuilderType 描述了用于构建此镜像的镜像构建器类型。有效值为 Job。当设置为 Job 时,基于 pod 的构建程序(使用 buildah)会被启动以构建指定的镜像。 |
|
| job 是管理镜像构建的作业对象的引用。如果 imageBuilderType 是 Job,否则会禁用它。 |
11.1.6. .status.builder.job 复制链接链接已复制到粘贴板!
- 描述
- job 是管理镜像构建的作业对象的引用。如果 imageBuilderType 是 Job,否则会禁用它。
- 类型
-
object
- 必填
-
group
-
name
-
resource
-
属性 | 类型 | 描述 |
---|---|---|
|
| 引用的组。名称只能包含小写字母数字字符 '-' 或 '.',并使用字母数字字符开头/结束。示例: ""、"apps"、"build.openshift.io"等。 |
|
| 引用的名称。名称只能包含小写字母数字字符 '-' 或 '.',并使用字母数字字符开头/结束。 |
|
| 引用的命名空间。这个值应该最多包含 63 个字符,且只能包含小写字母数字字符和连字符,并且应以字母数字字符开头和结尾。 |
|
| 引用的资源。这个值应该最多包含 63 个字符,且只能包含小写字母数字字符和连字符,并以字母字符开头,并以字母数字字符结尾。示例:"deployments", "deploymentconfigs", "pods" 等。 |
11.1.7. .status.conditions 复制链接链接已复制到粘贴板!
- 描述
- 条件是与构建相关的条件。有效类型包括: Prepared、builded、Failed、Interupted 和 Succeeded。当一个构建标记为 Failed、Interupted 或 Succeeded 时,不会设置将来的条件。
- 类型
-
array
11.1.8. .status.conditions[] 复制链接链接已复制到粘贴板!
- 描述
- condition 包含此 API 资源当前状态的一个方面的详细信息。
- 类型
-
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 中的条件类型。 |