30.3. Build [build.openshift.io/v1]


描述
构建封装生成新的可部署镜像所需的输入,以及执行状态以及对执行构建的 Pod 的引用。
类型
对象

30.3.1. 规格

Expand
属性类型描述

apiVersion

字符串

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

kind

字符串

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

metadata

ObjectMeta

 

spec

对象

BuildSpec 包含代表构建的信息以及构建的附加信息

status

对象

BuildStatus 包含构建的状态

30.3.1.1. .spec

描述
BuildSpec 包含代表构建的信息以及构建的附加信息
类型
对象
必填
  • 策略
Expand
属性类型描述

completionDeadlineSeconds

整数

completionDeadlineSeconds 是一个可选持续时间(以秒为单位),从构建 pod 调度到系统中的时间开始计算,该构建可能会在系统主动尝试终止构建前在节点上活跃;值必须是正整数

mountTrustedCA

布尔值

mountTrustedCA bind 将集群的可信证书颁发机构(如集群代理配置中定义的)挂载到构建中。这允许在由自定义 PKI 证书颁发机构(如私有工件存储库和 HTTPS 代理)签名的构建信任组件内处理。

当此字段设置为 true 时,构建中的 /etc/pki/ca-trust 的内容由构建容器管理,并且对此目录或其子目录的任何更改(例如 - 在 Dockerfile RUN 指令中)都不会保留在构建的输出镜像中。

nodeSelector

对象(字符串)

nodeSelector 是一个选择器,必须为 true,构建 pod 必须位于节点上(如果 nil),则集群的默认构建节点选择器值可以被覆盖。如果设置为空映射或具有任何值的映射,则忽略默认构建节点选择器值。

output

对象

BuildOutput 是构建策略的输入,并描述了策略应生成的容器镜像。

postCommit

对象

BuildPostCommitSpec 包含构建后提交 hook 规格。hook 在运行构建输出镜像的临时容器内执行命令,紧接提交镜像的最后一层后,并在镜像推送到 registry 之前。命令执行,并将当前工作目录($PWD)设置为镜像的 WORKDIR。

如果 hook 执行失败,构建将标记为失败。如果脚本或命令返回非零退出代码,或者存在与启动临时容器相关的其他错误,它将会失败。

配置 hook 有五种不同的方法。例如,以下所有形式都等效,将执行 rake test --verbose

1.Shell 脚本:

"postCommit": { "script": "rake test --verbose", }

以上是一个便捷的格式,相当于:

"postCommit": { "command": ["/bin/sh", "-ic"], "args": ["rake test --verbose"] }

2.作为镜像入口点的命令:

"postCommit": { "commit": ["rake", "test", "--verbose"] }

命令覆盖 exec 表单中的镜像入口点,如 Docker 所述: https://docs.docker.com/engine/reference/builder/#entrypoint

3.将参数传递给默认入口点:

"postCommit": { "args": ["rake", "test", "--verbose"] }

只有镜像入口点可以处理参数时,此表单才有用。

4.Shell 脚本带有参数:

"postCommit": { "script": "rake test $1", "args": ["--verbose"] }

如果您需要在 shell 脚本中正确传递参数,此形式很有用。在脚本中,$0 将为 "/bin/sh" 和 $1、$2 等是 Args 中的位置参数。

5.命令带有参数:

"postCommit": { "command": ["rake", "test"], "args": ["--verbose"] }

这种形式等同于将参数附加到命令片段中。

同时提供脚本和命令无效。如果没有指定任何字段,则不会执行 hook。

资源

ResourceRequirements

资源计算执行构建的资源要求。

revision

对象

SourceRevision 是构建的源的修订或提交信息

serviceAccount

字符串

ServiceAccount 是用于运行此构建创建的 pod 的 ServiceAccount 的名称。pod 允许使用由 ServiceAccount 引用的 secret

source

对象

BuildSource 是用于构建的 SCM。

策略

对象

BuildStrategy 包含如何执行构建的详情。

triggeredBy

数组

triggerBy 描述了哪些触发器启动对构建配置的最新更新,并包含有关这些触发器的信息。

triggeredBy[]

对象

BuildTriggerCause 包含有关触发构建的信息。它可用于在 oc describe 中显示每个构建和构建配置的构建触发器数据。它还用于描述哪些触发器导致构建配置中最新更新。

30.3.1.2. .spec.output

描述
BuildOutput 是构建策略的输入,并描述了策略应生成的容器镜像。
类型
对象
Expand
属性类型描述

imageLabels

数组

imageLabels 定义应用到生成的镜像的标签列表。如果有多个具有相同名称的标签,则使用列表中的最后一个标签。

imageLabels[]

对象

ImageLabel 代表应用到生成的镜像的标签。

pushSecret

LocalObjectReference_v2

pushSecret 是 Secret 的名称,用于设置执行 Docker 推送以启用 Docker Registry (或 Docker Hub)的身份验证。

to

ObjectReference_v2

定义此构建输出要推送到的可选位置。kind 必须是 'ImageStreamTag' 或 'DockerImage' 之一。此值将用于查找要推送到的容器镜像存储库。如果是 ImageStreamTag,ImageStreamTag 会在构建的命名空间中查找,除非指定了 Namespace。

30.3.1.3. .spec.output.imageLabels

描述
imageLabels 定义应用到生成的镜像的标签列表。如果有多个具有相同名称的标签,则使用列表中的最后一个标签。
类型
数组

30.3.1.4. .spec.output.imageLabels[]

描述
ImageLabel 代表应用到生成的镜像的标签。
类型
对象
必填
  • name
Expand
属性类型描述

name

字符串

name 定义标签的名称。它必须具有非零长度。

value

字符串

value 定义标签的字面值。

30.3.1.5. .spec.postCommit

描述

BuildPostCommitSpec 包含构建后提交 hook 规格。hook 在运行构建输出镜像的临时容器内执行命令,紧接提交镜像的最后一层后,并在镜像推送到 registry 之前。命令执行,并将当前工作目录($PWD)设置为镜像的 WORKDIR。

如果 hook 执行失败,构建将标记为失败。如果脚本或命令返回非零退出代码,或者存在与启动临时容器相关的其他错误,它将会失败。

配置 hook 有五种不同的方法。例如,以下所有形式都等效,将执行 rake test --verbose

  1. Shell 脚本:

    "postCommit": {
      "script": "rake test --verbose",
    }
    Copy to Clipboard Toggle word wrap
    The above is a convenient form which is equivalent to:
    Copy to Clipboard Toggle word wrap
    "postCommit": {
      "command": ["/bin/sh", "-ic"],
      "args":    ["rake test --verbose"]
    }
    Copy to Clipboard Toggle word wrap
  2. 作为镜像入口点的命令:

    "postCommit": {
      "commit": ["rake", "test", "--verbose"]
    }
    Copy to Clipboard Toggle word wrap
    Command overrides the image entrypoint in the exec form, as documented in
    Docker: https://docs.docker.com/engine/reference/builder/#entrypoint.
    Copy to Clipboard Toggle word wrap
  3. 将参数传递给默认入口点:

    "postCommit": {
     "args": ["rake", "test", "--verbose"]
    }
    Copy to Clipboard Toggle word wrap
    This form is only useful if the image entrypoint can handle arguments.
    Copy to Clipboard Toggle word wrap
  4. Shell 脚本带有参数:

    "postCommit": {
      "script": "rake test $1",
      "args":   ["--verbose"]
    }
    Copy to Clipboard Toggle word wrap
    This form is useful if you need to pass arguments that would otherwise be
    hard to quote properly in the shell script. In the script, $0 will be
    "/bin/sh" and $1, $2, etc, are the positional arguments from Args.
    Copy to Clipboard Toggle word wrap
  5. 命令带有参数:

    "postCommit": {
      "command": ["rake", "test"],
      "args":    ["--verbose"]
    }
    Copy to Clipboard Toggle word wrap
    This form is equivalent to appending the arguments to the Command slice.
    Copy to Clipboard Toggle word wrap

同时提供脚本和命令无效。如果没有指定任何字段,则不会执行 hook。

类型
对象
Expand
属性类型描述

args

数组(字符串)

args 是提供给命令、脚本或容器镜像的默认入口点的参数列表。参数会在要运行的命令后立即放置。

命令

数组(字符串)

command 是要运行的命令。它可能无法通过脚本指定。如果镜像没有 /bin/sh,或者您不想使用 shell,则可能需要这样做。在所有其他情况下,使用脚本可能更为方便。

script

字符串

脚本是使用 /bin/sh -ic 运行的 shell 脚本。它可能无法通过 命令指定。当 shell 脚本适合执行 post 构建 hook 时,请使用 Script,例如,使用 rake 测试 来运行单元测试。如果您需要控制镜像入口点,或者镜像没有 /bin/sh,请使用 command 和/或 Args。需要 -i 标志来支持使用 Software Collections (SCL)的 CentOS 和 RHEL 镜像,以便在 shell 中启用适当的集合。例如,在 Ruby 镜像中,这是在 PATH 中提供 ruby捆绑包 和其他二进制文件所必需的。

30.3.1.6. .spec.revision

描述
SourceRevision 是构建的源的修订或提交信息
类型
对象
必填
  • type
Expand
属性类型描述

git

对象

GitSourceRevision 是来自构建的 git 源的提交信息

type

字符串

构建源的类型可以是 'Source'、'Dockerfile'、'Binary' 或 'Images' 之一

30.3.1.7. .spec.revision.git

描述
GitSourceRevision 是来自构建的 git 源的提交信息
类型
对象
Expand
属性类型描述

作者

对象

SourceControlUser 定义源控制用户的身份

commit

字符串

commit 是识别特定提交的提交哈希

committer

对象

SourceControlUser 定义源控制用户的身份

message

字符串

Message 是特定提交的描述

30.3.1.8. .spec.revision.git.author

描述
SourceControlUser 定义源控制用户的身份
类型
对象
Expand
属性类型描述

email

字符串

源控制用户的电子邮件

name

字符串

源控制用户的名称

30.3.1.9. .spec.revision.git.committer

描述
SourceControlUser 定义源控制用户的身份
类型
对象
Expand
属性类型描述

email

字符串

源控制用户的电子邮件

name

字符串

源控制用户的名称

30.3.1.10. .spec.source

描述
BuildSource 是用于构建的 SCM。
类型
对象
Expand
属性类型描述

二进制

对象

BinaryBuildSource 描述了用于 Docker 和 Source 构建策略的二进制文件,其中将提取并用作构建源。

configMaps

数组

ConfigMaps 代表用于构建的 configMap 列表及其目的地。

configMaps[]

对象

ConfigMapBuildSource 描述了 configmap 及其目标目录,仅在构建时使用。此处引用的 configmap 的内容将复制到目标目录中,而不是挂载。

contextDir

字符串

contextDir 指定应用程序的源代码所在的子目录。这允许在存储库根目录以外的目录中具有可构建的源。

dockerfile

字符串

Dockerfile 是应构建的 Dockerfile 的原始内容。指定此选项后,可以根据您的策略基础镜像和来自您的策略环境中的其他 ENV 小节来修改 FROM,但您的其余 Dockerfile 小节前面会添加其他 ENV 小节。Dockerfile 源类型可以与 git - 等其他选项一起使用,在这种情况下,Git 仓库将在上下文 dir 中替换任何 innate Dockerfile。

git

对象

GitBuildSource 定义 Git SCM 的参数

images

数组

image 描述了一组镜像,用于为构建提供源

images[]

对象

ImageSource 用于描述将从镜像提取或多阶段构建期间使用的构建源。可以使用 ImageStreamTag、ImageStreamImage 或 DockerImage 类型的引用。可以指定 pull secret 来从外部 registry 拉取镜像,或者在从内部 registry 中拉取时覆盖默认服务帐户 secret。镜像源可用于从镜像中提取内容并将其放在构建上下文中以及存储库源,或者在多阶段容器镜像构建期间直接使用,以允许在不覆盖存储库源内容的情况下复制内容(请参阅 'paths' 和 'as' 字段)。

secrets

数组

secret 代表 secret 列表及其目的地,仅用于构建。

secrets[]

对象

SecretBuildSource 描述了仅在构建时使用的 secret 及其目标目录。此处引用的 secret 的内容将复制到目标目录中,而不是挂载。

sourceSecret

LocalObjectReference_v2

sourceSecret 是 Secret 的名称,用于设置克隆私有存储库的身份验证。secret 包含远程存储库的有效凭据,其中 data 键代表要使用的身份验证方法,value 是 base64 编码的凭据。支持的身份验证方法有:ssh-privatekey。

type

字符串

要接受的构建输入类型

30.3.1.11. .spec.source.binary

描述
BinaryBuildSource 描述了用于 Docker 和 Source 构建策略的二进制文件,其中将提取并用作构建源。
类型
对象
Expand
属性类型描述

asFile

字符串

asFile 表示提供的二进制输入应被视为构建输入中的单个文件。例如,指定 "webapp.war" 会将提供的二进制文件设置为构建器的 /webapp.war。如果留空,Docker 和 Source 构建策略假定此文件是 zip、tar 或 tar.gz 文件,并将其提取为源。自定义策略以标准输入形式接收此二进制文件。这个文件名可能不包含斜杠或为 '..' 或 '.'。

30.3.1.12. .spec.source.configMaps

描述
ConfigMaps 代表用于构建的 configMap 列表及其目的地。
类型
数组

30.3.1.13. .spec.source.configMaps[]

描述
ConfigMapBuildSource 描述了 configmap 及其目标目录,仅在构建时使用。此处引用的 configmap 的内容将复制到目标目录中,而不是挂载。
类型
对象
必填
  • configMap
Expand
属性类型描述

configMap

LocalObjectReference_v2

ConfigMap 是对要在构建中使用的现有 configmap 的引用。

destinationDir

字符串

destinationDir 是 configmap 中的文件应该可用于构建时间的目录。对于 Source 构建策略,它们将注入到运行 assemble 脚本的容器中。对于容器镜像构建策略,它们将复制到构建目录中,其中 Dockerfile 所在的位置,因此用户可以在容器镜像构建过程中 ADD 或 COPY。

30.3.1.14. .spec.source.git

描述
GitBuildSource 定义 Git SCM 的参数
类型
对象
必填
  • uri
Expand
属性类型描述

httpProxy

字符串

httpProxy 是一个代理,用于通过 http 访问 git 存储库

httpsProxy

字符串

httpsProxy 是一个代理,用于通过 https 访问 git 存储库

noProxy

字符串

noProxy 是不使用代理的域列表

ref

字符串

ref 是要构建的分支/标签/ref。

uri

字符串

URI 指向将要构建的源。源的结构将取决于要运行的构建类型

30.3.1.15. .spec.source.images

描述
image 描述了一组镜像,用于为构建提供源
类型
数组

30.3.1.16. .spec.source.images[]

描述
ImageSource 用于描述将从镜像提取或多阶段构建期间使用的构建源。可以使用 ImageStreamTag、ImageStreamImage 或 DockerImage 类型的引用。可以指定 pull secret 来从外部 registry 拉取镜像,或者在从内部 registry 中拉取时覆盖默认服务帐户 secret。镜像源可用于从镜像中提取内容并将其放在构建上下文中以及存储库源,或者在多阶段容器镜像构建期间直接使用,以允许在不覆盖存储库源内容的情况下复制内容(请参阅 'paths' 和 'as' 字段)。
类型
对象
必填
  • from
Expand
属性类型描述

as

数组(字符串)

此源将在多阶段容器镜像构建过程中用于代替的镜像名称列表。例如,使用 "COPY --from=nginx:latest" 的 Dockerfile 首先会在尝试直接拉取前检查此字段中具有"nginx:latest"的镜像源。如果 Dockerfile 没有引用它被忽略的镜像源。此字段和路径可以同时被设置,在这种情况下,内容将使用两次。

from

ObjectReference_v2

from 是从中复制源的 ImageStreamTag、ImageStreamImage 或 DockerImage 的引用。

paths

数组

paths 是要从镜像复制的源和目标路径列表。在开始构建前,此内容将复制到构建上下文中。如果没有设置路径,则不会更改构建上下文。

paths[]

对象

ImageSourcePath 描述了从源镜像及其构建目录中的目的地复制的路径。

pullSecret

LocalObjectReference_v2

pullSecret 是一个引用,用于从 registry 中拉取镜像(如果从 OpenShift registry 中拉取镜像),则不需要设置此字段。

30.3.1.17. .spec.source.images[].paths

描述
paths 是要从镜像复制的源和目标路径列表。在开始构建前,此内容将复制到构建上下文中。如果没有设置路径,则不会更改构建上下文。
类型
数组

30.3.1.18. .spec.source.images[].paths[]

描述
ImageSourcePath 描述了从源镜像及其构建目录中的目的地复制的路径。
类型
对象
必填
  • sourcePath
  • destinationDir
Expand
属性类型描述

destinationDir

字符串

destinationDir 是构建目录中放置从镜像复制文件的相对目录。

sourcePath

字符串

sourcePath 是要复制到构建目录的镜像内的文件或目录的绝对路径。如果源路径以 /. 结尾,则复制目录的内容,但不会在目的地上创建该目录本身。

30.3.1.19. .spec.source.secrets

描述
secret 代表 secret 列表及其目的地,仅用于构建。
类型
数组

30.3.1.20. .spec.source.secrets[]

描述
SecretBuildSource 描述了仅在构建时使用的 secret 及其目标目录。此处引用的 secret 的内容将复制到目标目录中,而不是挂载。
类型
对象
必填
  • secret
Expand
属性类型描述

destinationDir

字符串

destinationDir 是来自 secret 的文件应该可用于构建时间的目录。对于 Source 构建策略,它们将注入到运行 assemble 脚本的容器中。之后,脚本完成后,注入的所有文件都将截断为零长度。对于容器镜像构建策略,它们将复制到构建目录中,其中 Dockerfile 所在的位置,因此用户可以在容器镜像构建过程中 ADD 或 COPY。

secret

LocalObjectReference_v2

secret 是对要在构建中使用的现有 secret 的引用。

30.3.1.21. .spec.strategy

描述
BuildStrategy 包含如何执行构建的详情。
类型
对象
Expand
属性类型描述

customStrategy

对象

CustomBuildStrategy 定义特定于 Custom build 的输入参数。

dockerStrategy

对象

DockerBuildStrategy 定义特定于容器镜像构建的输入参数。

jenkinsPipelineStrategy

对象

JenkinsPipelineBuildStrategy 包含特定于 Jenkins Pipeline 构建的参数。弃用:使用 OpenShift Pipelines

sourceStrategy

对象

SourceBuildStrategy 定义特定于 Source 构建的输入参数。

type

字符串

type 是构建策略的类型。

30.3.1.22. .spec.strategy.customStrategy

描述
CustomBuildStrategy 定义特定于 Custom build 的输入参数。
类型
对象
必填
  • from
Expand
属性类型描述

buildAPIVersion

字符串

buildAPIVersion 是 Build 对象序列化并传递给自定义构建器的请求 API 版本

env

数组(EnvVar_v2)

env 包含您要传递给构建器容器的其他环境变量。

exposeDockerSocket

布尔值

exposeDockerSocket 允许从容器内运行 Docker 命令(和构建容器镜像)。

forcePull

布尔值

forcePull 描述控制器是否应该将构建 Pod 配置为始终拉取构建器的镜像,或仅在本地不存在时拉取(pull)

from

ObjectReference_v2

from 引用了应拉取容器镜像的 DockerImage、ImageStreamTag 或 ImageStreamImage

pullSecret

LocalObjectReference_v2

pullSecret 是 Secret 的名称,用于设置用于从私有 Docker registry 中拉取容器镜像的身份验证

secrets

数组

secret 是构建 pod 中包含的附加 secret 列表

secrets[]

对象

SecretSpec 指定要包含在构建 pod 中的 secret 及其对应的挂载点

30.3.1.23. .spec.strategy.customStrategy.secrets

描述
secret 是构建 pod 中包含的附加 secret 列表
类型
数组

30.3.1.24. .spec.strategy.customStrategy.secrets[]

描述
SecretSpec 指定要包含在构建 pod 中的 secret 及其对应的挂载点
类型
对象
必填
  • secretSource
  • mountPath
Expand
属性类型描述

mountPath

字符串

mountPath 是挂载 secret 的路径

secretSource

LocalObjectReference_v2

secretSource 是对 secret 的引用

30.3.1.25. .spec.strategy.dockerStrategy

描述
DockerBuildStrategy 定义特定于容器镜像构建的输入参数。
类型
对象
Expand
属性类型描述

buildArgs

数组(EnvVar_v2)

buildArgs 包含将在 Dockerfile 中解析的构建参数。详情请查看 https://docs.docker.com/engine/reference/builder/#/arg。注意:只支持 'name' 和 'value' 字段。'valueFrom' 字段中的任何设置都会被忽略。

dockerfilePath

字符串

dockerfilePath 是 Dockerfile 的路径,它将用于构建容器镜像,相对于上下文的根目录(contextDir)。如果未设置,则默认为 Dockerfile

env

数组(EnvVar_v2)

env 包含您要传递给构建器容器的其他环境变量。

forcePull

布尔值

forcePull 描述构建器是否应该在构建前从 registry 拉取镜像。

from

ObjectReference_v2

from 是 DockerImage、ImageStreamTag 或 ImageStreamImage 的引用,可覆盖构建的 Dockerfile 中的 FROM 镜像。如果 Dockerfile 使用多阶段构建,这将替换文件的最后一个 FROM 指令中的镜像。

imageOptimizationPolicy

字符串

imageOptimizationPolicy 描述了系统在构建镜像时可以使用哪些优化,以减少构建镜像的最后大小或时间。默认策略是 'None',这意味着最终构建镜像将等同于容器镜像构建 API 创建的镜像。实验性策略 'SkipLayers' 将避免在每个镜像步骤之间提交新层,如果 Dockerfile 无法提供与"None"策略的兼容性,将失败。额外的实验性策略 'SkipLayersAndWarn' 与 'SkipLayers' 相同,但只是在无法保留兼容性时发出警告。

noCache

布尔值

如果设为 true,则不表示必须使用 --no-cache=true 标志执行容器镜像构建

pullSecret

LocalObjectReference_v2

pullSecret 是 Secret 的名称,用于设置用于从私有 Docker registry 中拉取容器镜像的身份验证

数组

卷是可挂载到构建运行时环境中的输入卷列表。构建只支持 Kubernetes 卷源的子集。更多信息: https://kubernetes.io/docs/concepts/storage/volumes

volumes[]

对象

BuildVolume 描述了用于构建 pod 的卷,以便它可以挂载到 buildah 的运行时环境中。仅支持 Kubernetes 卷源的子集。

30.3.1.26. .spec.strategy.dockerStrategy.volumes

描述
卷是可挂载到构建运行时环境中的输入卷列表。构建只支持 Kubernetes 卷源的子集。更多信息: https://kubernetes.io/docs/concepts/storage/volumes
类型
数组

30.3.1.27. .spec.strategy.dockerStrategy.volumes[]

描述
BuildVolume 描述了用于构建 pod 的卷,以便它可以挂载到 buildah 的运行时环境中。仅支持 Kubernetes 卷源的子集。
类型
对象
必填
  • name
  • source
  • mounts
Expand
属性类型描述

mounts

数组

mount 代表镜像构建容器中的卷位置

mounts[]

对象

BuildVolumeMount 描述了在 buildah 的运行时环境中挂载卷。

name

字符串

name 是此 BuildVolume 的唯一标识符。它必须符合 Kubernetes DNS 标签标准,且在 pod 中是唯一的。与构建控制器添加的内容冲突将导致构建失败,并显示出错信息详细描述哪个名称会导致错误。更多信息: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

source

对象

BuildVolumeSource 代表在任意给定时间仅挂载其受支持的类型的卷源。

30.3.1.28. .spec.strategy.dockerStrategy.volumes[].mounts

描述
mount 代表镜像构建容器中的卷位置
类型
数组

30.3.1.29. .spec.strategy.dockerStrategy.volumes[].mounts[]

描述
BuildVolumeMount 描述了在 buildah 的运行时环境中挂载卷。
类型
对象
必填
  • destinationPath
Expand
属性类型描述

destinationPath

字符串

destinationPath 是应该挂载卷的 buildah 运行时环境中的路径。构建镜像中的临时挂载和后备卷都将被挂载为只读。必须是绝对路径,不得包含 '..' 或 ':',且不得与构建控制器添加的构建器进程路径生成的目标路径冲突,会导致构建失败,并显示出错信息。

30.3.1.30. .spec.strategy.dockerStrategy.volumes[].source

描述
BuildVolumeSource 代表在任意给定时间仅挂载其受支持的类型的卷源。
类型
对象
必填
  • type
Expand
属性类型描述

configMap

ConfigMapVolumeSource

ConfigMap 代表应填充此卷的 ConfigMap

secret

SecretVolumeSource

Secret 代表应填充此卷的 Secret。更多信息: https://kubernetes.io/docs/concepts/storage/volumes#secret

type

字符串

Type 是卷源的 BuildVolumeSourceType。type 必须与填充的卷源匹配。有效类型有: Secret、ConfigMap

30.3.1.31. .spec.strategy.jenkinsPipelineStrategy

描述
JenkinsPipelineBuildStrategy 包含特定于 Jenkins Pipeline 构建的参数。弃用:使用 OpenShift Pipelines
类型
对象
Expand
属性类型描述

env

数组(EnvVar_v2)

env 包含您要传递给构建管道的额外环境变量。

Jenkinsfile

字符串

Jenkinsfile 定义 Jenkinsfile 的可选原始内容,用于定义 Jenkins 管道构建。

jenkinsfilePath

字符串

jenkinsfilePath 是 Jenkinsfile 的可选路径,它将用于配置相对于上下文根目录(contextDir)的管道。如果同时没有指定 JenkinsfilePath 和 Jenkinsfile,则默认为指定 contextDir 根中的 Jenkinsfile。

30.3.1.32. .spec.strategy.sourceStrategy

描述
SourceBuildStrategy 定义特定于 Source 构建的输入参数。
类型
对象
必填
  • from
Expand
属性类型描述

env

数组(EnvVar_v2)

env 包含您要传递给构建器容器的其他环境变量。

forcePull

布尔值

forcePull 描述构建器是否应该在构建前从 registry 拉取镜像。

from

ObjectReference_v2

from 引用了应拉取容器镜像的 DockerImage、ImageStreamTag 或 ImageStreamImage

增量

布尔值

增量标志强制 Source 构建在为 true 时进行增量构建。

pullSecret

LocalObjectReference_v2

pullSecret 是 Secret 的名称,用于设置用于从私有 Docker registry 中拉取容器镜像的身份验证

脚本

字符串

脚本是源脚本的位置

数组

卷是可挂载到构建运行时环境中的输入卷列表。构建只支持 Kubernetes 卷源的子集。更多信息: https://kubernetes.io/docs/concepts/storage/volumes

volumes[]

对象

BuildVolume 描述了用于构建 pod 的卷,以便它可以挂载到 buildah 的运行时环境中。仅支持 Kubernetes 卷源的子集。

30.3.1.33. .spec.strategy.sourceStrategy.volumes

描述
卷是可挂载到构建运行时环境中的输入卷列表。构建只支持 Kubernetes 卷源的子集。更多信息: https://kubernetes.io/docs/concepts/storage/volumes
类型
数组

30.3.1.34. .spec.strategy.sourceStrategy.volumes[]

描述
BuildVolume 描述了用于构建 pod 的卷,以便它可以挂载到 buildah 的运行时环境中。仅支持 Kubernetes 卷源的子集。
类型
对象
必填
  • name
  • source
  • mounts
Expand
属性类型描述

mounts

数组

mount 代表镜像构建容器中的卷位置

mounts[]

对象

BuildVolumeMount 描述了在 buildah 的运行时环境中挂载卷。

name

字符串

name 是此 BuildVolume 的唯一标识符。它必须符合 Kubernetes DNS 标签标准,且在 pod 中是唯一的。与构建控制器添加的内容冲突将导致构建失败,并显示出错信息详细描述哪个名称会导致错误。更多信息: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

source

对象

BuildVolumeSource 代表在任意给定时间仅挂载其受支持的类型的卷源。

30.3.1.35. .spec.strategy.sourceStrategy.volumes[].mounts

描述
mount 代表镜像构建容器中的卷位置
类型
数组

30.3.1.36. .spec.strategy.sourceStrategy.volumes[].mounts[]

描述
BuildVolumeMount 描述了在 buildah 的运行时环境中挂载卷。
类型
对象
必填
  • destinationPath
Expand
属性类型描述

destinationPath

字符串

destinationPath 是应该挂载卷的 buildah 运行时环境中的路径。构建镜像中的临时挂载和后备卷都将被挂载为只读。必须是绝对路径,不得包含 '..' 或 ':',且不得与构建控制器添加的构建器进程路径生成的目标路径冲突,会导致构建失败,并显示出错信息。

30.3.1.37. .spec.strategy.sourceStrategy.volumes[].source

描述
BuildVolumeSource 代表在任意给定时间仅挂载其受支持的类型的卷源。
类型
对象
必填
  • type
Expand
属性类型描述

configMap

ConfigMapVolumeSource

ConfigMap 代表应填充此卷的 ConfigMap

secret

SecretVolumeSource

Secret 代表应填充此卷的 Secret。更多信息: https://kubernetes.io/docs/concepts/storage/volumes#secret

type

字符串

Type 是卷源的 BuildVolumeSourceType。type 必须与填充的卷源匹配。有效类型有: Secret、ConfigMap

30.3.1.38. .spec.triggeredBy

描述
triggerBy 描述了哪些触发器启动对构建配置的最新更新,并包含有关这些触发器的信息。
类型
数组

30.3.1.39. .spec.triggeredBy[]

描述
BuildTriggerCause 包含有关触发构建的信息。它可用于在 oc describe 中显示每个构建和构建配置的构建触发器数据。它还用于描述哪些触发器导致构建配置中最新更新。
类型
对象
Expand
属性类型描述

bitbucketWebHook

对象

BitbucketWebHookCause 包含有关触发构建的 Bitbucket Webhook 的信息。

genericWebHook

对象

GenericWebHookCause 包含有关触发构建的通用 WebHook 的信息。

githubWebHook

对象

GitHubWebHookCause 包含有关触发构建的 GitHub Webhook 的信息。

gitlabWebHook

对象

GitLabWebHookCause 包含有关触发构建的 GitLab Webhook 的信息。

imageChangeBuild

对象

ImageChangeCause 包含有关触发构建的镜像的信息

message

字符串

消息用于存储触发构建的原因的人类可读消息。例如:"Manually trigger by user", "Configuration change",etc.

30.3.1.40. .spec.triggeredBy[].bitbucketWebHook

描述
BitbucketWebHookCause 包含有关触发构建的 Bitbucket Webhook 的信息。
类型
对象
Expand
属性类型描述

revision

对象

SourceRevision 是构建的源的修订或提交信息

secret

字符串

secret 是触发构建的模糊处理 Webhook secret。

30.3.1.41. .spec.triggeredBy[].bitbucketWebHook.revision

描述
SourceRevision 是构建的源的修订或提交信息
类型
对象
必填
  • type
Expand
属性类型描述

git

对象

GitSourceRevision 是来自构建的 git 源的提交信息

type

字符串

构建源的类型可以是 'Source'、'Dockerfile'、'Binary' 或 'Images' 之一

描述
GitSourceRevision 是来自构建的 git 源的提交信息
类型
对象
Expand
属性类型描述

作者

对象

SourceControlUser 定义源控制用户的身份

commit

字符串

commit 是识别特定提交的提交哈希

committer

对象

SourceControlUser 定义源控制用户的身份

message

字符串

Message 是特定提交的描述

描述
SourceControlUser 定义源控制用户的身份
类型
对象
Expand
属性类型描述

email

字符串

源控制用户的电子邮件

name

字符串

源控制用户的名称

描述
SourceControlUser 定义源控制用户的身份
类型
对象
Expand
属性类型描述

email

字符串

源控制用户的电子邮件

name

字符串

源控制用户的名称

30.3.1.45. .spec.triggeredBy[].genericWebHook

描述
GenericWebHookCause 包含有关触发构建的通用 WebHook 的信息。
类型
对象
Expand
属性类型描述

revision

对象

SourceRevision 是构建的源的修订或提交信息

secret

字符串

secret 是触发构建的模糊处理 Webhook secret。

30.3.1.46. .spec.triggeredBy[].genericWebHook.revision

描述
SourceRevision 是构建的源的修订或提交信息
类型
对象
必填
  • type
Expand
属性类型描述

git

对象

GitSourceRevision 是来自构建的 git 源的提交信息

type

字符串

构建源的类型可以是 'Source'、'Dockerfile'、'Binary' 或 'Images' 之一

30.3.1.47. .spec.triggeredBy[].genericWebHook.revision.git

描述
GitSourceRevision 是来自构建的 git 源的提交信息
类型
对象
Expand
属性类型描述

作者

对象

SourceControlUser 定义源控制用户的身份

commit

字符串

commit 是识别特定提交的提交哈希

committer

对象

SourceControlUser 定义源控制用户的身份

message

字符串

Message 是特定提交的描述

描述
SourceControlUser 定义源控制用户的身份
类型
对象
Expand
属性类型描述

email

字符串

源控制用户的电子邮件

name

字符串

源控制用户的名称

描述
SourceControlUser 定义源控制用户的身份
类型
对象
Expand
属性类型描述

email

字符串

源控制用户的电子邮件

name

字符串

源控制用户的名称

30.3.1.50. .spec.triggeredBy[].githubWebHook

描述
GitHubWebHookCause 包含有关触发构建的 GitHub Webhook 的信息。
类型
对象
Expand
属性类型描述

revision

对象

SourceRevision 是构建的源的修订或提交信息

secret

字符串

secret 是触发构建的模糊处理 Webhook secret。

30.3.1.51. .spec.triggeredBy[].githubWebHook.revision

描述
SourceRevision 是构建的源的修订或提交信息
类型
对象
必填
  • type
Expand
属性类型描述

git

对象

GitSourceRevision 是来自构建的 git 源的提交信息

type

字符串

构建源的类型可以是 'Source'、'Dockerfile'、'Binary' 或 'Images' 之一

30.3.1.52. .spec.triggeredBy[].githubWebHook.revision.git

描述
GitSourceRevision 是来自构建的 git 源的提交信息
类型
对象
Expand
属性类型描述

作者

对象

SourceControlUser 定义源控制用户的身份

commit

字符串

commit 是识别特定提交的提交哈希

committer

对象

SourceControlUser 定义源控制用户的身份

message

字符串

Message 是特定提交的描述

描述
SourceControlUser 定义源控制用户的身份
类型
对象
Expand
属性类型描述

email

字符串

源控制用户的电子邮件

name

字符串

源控制用户的名称

描述
SourceControlUser 定义源控制用户的身份
类型
对象
Expand
属性类型描述

email

字符串

源控制用户的电子邮件

name

字符串

源控制用户的名称

30.3.1.55. .spec.triggeredBy[].gitlabWebHook

描述
GitLabWebHookCause 包含有关触发构建的 GitLab Webhook 的信息。
类型
对象
Expand
属性类型描述

revision

对象

SourceRevision 是构建的源的修订或提交信息

secret

字符串

secret 是触发构建的模糊处理 Webhook secret。

30.3.1.56. .spec.triggeredBy[].gitlabWebHook.revision

描述
SourceRevision 是构建的源的修订或提交信息
类型
对象
必填
  • type
Expand
属性类型描述

git

对象

GitSourceRevision 是来自构建的 git 源的提交信息

type

字符串

构建源的类型可以是 'Source'、'Dockerfile'、'Binary' 或 'Images' 之一

30.3.1.57. .spec.triggeredBy[].gitlabWebHook.revision.git

描述
GitSourceRevision 是来自构建的 git 源的提交信息
类型
对象
Expand
属性类型描述

作者

对象

SourceControlUser 定义源控制用户的身份

commit

字符串

commit 是识别特定提交的提交哈希

committer

对象

SourceControlUser 定义源控制用户的身份

message

字符串

Message 是特定提交的描述

描述
SourceControlUser 定义源控制用户的身份
类型
对象
Expand
属性类型描述

email

字符串

源控制用户的电子邮件

name

字符串

源控制用户的名称

描述
SourceControlUser 定义源控制用户的身份
类型
对象
Expand
属性类型描述

email

字符串

源控制用户的电子邮件

name

字符串

源控制用户的名称

30.3.1.60. .spec.triggeredBy[].imageChangeBuild

描述
ImageChangeCause 包含有关触发构建的镜像的信息
类型
对象
Expand
属性类型描述

fromRef

ObjectReference_v2

fromRef 包含有关触发构建的镜像的详细信息。

imageID

字符串

imageID 是触发新构建的镜像的 ID。

30.3.1.61. .status

描述
BuildStatus 包含构建的状态
类型
对象
必填
  • phase
Expand
属性类型描述

Cancelled

布尔值

Cancelled 描述是否为构建触发了 cancel 事件。

completionTimestamp

time

completionTimestamp 是一个时间戳,代表此构建完成后的服务器时间,无论是构建失败还是成功。它反映了运行构建的 Pod 终止的时间。它以 RFC3339 格式表示,并以 UTC 为单位。

conditions

数组

条件代表构建当前状态的最新可用影响。

conditions[]

对象

BuildCondition 描述了构建在特定时间点上的状态。

config

ObjectReference_v2

config 是 BuildConfig 此构建所基于的对象引用。

duration

整数

duration 包含 time.Duration 对象来描述构建时间。

logSnippet

字符串

logSnippet 是构建日志的最后几行。这个值只适用于失败的构建。

message

字符串

Message 是一个人类可读的消息,指示构建有此状态的原因。

output

对象

BuildStatusOutput 包含构建的镜像的状态。

outputDockerImageReference

字符串

outputDockerImageReference 包含对此构建构建的容器镜像的引用。其值从 Build.Spec.Output.To 计算,应包含 registry 地址,以便它可用于推送和拉取镜像。

phase

字符串

phase 是构建生命周期中的点。可能的值有 "New", "Pending", "Running", "Complete", "Failed", "Error", 和 "Cancelled"。

reason

字符串

reason 是一个简短的 CamelCase 字符串,用于描述任何故障,用于在 CLI 中解析和 tidy 显示。

phase

数组

阶段包含有关构建期间发生的每个阶段的详细信息,包括开始时间、持续时间(毫秒)以及每个阶段中发生的步骤。

stages[]

对象

StageInfo 包含有关构建阶段的详细信息。

startTimestamp

time

startTimestamp 是一个时间戳,代表此构建在 Pod 中启动时的服务器时间。它以 RFC3339 格式表示,并以 UTC 为单位。

30.3.1.62. .status.conditions

描述
条件代表构建当前状态的最新可用影响。
类型
array

30.3.1.63. .status.conditions[]

描述
BuildCondition 描述了构建在特定时间点上的状态。
类型
对象
必填
  • type
  • status
Expand
属性类型描述

lastTransitionTime

time

条件从一个状态转换到另一个状态最后一次的时间。

lastUpdateTime

time

最后一次更新此条件的时间。

message

字符串

人类可读的消息,指示有关转换的详细信息。

reason

字符串

条件最后一次转换的原因。

status

字符串

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

type

字符串

构建条件的类型。

30.3.1.64. .status.output

描述
BuildStatusOutput 包含构建的镜像的状态。
类型
对象
Expand
属性类型描述

对象

BuildStatusOutputTo 描述了与要推送的镜像 registry 相关的构建镜像的状态。

30.3.1.65. .status.output.to

描述
BuildStatusOutputTo 描述了与要推送的镜像 registry 相关的构建镜像的状态。
类型
对象
Expand
属性类型描述

imageDigest

字符串

imageDigest 是构建的容器镜像摘要。摘要唯一标识它所推送的 registry 中的镜像。

请注意,即使推送成功完成,也不能始终设置此字段 - 例如,当 registry 没有返回摘要或以构建器不理解的格式返回时。

30.3.1.66. .status.stages

描述
阶段包含有关构建期间发生的每个阶段的详细信息,包括开始时间、持续时间(毫秒)以及每个阶段中发生的步骤。
类型
数组

30.3.1.67. .status.stages[]

描述
StageInfo 包含有关构建阶段的详细信息。
类型
对象
Expand
属性类型描述

durationMilliseconds

整数

durationMilliseconds 标识阶段以毫秒为单位完成所需的时间。注: 阶段的持续时间可能会超过阶段步骤的持续时间,因为并非所有操作都在显式构建步骤中考虑。

name

字符串

name 是发生的每个构建阶段的唯一标识符。

startTime

time

startTime 是一个时间戳,代表此 Stage 启动时服务器时间。它以 RFC3339 格式表示,并以 UTC 为单位。

步骤

数组

步骤包含有关构建阶段发生的每个步骤的详细信息,包括开始时间和持续时间(以毫秒为单位)。

steps[]

对象

StepInfo 包含有关构建步骤的详细信息。

30.3.1.68. .status.stages[].steps

描述
步骤包含有关构建阶段发生的每个步骤的详细信息,包括开始时间和持续时间(以毫秒为单位)。
类型
数组

30.3.1.69. .status.stages[].steps[]

描述
StepInfo 包含有关构建步骤的详细信息。
类型
对象
Expand
属性类型描述

durationMilliseconds

整数

durationMilliseconds 标识步骤以毫秒为单位完成所需的时间。

name

字符串

name 是每个构建步骤的唯一标识符。

startTime

time

startTime 是一个代表服务器时间的时间戳,它以 RFC3339 格式表示,格式为 UTC。

30.3.2. API 端点

可用的 API 端点如下:

  • /apis/build.openshift.io/v1/builds

    • GET: 列出或监视 Build 类型的对象
  • /apis/build.openshift.io/v1/watch/builds

    • GET: 观察对 Build 列表的各个更改。已弃用:改为使用 'watch' 参数和列表操作。
  • /apis/build.openshift.io/v1/namespaces/{namespace}/builds

    • DELETE :删除构建的集合
    • GET: 列出或监视 Build 类型的对象
    • POST :创建构建
  • /apis/build.openshift.io/v1/watch/namespaces/{namespace}/builds

    • GET: 观察对 Build 列表的各个更改。已弃用:改为使用 'watch' 参数和列表操作。
  • /apis/build.openshift.io/v1/namespaces/{namespace}/builds/{name}

    • DELETE :删除构建
    • GET :读取指定的构建
    • PATCH :部分更新指定的构建
    • PUT :替换指定的构建
  • /apis/build.openshift.io/v1/watch/namespaces/{namespace}/builds/{name}

    • GET: 观察对类型为 Build 的对象的更改。已弃用:使用带有列表操作的 'watch' 参数,而是过滤到带有 'fieldSelector' 参数的单个项目。
  • /apis/build.openshift.io/v1/namespaces/{namespace}/builds/{name}/details

    • PUT :替换指定构建的详情
  • /apis/build.openshift.io/v1/namespaces/{namespace}/buildconfigs/{name}/webhooks

    • POST :将 POST 请求连接到 BuildConfig 的 webhook
  • /apis/build.openshift.io/v1/namespaces/{namespace}/buildconfigs/{name}/webhooks/{path}

    • POST :将 POST 请求连接到 BuildConfig 的 webhook

30.3.2.1. /apis/build.openshift.io/v1/builds

Expand
表 30.33. 全局查询参数
参数类型描述

allowWatchBookmarks

布尔值

allowWatchBookmarks请求类型为“BOOKMARK”的监视事件。没有实现书签的服务器可能会忽略这个标志和书签,由服务器自由裁量发送。客户端不应假设书签在任何特定间隔返回,也不会假定服务器在会话期间发送任何 BOOKMARK 事件。如果这不是监视,则忽略此字段。如果 apiserver 中没有启用功能门 WatchBookmarks,则忽略此字段。

继续

字符串

从服务器检索更多结果时,应设置 continue 选项。由于这个值是定义的服务器,因此客户端只能使用之前查询结果中的 continue 值,并带有相同的查询参数(除 continue 值除外),因此服务器可能会拒绝它无法识别的值。如果指定的 continue 值不再有效,无论是因为过期时间(通常为 5 到十五分钟)还是服务器上的配置更改,服务器将会与继续令牌一起响应 410 ResourceExpired 错误。如果客户端需要一致的列表,它必须在没有 continue 字段的情况下重启其列表。否则,客户端可能会发送另一个列表请求,并带有 410 错误收到的令牌,服务器将通过从下一个密钥开始的列表进行响应,但从最新的快照(从最后一个列表结果中不一致) - 在第一个列表请求后创建、修改或删除的对象将包含在响应中,只要其密钥在"next key"后。

当 watch 为 true 时,不支持此字段。客户端可以从服务器返回的最后一个 resourceVersion 值启动监视,而不丢失任何修改。

fieldSelector

字符串

用于限制返回的对象列表的选择器。默认为任何内容。

labelSelector

字符串

通过标签限制返回的对象列表的选择器。默认为任何内容。

limit

整数

限制是列表调用要返回的最大响应数。如果存在更多项目,服务器会将列表元数据上的"continue"字段设置为可用于同一初始查询的值,以检索下一个结果集。在过滤所有请求的对象时,设置限制可能会返回比请求的项目数量少(最多为零项),客户端应只使用 continue 字段的存在来确定是否有更多结果可用。服务器可以选择不支持限制参数,并将返回所有可用的结果。如果指定了限制,并且 continue 字段为空,客户端可能会假设没有更多可用的结果。如果 watch 为 true,则不支持此字段。

服务器保证在使用 continue 时返回的对象与在没有限制的情况下发出单个列表调用相同 - 也就是说,在发出第一个请求后不会创建、修改或删除对象。这有时被称为一致的快照,并确保使用限制的客户端接收一个非常大的结果较小的块可以确保它们看到所有可能的对象。如果在块列出期间更新对象,则返回第一次列表结果时存在的对象版本。

pretty

字符串

如果 'true',则输出被用户友善。

resourceVersion

字符串

resourceVersion 对可能给请求提供服务的资源版本设置一个约束。详情请查看 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

默认为未设置

resourceVersionMatch

字符串

resourceVersionMatch 决定 resourceVersion 如何应用到列出调用。强烈建议您为设置了 resourceVersion 的列表调用设置 resourceVersionMatch。详情请参阅 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

默认为未设置

timeoutSeconds

整数

list/watch 调用的超时。这限制了调用的时间,无论任何活动或不活跃。

watch

布尔值

观察对描述的资源的更改,并将其作为添加、更新和删除通知流返回。指定 resourceVersion。

HTTP 方法
GET
描述
列出或监视类型为 Build 的对象
Expand
表 30.34. HTTP 响应
HTTP 代码响应正文

200 - OK

BuildList 模式

401 - Unauthorized

30.3.2.2. /apis/build.openshift.io/v1/watch/builds

Expand
表 30.35. 全局查询参数
参数类型描述

allowWatchBookmarks

布尔值

allowWatchBookmarks请求类型为“BOOKMARK”的监视事件。没有实现书签的服务器可能会忽略这个标志和书签,由服务器自由裁量发送。客户端不应假设书签在任何特定间隔返回,也不会假定服务器在会话期间发送任何 BOOKMARK 事件。如果这不是监视,则忽略此字段。如果 apiserver 中没有启用功能门 WatchBookmarks,则忽略此字段。

继续

字符串

从服务器检索更多结果时,应设置 continue 选项。由于这个值是定义的服务器,因此客户端只能使用之前查询结果中的 continue 值,并带有相同的查询参数(除 continue 值除外),因此服务器可能会拒绝它无法识别的值。如果指定的 continue 值不再有效,无论是因为过期时间(通常为 5 到十五分钟)还是服务器上的配置更改,服务器将会与继续令牌一起响应 410 ResourceExpired 错误。如果客户端需要一致的列表,它必须在没有 continue 字段的情况下重启其列表。否则,客户端可能会发送另一个列表请求,并带有 410 错误收到的令牌,服务器将通过从下一个密钥开始的列表进行响应,但从最新的快照(从最后一个列表结果中不一致) - 在第一个列表请求后创建、修改或删除的对象将包含在响应中,只要其密钥在"next key"后。

当 watch 为 true 时,不支持此字段。客户端可以从服务器返回的最后一个 resourceVersion 值启动监视,而不丢失任何修改。

fieldSelector

字符串

用于限制返回的对象列表的选择器。默认为任何内容。

labelSelector

字符串

通过标签限制返回的对象列表的选择器。默认为任何内容。

limit

整数

限制是列表调用要返回的最大响应数。如果存在更多项目,服务器会将列表元数据上的"continue"字段设置为可用于同一初始查询的值,以检索下一个结果集。在过滤所有请求的对象时,设置限制可能会返回比请求的项目数量少(最多为零项),客户端应只使用 continue 字段的存在来确定是否有更多结果可用。服务器可以选择不支持限制参数,并将返回所有可用的结果。如果指定了限制,并且 continue 字段为空,客户端可能会假设没有更多可用的结果。如果 watch 为 true,则不支持此字段。

服务器保证在使用 continue 时返回的对象与在没有限制的情况下发出单个列表调用相同 - 也就是说,在发出第一个请求后不会创建、修改或删除对象。这有时被称为一致的快照,并确保使用限制的客户端接收一个非常大的结果较小的块可以确保它们看到所有可能的对象。如果在块列出期间更新对象,则返回第一次列表结果时存在的对象版本。

pretty

字符串

如果 'true',则输出被用户友善。

resourceVersion

字符串

resourceVersion 对可能给请求提供服务的资源版本设置一个约束。详情请查看 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

默认为未设置

resourceVersionMatch

字符串

resourceVersionMatch 决定 resourceVersion 如何应用到列出调用。强烈建议您为设置了 resourceVersion 的列表调用设置 resourceVersionMatch。详情请参阅 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

默认为未设置

timeoutSeconds

整数

list/watch 调用的超时。这限制了调用的时间,无论任何活动或不活跃。

watch

布尔值

观察对描述的资源的更改,并将其作为添加、更新和删除通知流返回。指定 resourceVersion。

HTTP 方法
GET
描述
观察对 Build 列表的各个更改。已弃用:改为使用 'watch' 参数以及 list 操作。
Expand
表 30.36. HTTP 响应
HTTP 代码响应正文

200 - OK

WatchEvent 模式

401 - Unauthorized

Expand
表 30.37. 全局路径参数
参数类型描述

namespace

字符串

对象名称和身份验证范围,如团队和项目

Expand
表 30.38. 全局查询参数
参数类型描述

pretty

字符串

如果 'true',则输出被用户友善。

HTTP 方法
DELETE
描述
删除构建集合
Expand
表 30.39. 查询参数
参数类型描述

继续

字符串

从服务器检索更多结果时,应设置 continue 选项。由于这个值是定义的服务器,因此客户端只能使用之前查询结果中的 continue 值,并带有相同的查询参数(除 continue 值除外),因此服务器可能会拒绝它无法识别的值。如果指定的 continue 值不再有效,无论是因为过期时间(通常为 5 到十五分钟)还是服务器上的配置更改,服务器将会与继续令牌一起响应 410 ResourceExpired 错误。如果客户端需要一致的列表,它必须在没有 continue 字段的情况下重启其列表。否则,客户端可能会发送另一个列表请求,并带有 410 错误收到的令牌,服务器将通过从下一个密钥开始的列表进行响应,但从最新的快照(从最后一个列表结果中不一致) - 在第一个列表请求后创建、修改或删除的对象将包含在响应中,只要其密钥在"next key"后。

当 watch 为 true 时,不支持此字段。客户端可以从服务器返回的最后一个 resourceVersion 值启动监视,而不丢失任何修改。

dryRun

字符串

出现时,表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应,且请求不会被进一步处理。有效值为: - All: 所有预演阶段都将被处理

fieldSelector

字符串

用于限制返回的对象列表的选择器。默认为任何内容。

gracePeriodSeconds

整数

应该删除对象前的持续时间(以秒为单位)。值必须是非负整数。值零表示立即删除。如果这个值是 nil,则使用指定类型的默认宽限期。如果没有指定,则默认为每个对象值。零表示立即删除。

labelSelector

字符串

通过标签限制返回的对象列表的选择器。默认为任何内容。

limit

整数

限制是列表调用要返回的最大响应数。如果存在更多项目,服务器会将列表元数据上的"continue"字段设置为可用于同一初始查询的值,以检索下一个结果集。在过滤所有请求的对象时,设置限制可能会返回比请求的项目数量少(最多为零项),客户端应只使用 continue 字段的存在来确定是否有更多结果可用。服务器可以选择不支持限制参数,并将返回所有可用的结果。如果指定了限制,并且 continue 字段为空,客户端可能会假设没有更多可用的结果。如果 watch 为 true,则不支持此字段。

服务器保证在使用 continue 时返回的对象与在没有限制的情况下发出单个列表调用相同 - 也就是说,在发出第一个请求后不会创建、修改或删除对象。这有时被称为一致的快照,并确保使用限制的客户端接收一个非常大的结果较小的块可以确保它们看到所有可能的对象。如果在块列出期间更新对象,则返回第一次列表结果时存在的对象版本。

orphanDependents

布尔值

弃用:请使用 PropagationPolicy,此字段将在 1.7 中被弃用。应该依赖的对象被孤立。如果为 true/false,"orphan"终结器将从对象的终结器列表添加到/删除。可以设置此字段或 PropagationPolicy,但不能同时设置两者。

propagationPolicy

字符串

是否以及是否执行垃圾回收。此字段或 OrphanDependents 可以设置,但不能同时设置两者。默认策略由 metadata.finalizers 和特定于资源的默认策略中设置的现有终结器决定。可接受的值为: 'Orphan' - 孤立依赖; 'Background' - 允许垃圾收集器在后台删除依赖的依赖关系; 'Foreground' - 一个删除前台所有依赖的级联策略。

resourceVersion

字符串

resourceVersion 对可能给请求提供服务的资源版本设置一个约束。详情请查看 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

默认为未设置

resourceVersionMatch

字符串

resourceVersionMatch 决定 resourceVersion 如何应用到列出调用。强烈建议您为设置了 resourceVersion 的列表调用设置 resourceVersionMatch。详情请参阅 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

默认为未设置

timeoutSeconds

整数

list/watch 调用的超时。这限制了调用的时间,无论任何活动或不活跃。

Expand
表 30.40. 主体参数
参数类型描述

正文(body)

DeleteOptions 模式

 
Expand
表 30.41. HTTP 响应
HTTP 代码响应正文

200 - OK

Status 模式

401 - Unauthorized

HTTP 方法
GET
描述
列出或监视类型为 Build 的对象
Expand
表 30.42. 查询参数
参数类型描述

allowWatchBookmarks

布尔值

allowWatchBookmarks请求类型为“BOOKMARK”的监视事件。没有实现书签的服务器可能会忽略这个标志和书签,由服务器自由裁量发送。客户端不应假设书签在任何特定间隔返回,也不会假定服务器在会话期间发送任何 BOOKMARK 事件。如果这不是监视,则忽略此字段。如果 apiserver 中没有启用功能门 WatchBookmarks,则忽略此字段。

继续

字符串

从服务器检索更多结果时,应设置 continue 选项。由于这个值是定义的服务器,因此客户端只能使用之前查询结果中的 continue 值,并带有相同的查询参数(除 continue 值除外),因此服务器可能会拒绝它无法识别的值。如果指定的 continue 值不再有效,无论是因为过期时间(通常为 5 到十五分钟)还是服务器上的配置更改,服务器将会与继续令牌一起响应 410 ResourceExpired 错误。如果客户端需要一致的列表,它必须在没有 continue 字段的情况下重启其列表。否则,客户端可能会发送另一个列表请求,并带有 410 错误收到的令牌,服务器将通过从下一个密钥开始的列表进行响应,但从最新的快照(从最后一个列表结果中不一致) - 在第一个列表请求后创建、修改或删除的对象将包含在响应中,只要其密钥在"next key"后。

当 watch 为 true 时,不支持此字段。客户端可以从服务器返回的最后一个 resourceVersion 值启动监视,而不丢失任何修改。

fieldSelector

字符串

用于限制返回的对象列表的选择器。默认为任何内容。

labelSelector

字符串

通过标签限制返回的对象列表的选择器。默认为任何内容。

limit

整数

限制是列表调用要返回的最大响应数。如果存在更多项目,服务器会将列表元数据上的"continue"字段设置为可用于同一初始查询的值,以检索下一个结果集。在过滤所有请求的对象时,设置限制可能会返回比请求的项目数量少(最多为零项),客户端应只使用 continue 字段的存在来确定是否有更多结果可用。服务器可以选择不支持限制参数,并将返回所有可用的结果。如果指定了限制,并且 continue 字段为空,客户端可能会假设没有更多可用的结果。如果 watch 为 true,则不支持此字段。

服务器保证在使用 continue 时返回的对象与在没有限制的情况下发出单个列表调用相同 - 也就是说,在发出第一个请求后不会创建、修改或删除对象。这有时被称为一致的快照,并确保使用限制的客户端接收一个非常大的结果较小的块可以确保它们看到所有可能的对象。如果在块列出期间更新对象,则返回第一次列表结果时存在的对象版本。

resourceVersion

字符串

resourceVersion 对可能给请求提供服务的资源版本设置一个约束。详情请查看 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

默认为未设置

resourceVersionMatch

字符串

resourceVersionMatch 决定 resourceVersion 如何应用到列出调用。强烈建议您为设置了 resourceVersion 的列表调用设置 resourceVersionMatch。详情请参阅 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

默认为未设置

timeoutSeconds

整数

list/watch 调用的超时。这限制了调用的时间,无论任何活动或不活跃。

watch

布尔值

观察对描述的资源的更改,并将其作为添加、更新和删除通知流返回。指定 resourceVersion。

Expand
表 30.43. HTTP 响应
HTTP 代码响应正文

200 - OK

BuildList 模式

401 - Unauthorized

HTTP 方法
POST
描述
创建构建
Expand
表 30.44. 查询参数
参数类型描述

dryRun

字符串

出现时,表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应,且请求不会被进一步处理。有效值为: - All: 所有预演阶段都将被处理

fieldManager

字符串

fieldmanager 是与进行这些更改的参与者或实体相关联的名称。该值必须小于或是 128 个字符长,且仅包含可打印的字符,如 https://golang.org/pkg/unicode/#IsPrint 所定义的那样。

Expand
表 30.45. 主体参数
参数类型描述

正文(body)

Build 模式

 
Expand
表 30.46. HTTP 响应
HTTP 代码响应正文

200 - OK

Build 模式

201 - Created

Build 模式

202 - Accepted

Build 模式

401 - Unauthorized

Expand
表 30.47. 全局路径参数
参数类型描述

namespace

字符串

对象名称和身份验证范围,如团队和项目

Expand
表 30.48. 全局查询参数
参数类型描述

allowWatchBookmarks

布尔值

allowWatchBookmarks请求类型为“BOOKMARK”的监视事件。没有实现书签的服务器可能会忽略这个标志和书签,由服务器自由裁量发送。客户端不应假设书签在任何特定间隔返回,也不会假定服务器在会话期间发送任何 BOOKMARK 事件。如果这不是监视,则忽略此字段。如果 apiserver 中没有启用功能门 WatchBookmarks,则忽略此字段。

继续

字符串

从服务器检索更多结果时,应设置 continue 选项。由于这个值是定义的服务器,因此客户端只能使用之前查询结果中的 continue 值,并带有相同的查询参数(除 continue 值除外),因此服务器可能会拒绝它无法识别的值。如果指定的 continue 值不再有效,无论是因为过期时间(通常为 5 到十五分钟)还是服务器上的配置更改,服务器将会与继续令牌一起响应 410 ResourceExpired 错误。如果客户端需要一致的列表,它必须在没有 continue 字段的情况下重启其列表。否则,客户端可能会发送另一个列表请求,并带有 410 错误收到的令牌,服务器将通过从下一个密钥开始的列表进行响应,但从最新的快照(从最后一个列表结果中不一致) - 在第一个列表请求后创建、修改或删除的对象将包含在响应中,只要其密钥在"next key"后。

当 watch 为 true 时,不支持此字段。客户端可以从服务器返回的最后一个 resourceVersion 值启动监视,而不丢失任何修改。

fieldSelector

字符串

用于限制返回的对象列表的选择器。默认为任何内容。

labelSelector

字符串

通过标签限制返回的对象列表的选择器。默认为任何内容。

limit

整数

限制是列表调用要返回的最大响应数。如果存在更多项目,服务器会将列表元数据上的"continue"字段设置为可用于同一初始查询的值,以检索下一个结果集。在过滤所有请求的对象时,设置限制可能会返回比请求的项目数量少(最多为零项),客户端应只使用 continue 字段的存在来确定是否有更多结果可用。服务器可以选择不支持限制参数,并将返回所有可用的结果。如果指定了限制,并且 continue 字段为空,客户端可能会假设没有更多可用的结果。如果 watch 为 true,则不支持此字段。

服务器保证在使用 continue 时返回的对象与在没有限制的情况下发出单个列表调用相同 - 也就是说,在发出第一个请求后不会创建、修改或删除对象。这有时被称为一致的快照,并确保使用限制的客户端接收一个非常大的结果较小的块可以确保它们看到所有可能的对象。如果在块列出期间更新对象,则返回第一次列表结果时存在的对象版本。

pretty

字符串

如果 'true',则输出被用户友善。

resourceVersion

字符串

resourceVersion 对可能给请求提供服务的资源版本设置一个约束。详情请查看 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

默认为未设置

resourceVersionMatch

字符串

resourceVersionMatch 决定 resourceVersion 如何应用到列出调用。强烈建议您为设置了 resourceVersion 的列表调用设置 resourceVersionMatch。详情请参阅 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

默认为未设置

timeoutSeconds

整数

list/watch 调用的超时。这限制了调用的时间,无论任何活动或不活跃。

watch

布尔值

观察对描述的资源的更改,并将其作为添加、更新和删除通知流返回。指定 resourceVersion。

HTTP 方法
GET
描述
观察对 Build 列表的各个更改。已弃用:改为使用 'watch' 参数以及 list 操作。
Expand
表 30.49. HTTP 响应
HTTP 代码响应正文

200 - OK

WatchEvent 模式

401 - Unauthorized

Expand
表 30.50. 全局路径参数
参数类型描述

name

字符串

构建的名称

namespace

字符串

对象名称和身份验证范围,如团队和项目

Expand
表 30.51. 全局查询参数
参数类型描述

pretty

字符串

如果 'true',则输出被用户友善。

HTTP 方法
DELETE
描述
删除构建
Expand
表 30.52. 查询参数
参数类型描述

dryRun

字符串

出现时,表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应,且请求不会被进一步处理。有效值为: - All: 所有预演阶段都将被处理

gracePeriodSeconds

整数

应该删除对象前的持续时间(以秒为单位)。值必须是非负整数。值零表示立即删除。如果这个值是 nil,则使用指定类型的默认宽限期。如果没有指定,则默认为每个对象值。零表示立即删除。

orphanDependents

布尔值

弃用:请使用 PropagationPolicy,此字段将在 1.7 中被弃用。应该依赖的对象被孤立。如果为 true/false,"orphan"终结器将从对象的终结器列表添加到/删除。可以设置此字段或 PropagationPolicy,但不能同时设置两者。

propagationPolicy

字符串

是否以及是否执行垃圾回收。此字段或 OrphanDependents 可以设置,但不能同时设置两者。默认策略由 metadata.finalizers 和特定于资源的默认策略中设置的现有终结器决定。可接受的值为: 'Orphan' - 孤立依赖; 'Background' - 允许垃圾收集器在后台删除依赖的依赖关系; 'Foreground' - 一个删除前台所有依赖的级联策略。

Expand
表 30.53. 主体参数
参数类型描述

正文(body)

DeleteOptions 模式

 
Expand
表 30.54. HTTP 响应
HTTP 代码响应正文

200 - OK

Status 模式

202 - Accepted

Status 模式

401 - Unauthorized

HTTP 方法
GET
描述
读取指定的构建
Expand
表 30.55. HTTP 响应
HTTP 代码响应正文

200 - OK

Build 模式

401 - Unauthorized

HTTP 方法
PATCH
描述
部分更新指定的构建
Expand
表 30.56. 查询参数
参数类型描述

dryRun

字符串

出现时,表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应,且请求不会被进一步处理。有效值为: - All: 所有预演阶段都将被处理

fieldManager

字符串

fieldmanager 是与进行这些更改的参与者或实体相关联的名称。该值必须小于或是 128 个字符长,且仅包含可打印的字符,如 https://golang.org/pkg/unicode/#IsPrint 所定义的那样。应用请求(application/apply-patch)需要此字段,但对于非应用补丁类型(JsonPatch、MergePatch、OptMergePatch)是可选的。

force

布尔值

强制将"强制"应用请求。这意味着用户会重新清空由其他人员拥有的冲突字段。对于非应用补丁请求,必须取消设置 force 标志。

Expand
表 30.57. 主体参数
参数类型描述

正文(body)

Patch 模式

 
Expand
表 30.58. HTTP 响应
HTTP 代码响应正文

200 - OK

Build 模式

401 - Unauthorized

HTTP 方法
PUT
描述
替换指定的构建
Expand
表 30.59. 查询参数
参数类型描述

dryRun

字符串

出现时,表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应,且请求不会被进一步处理。有效值为: - All: 所有预演阶段都将被处理

fieldManager

字符串

fieldmanager 是与进行这些更改的参与者或实体相关联的名称。该值必须小于或是 128 个字符长,且仅包含可打印的字符,如 https://golang.org/pkg/unicode/#IsPrint 所定义的那样。

Expand
表 30.60. 主体参数
参数类型描述

正文(body)

Build 模式

 
Expand
表 30.61. HTTP 响应
HTTP 代码响应正文

200 - OK

Build 模式

201 - Created

Build 模式

401 - Unauthorized

Expand
表 30.62. 全局路径参数
参数类型描述

name

字符串

构建的名称

namespace

字符串

对象名称和身份验证范围,如团队和项目

Expand
表 30.63. 全局查询参数
参数类型描述

allowWatchBookmarks

布尔值

allowWatchBookmarks请求类型为“BOOKMARK”的监视事件。没有实现书签的服务器可能会忽略这个标志和书签,由服务器自由裁量发送。客户端不应假设书签在任何特定间隔返回,也不会假定服务器在会话期间发送任何 BOOKMARK 事件。如果这不是监视,则忽略此字段。如果 apiserver 中没有启用功能门 WatchBookmarks,则忽略此字段。

继续

字符串

从服务器检索更多结果时,应设置 continue 选项。由于这个值是定义的服务器,因此客户端只能使用之前查询结果中的 continue 值,并带有相同的查询参数(除 continue 值除外),因此服务器可能会拒绝它无法识别的值。如果指定的 continue 值不再有效,无论是因为过期时间(通常为 5 到十五分钟)还是服务器上的配置更改,服务器将会与继续令牌一起响应 410 ResourceExpired 错误。如果客户端需要一致的列表,它必须在没有 continue 字段的情况下重启其列表。否则,客户端可能会发送另一个列表请求,并带有 410 错误收到的令牌,服务器将通过从下一个密钥开始的列表进行响应,但从最新的快照(从最后一个列表结果中不一致) - 在第一个列表请求后创建、修改或删除的对象将包含在响应中,只要其密钥在"next key"后。

当 watch 为 true 时,不支持此字段。客户端可以从服务器返回的最后一个 resourceVersion 值启动监视,而不丢失任何修改。

fieldSelector

字符串

用于限制返回的对象列表的选择器。默认为任何内容。

labelSelector

字符串

通过标签限制返回的对象列表的选择器。默认为任何内容。

limit

整数

限制是列表调用要返回的最大响应数。如果存在更多项目,服务器会将列表元数据上的"continue"字段设置为可用于同一初始查询的值,以检索下一个结果集。在过滤所有请求的对象时,设置限制可能会返回比请求的项目数量少(最多为零项),客户端应只使用 continue 字段的存在来确定是否有更多结果可用。服务器可以选择不支持限制参数,并将返回所有可用的结果。如果指定了限制,并且 continue 字段为空,客户端可能会假设没有更多可用的结果。如果 watch 为 true,则不支持此字段。

服务器保证在使用 continue 时返回的对象与在没有限制的情况下发出单个列表调用相同 - 也就是说,在发出第一个请求后不会创建、修改或删除对象。这有时被称为一致的快照,并确保使用限制的客户端接收一个非常大的结果较小的块可以确保它们看到所有可能的对象。如果在块列出期间更新对象,则返回第一次列表结果时存在的对象版本。

pretty

字符串

如果 'true',则输出被用户友善。

resourceVersion

字符串

resourceVersion 对可能给请求提供服务的资源版本设置一个约束。详情请查看 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

默认为未设置

resourceVersionMatch

字符串

resourceVersionMatch 决定 resourceVersion 如何应用到列出调用。强烈建议您为设置了 resourceVersion 的列表调用设置 resourceVersionMatch。详情请参阅 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

默认为未设置

timeoutSeconds

整数

list/watch 调用的超时。这限制了调用的时间,无论任何活动或不活跃。

watch

布尔值

观察对描述的资源的更改,并将其作为添加、更新和删除通知流返回。指定 resourceVersion。

HTTP 方法
GET
描述
观察对类型为 Build 的对象的更改。已弃用:使用带有列表操作的 'watch' 参数,而是过滤到带有 'fieldSelector' 参数的单个项目。
Expand
表 30.64. HTTP 响应
HTTP 代码响应正文

200 - OK

WatchEvent 模式

401 - Unauthorized

Expand
表 30.65. 全局路径参数
参数类型描述

name

字符串

构建的名称

namespace

字符串

对象名称和身份验证范围,如团队和项目

Expand
表 30.66. 全局查询参数
参数类型描述

dryRun

字符串

出现时,表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应,且请求不会被进一步处理。有效值为: - All: 所有预演阶段都将被处理

fieldManager

字符串

fieldmanager 是与进行这些更改的参与者或实体相关联的名称。该值必须小于或是 128 个字符长,且仅包含可打印的字符,如 https://golang.org/pkg/unicode/#IsPrint 所定义的那样。

pretty

字符串

如果 'true',则输出被用户友善。

HTTP 方法
PUT
描述
替换指定构建的详情
Expand
表 30.67. 主体参数
参数类型描述

正文(body)

Build 模式

 
Expand
表 30.68. HTTP 响应
HTTP 代码响应正文

200 - OK

Build 模式

201 - Created

Build 模式

401 - Unauthorized

Expand
表 30.69. 全局路径参数
参数类型描述

name

字符串

构建的名称

namespace

字符串

对象名称和身份验证范围,如团队和项目

Expand
表 30.70. 全局查询参数
参数类型描述

path

字符串

path 是用于到 pod 的当前代理请求的 URL 路径。

HTTP 方法
POST
描述
将 POST 请求连接到 BuildConfig 的 webhook
Expand
表 30.71. HTTP 响应
HTTP 代码响应正文

200 - OK

字符串

401 - 未授权

Expand
表 30.72. 全局路径参数
参数类型描述

name

字符串

构建的名称

namespace

字符串

对象名称和身份验证范围,如团队和项目

path

字符串

资源的路径

Expand
表 30.73. 全局查询参数
参数类型描述

path

字符串

path 是用于到 pod 的当前代理请求的 URL 路径。

HTTP 方法
POST
描述
将 POST 请求连接到 BuildConfig 的 webhook
Expand
表 30.74. HTTP 响应
HTTP 代码响应正文

200 - OK

字符串

401 - 未授权

返回顶部
Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

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

让开源更具包容性

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

關於紅帽

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

Theme

© 2025 Red Hat