30.2. BuildConfig [build.openshift.io/v1]

completionDeadlineSeconds

整数

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

failedBuildsHistoryLimit

整数

failedBuildsHistoryLimit 是要保留的旧失败构建数量。创建 BuildConfig 时，除非设置了此值，否则将保留 5 个最近失败的构建。如果在 BuildConfig 创建后移除，则会保留所有失败的构建。

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 是构建的源的修订或提交信息

runPolicy

字符串

runPolicy 描述了从此构建配置创建的新构建如何调度来执行。如果没有指定，则这是可选的，则默认为 "Serial"。

serviceAccount

字符串

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

source

对象

BuildSource 是用于构建的 SCM。

策略

对象

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

successfulBuildsHistoryLimit

整数

successfulBuildsHistoryLimit 是要保留的旧成功构建数量。创建 BuildConfig 时，除非设置了此值，否则将保留 5 个最新的成功构建。如果在 BuildConfig 创建后移除，则会保留所有成功构建。

触发器

数组

触发器决定了如何从 BuildConfig 启动新构建。如果没有定义触发器，则只能在明确创建客户端构建时发生新构建。

triggers[]

对象

BuildTriggerPolicy 描述了单个触发器的策略，它生成新的构建。

imageLabels

数组

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

imageLabels[]

对象

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

pushSecret

LocalObjectReference_v2

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

to

ObjectReference_v2

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

name

字符串

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

value

字符串

value 定义标签的字面值。

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、捆绑包 和其他二进制文件所必需的。

git

对象

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

type

字符串

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

作者

对象

SourceControlUser 定义源控制用户的身份

commit

字符串

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

committer

对象

SourceControlUser 定义源控制用户的身份

message

字符串

Message 是特定提交的描述

email

字符串

源控制用户的电子邮件

name

字符串

源控制用户的名称

email

字符串

源控制用户的电子邮件

name

字符串

源控制用户的名称

二进制

对象

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

字符串

要接受的构建输入类型

asFile

字符串

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

configMap

LocalObjectReference_v2

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

destinationDir

字符串

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

httpProxy

字符串

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

httpsProxy

字符串

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

noProxy

字符串

noProxy 是不使用代理的域列表

ref

字符串

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

uri

字符串

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

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 中拉取镜像），则不需要设置此字段。

destinationDir

字符串

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

sourcePath

字符串

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

destinationDir

字符串

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

secret

LocalObjectReference_v2

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

customStrategy

对象

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

dockerStrategy

对象

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

jenkinsPipelineStrategy

对象

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

sourceStrategy

对象

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

type

字符串

type 是构建策略的类型。

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 及其对应的挂载点

mountPath

字符串

mountPath 是挂载 secret 的路径

secretSource

LocalObjectReference_v2

secretSource 是对 secret 的引用

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 卷源的子集。

mounts

数组

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

mounts[]

对象

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

name

字符串

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

source

对象

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

destinationPath

字符串

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

configMap

ConfigMapVolumeSource

ConfigMap 代表应填充此卷的 ConfigMap

secret

SecretVolumeSource

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

type

字符串

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

env

数组(EnvVar_v2)

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

Jenkinsfile

字符串

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

jenkinsfilePath

字符串

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

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 卷源的子集。

mounts

数组

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

mounts[]

对象

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

name

字符串

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

source

对象

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

destinationPath

字符串

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

configMap

ConfigMapVolumeSource

ConfigMap 代表应填充此卷的 ConfigMap

secret

SecretVolumeSource

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

type

字符串

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

bitbucket

对象

WebHookTrigger 是一个触发器，它使用 webhook 类型 post 调用

generic

对象

WebHookTrigger 是一个触发器，它使用 webhook 类型 post 调用

github

对象

WebHookTrigger 是一个触发器，它使用 webhook 类型 post 调用

gitlab

对象

WebHookTrigger 是一个触发器，它使用 webhook 类型 post 调用

imageChange

对象

ImageChangeTrigger 允许在 ImageStream 更改时触发构建

type

字符串

type 是构建触发器的类型。有效值：

- GitHubWebHookBuildTriggerType 代表在 GitHub Webhook 调用上启动构建的触发器

- generic GenericWebHookBuildTriggerType 代表在通用 Webhook 调用上启动构建的触发器

- GitLab GitLabWebHookBuildTriggerType 代表在 GitLab Webhook 调用上启动构建的触发器

- BitbucketWebHookBuildTriggerType 代表在 Bitbucket Webhook 调用上启动构建的触发器

- ImageChange ImageChangeBuildTriggerType 代表一个触发器，它基于镜像的新版本启动构建

- ConfigChange ConfigChangeBuildTriggerType 将在初始构建配置创建警告时触发构建：未来的行为将更改以在任何配置更改时触发构建

allowEnv

布尔值

allowEnv 确定 Webhook 是否可以设置环境变量；对于 GenericWebHook，只能设置为 true。

secret

字符串

用于验证请求的 secret。弃用： 使用 SecretReference 替代。

secretReference

对象

SecretLocalReference 包含指向使用的本地 secret 的信息

name

字符串

name 是所引用同一命名空间中的资源名称

allowEnv

布尔值

allowEnv 确定 Webhook 是否可以设置环境变量；对于 GenericWebHook，只能设置为 true。

secret

字符串

用于验证请求的 secret。弃用： 使用 SecretReference 替代。

secretReference

对象

SecretLocalReference 包含指向使用的本地 secret 的信息

name

字符串

name 是所引用同一命名空间中的资源名称

allowEnv

布尔值

allowEnv 确定 Webhook 是否可以设置环境变量；对于 GenericWebHook，只能设置为 true。

secret

字符串

用于验证请求的 secret。弃用： 使用 SecretReference 替代。

secretReference

对象

SecretLocalReference 包含指向使用的本地 secret 的信息

name

字符串

name 是所引用同一命名空间中的资源名称

allowEnv

布尔值

allowEnv 确定 Webhook 是否可以设置环境变量；对于 GenericWebHook，只能设置为 true。

secret

字符串

用于验证请求的 secret。弃用： 使用 SecretReference 替代。

secretReference

对象

SecretLocalReference 包含指向使用的本地 secret 的信息

name

字符串

name 是所引用同一命名空间中的资源名称

from

ObjectReference_v2

from 是对 ImageStreamTag 的引用，它会在更新时触发构建，它是可选的。如果没有指定 From，则使用构建策略中的 from 镜像。构建配置中只允许一个带有空的 From 引用的 ImageChangeTrigger。

lastTriggeredImageID

字符串

lastTriggeredImageID 由 ImageChangeController 在内部用来保存构建此字段的最后使用的镜像 ID 已被弃用，并将在以后的发行版本中删除。已弃用

paused

布尔值

如果临时禁用此触发器，则暂停为 true。可选。

imageChangeTriggers

数组

imageChangeTriggers 捕获 BuildConfigSpec 中指定的任何 ImageChangeTrigger 的运行时状态，包括由 OpenShift APIServer 为 lastTriggeredImageID 协调的值。此数组中每个镜像更改触发器都有一个条目。每个触发器状态都会引用作为触发器源的 ImageStreamTag。

imageChangeTriggers[]

对象

ImageChangeTriggerStatus 跟踪 BuildConfigSpec.Triggers struct 中指定的关联 ImageChangeTrigger 策略的最新解析状态。

lastVersion

整数

lastVersion 用于告知最后一次触发的构建数量。

from

对象

ImageStreamTagReference 根据命名空间和名称引用镜像更改触发器中的 ImageStreamTag。

lastTriggerTime

time

lastTriggerTime 是此特定 ImageStreamTag 最后一次触发构建来启动的时间。只有在此触发器专门启动构建时才会更新此字段。

lastTriggeredImageID

字符串

当启动此 BuildConfig 的构建时，lastTriggeredImageID 代表 ImageStreamTag 的 sha/id。每次启动此 BuildConfig 的构建时，lastTriggeredImageID 都会更新，即使此 ImageStreamTag 不是启动构建的原因。

name

字符串

name 是 ImageChangeTrigger 的 ImageStreamTag 的名称

namespace

字符串

namespace 是 ImageChangeTrigger 的 ImageStreamTag 所在的命名空间

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。

200 - OK

BuildConfigList schema

401 - Unauthorized

空

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。

200 - OK

WatchEvent 模式

401 - Unauthorized

空

namespace

字符串

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

pretty

字符串

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

继续

字符串

从服务器检索更多结果时，应设置 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 调用的超时。这限制了调用的时间，无论任何活动或不活跃。

正文（body）

DeleteOptions 模式

200 - OK

Status 模式

401 - Unauthorized

空

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。

200 - OK

BuildConfigList schema

401 - Unauthorized

空

dryRun

字符串

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

fieldManager

字符串

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

正文（body）

BuildConfig schema

200 - OK

BuildConfig schema

201 - Created

BuildConfig schema

202 - Accepted

BuildConfig schema

401 - Unauthorized

空

namespace

字符串

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

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。

200 - OK

WatchEvent 模式

401 - Unauthorized

空

name

字符串

BuildConfig 的名称

namespace

字符串

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

pretty

字符串

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

dryRun

字符串

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

gracePeriodSeconds

整数

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

orphanDependents

布尔值

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

propagationPolicy

字符串

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

正文（body）

DeleteOptions 模式

200 - OK

Status 模式

202 - Accepted

Status 模式

401 - Unauthorized

空

200 - OK

BuildConfig schema

401 - Unauthorized

空

dryRun

字符串

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

fieldManager

字符串

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

force

布尔值

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

正文（body）

Patch 模式

200 - OK

BuildConfig schema

401 - Unauthorized

空

dryRun

字符串

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

fieldManager

字符串

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

正文（body）

BuildConfig schema

200 - OK

BuildConfig schema

201 - Created

BuildConfig schema

401 - Unauthorized

空

name

字符串

BuildConfig 的名称

namespace

字符串

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

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。

200 - OK

WatchEvent 模式

401 - Unauthorized

空