第 5 章 BuildRequest [build.openshift.io/v1]
- 描述
BuildRequest 是用来传递参数到构建生成器的资源
兼容性级别 1：在主发行版本中至少提供 12 个月或 3 个次版本（以更长的时间为准）。
- 类型
-
对象
5.1. 规格
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| APIVersion 定义对象的这个表示法的版本化的 schema。服务器应该将识别的模式转换为最新的内部值，并可拒绝未识别的值。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources |
|
|
| BinaryBuildSource 描述了用于 Docker 和 Source 构建策略的二进制文件，该文件将提取并用作构建源。 |
|
|
| DockerStrategyOptions 包含容器镜像构建的额外策略选项 |
|
| env 包含您要传递给构建器容器的额外环境变量。 | |
|
| from 是触发构建的 ImageStreamTag 的引用。 | |
|
|
| kind 是一个字符串值，代表此对象所代表的 REST 资源。服务器可以从客户端向其提交请求的端点推断。无法更新。采用驼峰拼写法 (CamelCase)。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
|
|
| lastVersion （可选）是用于生成构建的 BuildConfig 的 LastVersion。如果生成器中的 BuildConfig 不匹配，则不会生成构建。 |
|
| metadata 是标准对象的元数据。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata | |
|
|
| SourceRevision 是构建的修订或提交信息 |
|
|
| SourceStrategyOptions 包含 Source 构建的额外策略选项 |
|
|
| triggeredBy 描述了哪些触发器启动对构建配置的最新更新，并包含有关这些触发器的信息。 |
|
|
| BuildTriggerCause 包含有关触发的构建的信息。它用于显示 oc describe 中每个构建的构建触发器数据。它还用于描述导致构建配置中最近更新哪些触发器。 |
|
| triggeredByImage 是触发此构建的镜像。 |
5.1.1. .binary
- 描述
- BinaryBuildSource 描述了用于 Docker 和 Source 构建策略的二进制文件，该文件将提取并用作构建源。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
|
asFile 表示提供的二进制输入应被视为构建输入中的一个文件。例如，指定"webapp.war"会将提供的二进制文件放在构建器的 |
5.1.2. .dockerStrategyOptions
- 描述
- DockerStrategyOptions 包含容器镜像构建的额外策略选项
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
| args 包含要传递给 Docker 的任何构建参数。详情请查看 https://docs.docker.com/engine/reference/builder/#/arg | |
|
|
| noCache 覆盖构建配置中的 docker-strategy noCache 选项 |
5.1.3. .revision
- 描述
- SourceRevision 是构建的修订或提交信息
- 类型
-
object - 必填
-
type
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| GitSourceRevision 是构建的 git 源的提交信息 |
|
|
| 构建源的类型可以是 'Source', 'Dockerfile', 'Binary', 或 'Images' 之一 |
5.1.4. .revision.git
- 描述
- GitSourceRevision 是构建的 git 源的提交信息
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| SourceControlUser 定义源控制用户的身份 |
|
|
| commit 是标识特定提交的提交哈希 |
|
|
| SourceControlUser 定义源控制用户的身份 |
|
|
| message 是特定提交的描述 |
5.1.5. .revision.git.author
- 描述
- SourceControlUser 定义源控制用户的身份
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 源控制用户的电子邮件 |
|
|
| 源控制用户的名称 |
5.1.6. .revision.git.committer
- 描述
- SourceControlUser 定义源控制用户的身份
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 源控制用户的电子邮件 |
|
|
| 源控制用户的名称 |
5.1.7. .sourceStrategyOptions
- 描述
- SourceStrategyOptions 包含 Source 构建的额外策略选项
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 增量覆盖构建配置中的 source-strategy 增量选项 |
5.1.8. .triggeredBy
- 描述
- triggeredBy 描述了哪些触发器启动对构建配置的最新更新，并包含有关这些触发器的信息。
- 类型
-
数组
5.1.9. .triggeredBy[]
- 描述
- BuildTriggerCause 包含有关触发的构建的信息。它用于显示 oc describe 中每个构建的构建触发器数据。它还用于描述导致构建配置中最近更新哪些触发器。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| BitbucketWebHookCause 包含有关触发构建的 Bitbucket Webhook 的信息。 |
|
|
| GenericWebHookCause 包含有关触发构建的通用 WebHook 的信息。 |
|
|
| GitHubWebHookCause 包含有关触发构建的 GitHub Webhook 的信息。 |
|
|
| GitLabWebHookCause 包含有关触发构建的 GitLab Webhook 的信息。 |
|
|
| ImageChangeCause 包含有关触发构建的镜像的信息 |
|
|
| 消息用于存储触发构建的原因的人类可读消息。例如："手动由 user"触发，"配置更改"，etc. |
5.1.10. .triggeredBy[].bitbucketWebHook
- 描述
- BitbucketWebHookCause 包含有关触发构建的 Bitbucket Webhook 的信息。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| SourceRevision 是构建的修订或提交信息 |
|
|
| secret 是触发构建的模糊的 webhook secret。 |
5.1.11. .triggeredBy[].bitbucketWebHook.revision
- 描述
- SourceRevision 是构建的修订或提交信息
- 类型
-
object - 必填
-
type
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| GitSourceRevision 是构建的 git 源的提交信息 |
|
|
| 构建源的类型可以是 'Source', 'Dockerfile', 'Binary', 或 'Images' 之一 |
5.1.12. .triggeredBy[].bitbucketWebHook.revision.git
- 描述
- GitSourceRevision 是构建的 git 源的提交信息
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| SourceControlUser 定义源控制用户的身份 |
|
|
| commit 是标识特定提交的提交哈希 |
|
|
| SourceControlUser 定义源控制用户的身份 |
|
|
| message 是特定提交的描述 |
5.1.13. .triggeredBy[].bitbucketWebHook.revision.git.author
- 描述
- SourceControlUser 定义源控制用户的身份
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 源控制用户的电子邮件 |
|
|
| 源控制用户的名称 |
5.1.14. .triggeredBy[].bitbucketWebHook.revision.git.committer
- 描述
- SourceControlUser 定义源控制用户的身份
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 源控制用户的电子邮件 |
|
|
| 源控制用户的名称 |
5.1.15. .triggeredBy[].genericWebHook
- 描述
- GenericWebHookCause 包含有关触发构建的通用 WebHook 的信息。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| SourceRevision 是构建的修订或提交信息 |
|
|
| secret 是触发构建的模糊的 webhook secret。 |
5.1.16. .triggeredBy[].genericWebHook.revision
- 描述
- SourceRevision 是构建的修订或提交信息
- 类型
-
object - 必填
-
type
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| GitSourceRevision 是构建的 git 源的提交信息 |
|
|
| 构建源的类型可以是 'Source', 'Dockerfile', 'Binary', 或 'Images' 之一 |
5.1.17. .triggeredBy[].genericWebHook.revision.git
- 描述
- GitSourceRevision 是构建的 git 源的提交信息
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| SourceControlUser 定义源控制用户的身份 |
|
|
| commit 是标识特定提交的提交哈希 |
|
|
| SourceControlUser 定义源控制用户的身份 |
|
|
| message 是特定提交的描述 |
5.1.18. .triggeredBy[].genericWebHook.revision.git.author
- 描述
- SourceControlUser 定义源控制用户的身份
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 源控制用户的电子邮件 |
|
|
| 源控制用户的名称 |
5.1.19. .triggeredBy[].genericWebHook.revision.git.committer
- 描述
- SourceControlUser 定义源控制用户的身份
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 源控制用户的电子邮件 |
|
|
| 源控制用户的名称 |
5.1.20. .triggeredBy[].githubWebHook
- 描述
- GitHubWebHookCause 包含有关触发构建的 GitHub Webhook 的信息。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| SourceRevision 是构建的修订或提交信息 |
|
|
| secret 是触发构建的模糊的 webhook secret。 |
5.1.21. .triggeredBy[].githubWebHook.revision
- 描述
- SourceRevision 是构建的修订或提交信息
- 类型
-
object - 必填
-
type
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| GitSourceRevision 是构建的 git 源的提交信息 |
|
|
| 构建源的类型可以是 'Source', 'Dockerfile', 'Binary', 或 'Images' 之一 |
5.1.22. .triggeredBy[].githubWebHook.revision.git
- 描述
- GitSourceRevision 是构建的 git 源的提交信息
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| SourceControlUser 定义源控制用户的身份 |
|
|
| commit 是标识特定提交的提交哈希 |
|
|
| SourceControlUser 定义源控制用户的身份 |
|
|
| message 是特定提交的描述 |
5.1.23. .triggeredBy[].githubWebHook.revision.git.author
- 描述
- SourceControlUser 定义源控制用户的身份
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 源控制用户的电子邮件 |
|
|
| 源控制用户的名称 |
5.1.24. .triggeredBy[].githubWebHook.revision.git.committer
- 描述
- SourceControlUser 定义源控制用户的身份
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 源控制用户的电子邮件 |
|
|
| 源控制用户的名称 |
5.1.25. .triggeredBy[].gitlabWebHook
- 描述
- GitLabWebHookCause 包含有关触发构建的 GitLab Webhook 的信息。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| SourceRevision 是构建的修订或提交信息 |
|
|
| secret 是触发构建的模糊的 webhook secret。 |
5.1.26. .triggeredBy[].gitlabWebHook.revision
- 描述
- SourceRevision 是构建的修订或提交信息
- 类型
-
object - 必填
-
type
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| GitSourceRevision 是构建的 git 源的提交信息 |
|
|
| 构建源的类型可以是 'Source', 'Dockerfile', 'Binary', 或 'Images' 之一 |
5.1.27. .triggeredBy[].gitlabWebHook.revision.git
- 描述
- GitSourceRevision 是构建的 git 源的提交信息
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| SourceControlUser 定义源控制用户的身份 |
|
|
| commit 是标识特定提交的提交哈希 |
|
|
| SourceControlUser 定义源控制用户的身份 |
|
|
| message 是特定提交的描述 |
5.1.28. .triggeredBy[].gitlabWebHook.revision.git.author
- 描述
- SourceControlUser 定义源控制用户的身份
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 源控制用户的电子邮件 |
|
|
| 源控制用户的名称 |
5.1.29. .triggeredBy[].gitlabWebHook.revision.git.committer
- 描述
- SourceControlUser 定义源控制用户的身份
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 源控制用户的电子邮件 |
|
|
| 源控制用户的名称 |
5.1.30. .triggeredBy[].imageChangeBuild
- 描述
- ImageChangeCause 包含有关触发构建的镜像的信息
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
| fromRef 包含有关触发构建的镜像的详细信息。 | |
|
|
| imageID 是触发新构建的镜像的 ID。 |
