第 11 章 MachineOSBuild [machineconfiguration.openshift.io/v1]


描述
MachineOSBuild 描述了由 MCO 兼容性级别 1 管理和部署的构建过程:在主发行版本中至少为 12 个月或 3 个次版本(以更长的时间为准)。
类型
object
必填
  • spec

11.1. 规格

Expand
属性类型描述

apiVersion

string

APIVersion 定义对象的这个表示法的版本化的 schema。服务器应该将识别的模式转换为最新的内部值,并可拒绝未识别的值。更多信息: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources

kind

string

kind 是一个字符串值,代表此对象所代表的 REST 资源。服务器可以从客户端向其提交请求的端点推断。无法更新。采用驼峰拼写法 (CamelCase)。更多信息: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

metadata

ObjectMeta

标准对象元数据。更多信息: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata

spec

object

spec 描述机器 os 构建的配置。设置后,它不可变。

status

object

status 描述了此机器 os 构建的最后观察状态。

11.1.1. .spec

描述
spec 描述机器 os 构建的配置。设置后,它不可变。
类型
object
必填
  • machineConfig
  • machineOSConfig
  • renderedImagePushSpec
Expand
属性类型描述

machineConfig

object

MachineConfig 指向此镜像构建中包含的渲染的 MachineConfig 资源。

machineOSConfig

object

MachineOSConfig 引用此镜像构建的 MachineOSConfig 资源。

renderedImagePushSpec

string

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
Expand
属性类型描述

name

string

name 是渲染的 MachineConfig 对象的名称。这个值应该介于 10 到 253 个字符之间,且必须包含小写字母数字字符、连字符和句点,并且应以字母数字字符开头和结尾。

11.1.3. .spec.machineOSConfig

描述
MachineOSConfig 引用此镜像构建的 MachineOSConfig 资源。
类型
object
必填
  • name
Expand
属性类型描述

name

string

MachineOSConfig 的名称。名称只能包含小写字母数字字符 '-' 或 '.',并使用字母数字字符开头/结束。

11.1.4. .status

描述
status 描述了此机器 os 构建的最后观察状态。
类型
object
Expand
属性类型描述

buildEnd

string

buildEnd 是构建器后端完成的时间戳。在省略构建时,构建尚未启动,或正在进行中。构建完成后将填充构建、失败或中断。

buildStart

string

buildStart 是构建控制器为此 MachineOSBuild 启动构建后端的时间戳。

builder

object

builder 描述了用于此构建的镜像构建的镜像构建程序后端。

conditions

数组

条件是与构建相关的条件。有效类型包括: Prepared、builded、Failed、Interupted 和 Succeeded。当一个构建标记为 Failed、Interupted 或 Succeeded 时,不会设置将来的条件。

conditions[]

object

condition 包含此 API 资源当前状态的一个方面的详细信息。

digestedImagePushSpec

string

digestedImagePushSpec 描述了此构建生成的完全限定推送规格。push spec 的格式是:host[:port][/namespace]/name@sha256:<digest>,其中摘要长度必须为 64 个字符,且仅包含小写十六进制字符、a-f 和 0-9。整个 spec 的长度必须在 1 到 447 个字符之间。

relatedObjects

数组

relatedObjects 是临时对象(如 ConfigMap 或 Secret)在构建过程运行时消耗的引用列表。在构建成功或删除此 MachineOSBuild 后,这些临时对象会被删除。如果构建失败,对象将保留,直到构建被删除以允许检查。

relatedObjects[]

对象

ObjectReference 包含足够信息供您检查或修改引用的对象。

11.1.5. .status.builder

描述
builder 描述了用于此构建的镜像构建的镜像构建程序后端。
类型
object
必填
  • imageBuilderType
Expand
属性类型描述

imageBuilderType

string

imageBuilderType 描述了用于构建此镜像的镜像构建器类型。有效值为 Job。当设置为 Job 时,基于 pod 的构建程序(使用 buildah)会被启动以构建指定的镜像。

job

object

job 是管理镜像构建的作业对象的引用。如果 imageBuilderType 是 Job,否则会禁用它。

11.1.6. .status.builder.job

描述
job 是管理镜像构建的作业对象的引用。如果 imageBuilderType 是 Job,否则会禁用它。
类型
object
必填
  • group
  • name
  • resource
Expand
属性类型描述

group

字符串

引用的组。名称只能包含小写字母数字字符 '-' 或 '.',并使用字母数字字符开头/结束。示例: ""、"apps"、"build.openshift.io"等。

name

字符串

引用的名称。名称只能包含小写字母数字字符 '-' 或 '.',并使用字母数字字符开头/结束。

namespace

字符串

引用的命名空间。这个值应该最多包含 63 个字符,且只能包含小写字母数字字符和连字符,并且应以字母数字字符开头和结尾。

resource

字符串

引用的资源。这个值应该最多包含 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
Expand
属性类型描述

lastTransitionTime

字符串

lastTransitionTime 是条件从一个状态转换到另一个状态最后一次的时间。这应该是底层条件变化的时间。如果为未知,则使用 API 字段更改的时间是可以接受的。

message

字符串

Message 是人类可读的消息,指示有关转换的详细信息。这可能是一个空字符串。

observedGeneration

整数

observedGeneration 代表 .metadata.generation,这是条件设置所基于的条件。例如,如果 .metadata.generation 目前为 12,但 .status.conditions[x].observedGeneration 是 9,则代表条件与实例的当前状态已不匹配。

reason

字符串

reason 包含程序标识符,指示条件最后一次转换的原因。特定条件类型的制作者可能会定义预期的值和此字段的含义,以及这些值是否被视为有保证的 API。该值应该是 CamelCase 字符串。此字段可能不是空的。

status

字符串

条件的状态,True, False, Unknown 之一。

type

字符串

CamelCase 或 foo.example.com/CamelCase 中的条件类型。

11.1.9. .status.relatedObjects

描述
relatedObjects 是临时对象(如 ConfigMap 或 Secret)在构建过程运行时消耗的引用列表。在构建成功或删除此 MachineOSBuild 后,这些临时对象会被删除。如果构建失败,对象将保留,直到构建被删除以允许检查。
类型
array

11.1.10. .status.relatedObjects[]

描述
ObjectReference 包含足够信息供您检查或修改引用的对象。
类型
object
必填
  • group
  • name
  • resource
Expand
属性类型描述

group

字符串

引用的组。名称只能包含小写字母数字字符 '-' 或 '.',并使用字母数字字符开头/结束。示例: ""、"apps"、"build.openshift.io"等。

name

字符串

引用的名称。名称只能包含小写字母数字字符 '-' 或 '.',并使用字母数字字符开头/结束。

namespace

字符串

引用的命名空间。这个值应该最多包含 63 个字符,且只能包含小写字母数字字符和连字符,并且应以字母数字字符开头和结尾。

resource

字符串

引用的资源。这个值应该最多包含 63 个字符,且只能包含小写字母数字字符和连字符,并以字母字符开头,并以字母数字字符结尾。示例:"deployments", "deploymentconfigs", "pods" 等。

返回顶部
Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务,以及可以信赖的内容,帮助红帽用户创新并实现他们的目标。 了解我们当前的更新.

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情,请参阅红帽博客.

關於紅帽

我们提供强化的解决方案,使企业能够更轻松地跨平台和环境(从核心数据中心到网络边缘)工作。

Theme

© 2025 Red Hat