第5章 BuildRequest [build.openshift.io/v1]
- Description
BuildRequest は、ビルドジェネレーターにパラメーターを渡すのに使用されるリソースです。
互換性レベル 1: メジャーリリース内で最低 12 か月または 3 つのマイナーリリース (どちらか長い方) の間安定しています。
- タイプ
-
object
5.1. 仕様
| プロパティー | タイプ | 説明 |
|---|---|---|
|
|
| APIVersion はオブジェクトのこの表現のバージョンスキーマを定義します。サーバーは認識されたスキーマを最新の内部値に変換し、認識されない値は拒否することがあります。詳細は、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 が一致しない場合、ビルドは生成されません。 |
|
| ||
|
|
| SourceRevision は、ビルドのソースからのリビジョンまたはコミット情報です |
|
|
| SourceStrategyOptions には、Source ビルド用の追加の戦略オプションが含まれています |
|
|
| triggeredBy は、ビルド設定の最新の更新を開始したトリガーを記述し、そのトリガーに関する情報を含みます。 |
|
|
| BuildTriggerCause は、トリガーされたビルドに関する情報を保持します。これは、oc describe の各ビルドおよびビルド設定のビルドトリガーデータを表示するのに使用されます。また、ビルド設定の最新の更新につながったトリガーを説明するためにも使用されます。 |
|
| triggeredByImage は、このビルドをトリガーしたイメージです。 |
5.1.1. .binary
- Description
- BinaryBuildSource は、Docker および Source ビルドストラテジーに使用されるバイナリーファイルを記述します。ファイルは抽出され、ビルドソースとして使用されます。
- タイプ
-
object
| プロパティー | タイプ | Description |
|---|---|---|
|
|
|
asFile は、提供されたバイナリー入力がビルド入力内の単一ファイルと見なされる必要があることを示します。たとえば、webapp.war を指定すると、提供されたバイナリーがビルダーの |
5.1.2. .dockerStrategyOptions
- Description
- DockerStrategyOptions には、コンテナーイメージビルド用の追加の戦略オプションが含まれています
- タイプ
-
object
| プロパティー | タイプ | Description |
|---|---|---|
|
| Args には、Docker に渡されるビルド引数が含まれています。詳細については、https://docs.docker.com/engine/reference/builder/#/arg を参照してください | |
|
|
| noCache は、ビルド設定の docker-strategy noCache オプションをオーバーライドします |
5.1.3. .revision
- Description
- SourceRevision は、ビルドのソースからのリビジョンまたはコミット情報です
- タイプ
-
object - 必須
-
type
-
| プロパティー | タイプ | Description |
|---|---|---|
|
|
| GitSourceRevision は、ビルド用の git ソースからのコミット情報です。 |
|
|
| ビルドソースのタイプ。Source、Dockerfile、Binary、または Images のいずれかになります。 |
5.1.4. .revision.git
- Description
- GitSourceRevision は、ビルド用の git ソースからのコミット情報です。
- タイプ
-
object
| プロパティー | タイプ | Description |
|---|---|---|
|
|
| SourceControlUser は、ソース管理のユーザーの ID を定義します。 |
|
|
| commit は、特定のコミットを識別するコミットハッシュです。 |
|
|
| SourceControlUser は、ソース管理のユーザーの ID を定義します。 |
|
|
| メッセージは特定のコミットの説明です |
5.1.5. .revision.git.author
- Description
- SourceControlUser は、ソース管理のユーザーの ID を定義します。
- タイプ
-
object
| プロパティー | タイプ | Description |
|---|---|---|
|
|
| ソース管理ユーザーの電子メール |
|
|
| ソース管理ユーザーの名前 |
5.1.6. .revision.git.committer
- Description
- SourceControlUser は、ソース管理のユーザーの ID を定義します。
- タイプ
-
object
| プロパティー | タイプ | Description |
|---|---|---|
|
|
| ソース管理ユーザーの電子メール |
|
|
| ソース管理ユーザーの名前 |
5.1.7. .sourceStrategyOptions
- Description
- SourceStrategyOptions には、Source ビルド用の追加の戦略オプションが含まれています
- タイプ
-
object
| プロパティー | タイプ | Description |
|---|---|---|
|
|
| 増分は、ビルド設定のソース戦略増分オプションをオーバーライドします |
5.1.8. .triggeredBy
- Description
- triggeredBy は、ビルド設定の最新の更新を開始したトリガーを記述し、そのトリガーに関する情報を含みます。
- タイプ
-
array
5.1.9. .triggeredBy[]
- Description
- BuildTriggerCause は、トリガーされたビルドに関する情報を保持します。これは、oc describe の各ビルドおよびビルド設定のビルドトリガーデータを表示するのに使用されます。また、ビルド設定の最新の更新につながったトリガーを説明するためにも使用されます。
- タイプ
-
object
| プロパティー | タイプ | Description |
|---|---|---|
|
|
| BitbucketWebHookCause には、ビルドをトリガーした Bitbucket Webhook に関する情報があります。 |
|
|
| GenericWebHookCause は、ビルドをトリガーした汎用 WebHook に関する情報を保持します。 |
|
|
| GitHubWebHookCause には、ビルドをトリガーした GitHub Webhook に関する情報があります。 |
|
|
| GitLabWebHookCause には、ビルドをトリガーした GitLab Webhook に関する情報があります。 |
|
|
| ImageChangeCause には、ビルドをトリガーしたイメージに関する情報が含まれています |
|
|
| message は、ビルドがトリガーされた理由に関する人間が読めるメッセージを格納するために使用されます。たとえば、"Manually triggered by user"、"Configuration change" などです。 |
5.1.10. .triggeredBy[].bitbucketWebHook
- Description
- BitbucketWebHookCause には、ビルドをトリガーした Bitbucket Webhook に関する情報があります。
- タイプ
-
object
| プロパティー | タイプ | Description |
|---|---|---|
|
|
| SourceRevision は、ビルドのソースからのリビジョンまたはコミット情報です |
|
|
| Secret は、ビルドのトリガーとなった難読化された Webhook シークレットです。 |
5.1.11. .triggeredBy[].bitbucketWebHook.revision
- Description
- SourceRevision は、ビルドのソースからのリビジョンまたはコミット情報です
- タイプ
-
object - 必須
-
type
-
| プロパティー | タイプ | Description |
|---|---|---|
|
|
| GitSourceRevision は、ビルド用の git ソースからのコミット情報です。 |
|
|
| ビルドソースのタイプ。Source、Dockerfile、Binary、または Images のいずれかになります。 |
5.1.12. .triggeredBy[].bitbucketWebHook.revision.git
- Description
- GitSourceRevision は、ビルド用の git ソースからのコミット情報です。
- タイプ
-
object
| プロパティー | タイプ | Description |
|---|---|---|
|
|
| SourceControlUser は、ソース管理のユーザーの ID を定義します。 |
|
|
| commit は、特定のコミットを識別するコミットハッシュです。 |
|
|
| SourceControlUser は、ソース管理のユーザーの ID を定義します。 |
|
|
| メッセージは特定のコミットの説明です |
5.1.13. .triggeredBy[].bitbucketWebHook.revision.git.author
- Description
- SourceControlUser は、ソース管理のユーザーの ID を定義します。
- タイプ
-
object
| プロパティー | タイプ | Description |
|---|---|---|
|
|
| ソース管理ユーザーの電子メール |
|
|
| ソース管理ユーザーの名前 |
5.1.14. .triggeredBy[].bitbucketWebHook.revision.git.committer
- Description
- SourceControlUser は、ソース管理のユーザーの ID を定義します。
- タイプ
-
object
| プロパティー | タイプ | Description |
|---|---|---|
|
|
| ソース管理ユーザーの電子メール |
|
|
| ソース管理ユーザーの名前 |
5.1.15. .triggeredBy[].genericWebHook
- Description
- GenericWebHookCause は、ビルドをトリガーした汎用 WebHook に関する情報を保持します。
- タイプ
-
object
| プロパティー | タイプ | Description |
|---|---|---|
|
|
| SourceRevision は、ビルドのソースからのリビジョンまたはコミット情報です |
|
|
| secret は、ビルドをトリガーした難読化された Webhook シークレットです。 |
5.1.16. .triggeredBy[].genericWebHook.revision
- Description
- SourceRevision は、ビルドのソースからのリビジョンまたはコミット情報です
- タイプ
-
object - 必須
-
type
-
| プロパティー | タイプ | Description |
|---|---|---|
|
|
| GitSourceRevision は、ビルド用の git ソースからのコミット情報です。 |
|
|
| ビルドソースのタイプ。Source、Dockerfile、Binary、または Images のいずれかになります。 |
5.1.17. .triggeredBy[].genericWebHook.revision.git
- Description
- GitSourceRevision は、ビルド用の git ソースからのコミット情報です。
- タイプ
-
object
| プロパティー | タイプ | Description |
|---|---|---|
|
|
| SourceControlUser は、ソース管理のユーザーの ID を定義します。 |
|
|
| commit は、特定のコミットを識別するコミットハッシュです。 |
|
|
| SourceControlUser は、ソース管理のユーザーの ID を定義します。 |
|
|
| メッセージは特定のコミットの説明です |
5.1.18. .triggeredBy[].genericWebHook.revision.git.author
- Description
- SourceControlUser は、ソース管理のユーザーの ID を定義します。
- タイプ
-
object
| プロパティー | タイプ | Description |
|---|---|---|
|
|
| ソース管理ユーザーの電子メール |
|
|
| ソース管理ユーザーの名前 |
5.1.19. .triggeredBy[].genericWebHook.revision.git.committer
- Description
- SourceControlUser は、ソース管理のユーザーの ID を定義します。
- タイプ
-
object
| プロパティー | タイプ | Description |
|---|---|---|
|
|
| ソース管理ユーザーの電子メール |
|
|
| ソース管理ユーザーの名前 |
5.1.20. .triggeredBy[].githubWebHook
- Description
- GitHubWebHookCause には、ビルドをトリガーした GitHub Webhook に関する情報があります。
- タイプ
-
object
| プロパティー | タイプ | Description |
|---|---|---|
|
|
| SourceRevision は、ビルドのソースからのリビジョンまたはコミット情報です |
|
|
| secret は、ビルドをトリガーした難読化された Webhook シークレットです。 |
5.1.21. .triggeredBy[].githubWebHook.revision
- Description
- SourceRevision は、ビルドのソースからのリビジョンまたはコミット情報です
- タイプ
-
object - 必須
-
type
-
| プロパティー | タイプ | Description |
|---|---|---|
|
|
| GitSourceRevision は、ビルド用の git ソースからのコミット情報です。 |
|
|
| ビルドソースのタイプ。Source、Dockerfile、Binary、または Images のいずれかになります。 |
5.1.22. .triggeredBy[].githubWebHook.revision.git
- Description
- GitSourceRevision は、ビルド用の git ソースからのコミット情報です。
- タイプ
-
object
| プロパティー | タイプ | Description |
|---|---|---|
|
|
| SourceControlUser は、ソース管理のユーザーの ID を定義します。 |
|
|
| commit は、特定のコミットを識別するコミットハッシュです。 |
|
|
| SourceControlUser は、ソース管理のユーザーの ID を定義します。 |
|
|
| メッセージは特定のコミットの説明です |
5.1.23. .triggeredBy[].githubWebHook.revision.git.author
- Description
- SourceControlUser は、ソース管理のユーザーの ID を定義します。
- タイプ
-
object
| プロパティー | タイプ | Description |
|---|---|---|
|
|
| ソース管理ユーザーの電子メール |
|
|
| ソース管理ユーザーの名前 |
5.1.24. .triggeredBy[].githubWebHook.revision.git.committer
- Description
- SourceControlUser は、ソース管理のユーザーの ID を定義します。
- タイプ
-
object
| プロパティー | タイプ | Description |
|---|---|---|
|
|
| ソース管理ユーザーの電子メール |
|
|
| ソース管理ユーザーの名前 |
5.1.25. .triggeredBy[].gitlabWebHook
- Description
- GitLabWebHookCause には、ビルドをトリガーした GitLab Webhook に関する情報があります。
- タイプ
-
object
| プロパティー | タイプ | Description |
|---|---|---|
|
|
| SourceRevision は、ビルドのソースからのリビジョンまたはコミット情報です |
|
|
| Secret は、ビルドのトリガーとなった難読化された Webhook シークレットです。 |
5.1.26. .triggeredBy[].gitlabWebHook.revision
- Description
- SourceRevision は、ビルドのソースからのリビジョンまたはコミット情報です
- タイプ
-
object - 必須
-
type
-
| プロパティー | タイプ | Description |
|---|---|---|
|
|
| GitSourceRevision は、ビルド用の git ソースからのコミット情報です。 |
|
|
| ビルドソースのタイプ。Source、Dockerfile、Binary、または Images のいずれかになります。 |
5.1.27. .triggeredBy[].gitlabWebHook.revision.git
- Description
- GitSourceRevision は、ビルド用の git ソースからのコミット情報です。
- タイプ
-
object
| プロパティー | タイプ | Description |
|---|---|---|
|
|
| SourceControlUser は、ソース管理のユーザーの ID を定義します。 |
|
|
| commit は、特定のコミットを識別するコミットハッシュです。 |
|
|
| SourceControlUser は、ソース管理のユーザーの ID を定義します。 |
|
|
| メッセージは特定のコミットの説明です |
5.1.28. .triggeredBy[].gitlabWebHook.revision.git.author
- Description
- SourceControlUser は、ソース管理のユーザーの ID を定義します。
- タイプ
-
object
| プロパティー | タイプ | Description |
|---|---|---|
|
|
| ソース管理ユーザーの電子メール |
|
|
| ソース管理ユーザーの名前 |
5.1.29. .triggeredBy[].gitlabWebHook.revision.git.committer
- Description
- SourceControlUser は、ソース管理のユーザーの ID を定義します。
- タイプ
-
object
| プロパティー | タイプ | Description |
|---|---|---|
|
|
| ソース管理ユーザーの電子メール |
|
|
| ソース管理ユーザーの名前 |
5.1.30. .triggeredBy[].imageChangeBuild
- Description
- ImageChangeCause には、ビルドをトリガーしたイメージに関する情報が含まれています
- タイプ
-
object
| プロパティー | タイプ | Description |
|---|---|---|
|
| fromRef には、ビルドをトリガーしたイメージに関する詳細情報が含まれています。 | |
|
|
| imageID は、新しいビルドをトリガーしたイメージの ID です。 |
