30.5. BuildRequest [build.openshift.io/v1]


Description
BuildRequest は、ビルドジェネレーターにパラメーターを渡すのに使用されるリソースです。
タイプ
object

30.5.1. 仕様

Expand
プロパティータイプ説明

apiVersion

string

APIVersion はオブジェクトのこの表現のバージョンスキーマを定義します。サーバーは認識されたスキーマを最新の内部値に変換し、認識されない値は拒否することがあります。詳細は、https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources を参照してください。

バイナリー

object

BinaryBuildSource は、Docker および Source ビルドストラテジーに使用されるバイナリーファイルを記述します。ファイルは抽出され、ビルドソースとして使用されます。

dockerStrategyOptions

object

DockerStrategyOptions には、コンテナーイメージビルド用の追加の戦略オプションが含まれています

env

array (EnvVar_v2)

env には、ビルダーコンテナーに渡す追加の環境変数が含まれています。

from

ObjectReference_v2

from は、ビルドをトリガーした ImageStreamTag への参照です。

kind

string

kind はこのオブジェクトが表す REST リソースを表す文字列の値です。サーバーはクライアントが要求を送信するエンドポイントからこれを推測できることがあります。これを更新することはできません。CamelCase詳細については、https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds を参照してください。

lastVersion

integer

lastVersion (オプション) は、ビルドの生成に使用された BuildConfig の LastVersion です。ジェネレーターの BuildConfig が一致しない場合、ビルドは生成されません。

metadata

ObjectMeta

 

revision

object

SourceRevision は、ビルドのソースからのリビジョンまたはコミット情報です

sourceStrategyOptions

object

SourceStrategyOptions には、Source ビルド用の追加の戦略オプションが含まれています

triggeredBy

array

triggeredBy は、ビルド設定の最新の更新を開始したトリガーを記述し、そのトリガーに関する情報を含みます。

triggeredBy[]

object

BuildTriggerCause は、トリガーされたビルドに関する情報を保持します。これは、oc describe の各ビルドおよびビルド設定のビルドトリガーデータを表示するのに使用されます。また、ビルド設定の最新の更新につながったトリガーを説明するためにも使用されます。

triggeredByImage

ObjectReference_v2

triggeredByImage は、このビルドをトリガーしたイメージです。

30.5.1.1. .binary

Description
BinaryBuildSource は、Docker および Source ビルドストラテジーに使用されるバイナリーファイルを記述します。ファイルは抽出され、ビルドソースとして使用されます。
タイプ
object
Expand
プロパティータイプDescription

asFile

string

asFile は、提供されたバイナリー入力がビルド入力内の単一ファイルと見なされる必要があることを示します。たとえば、webapp.war を指定すると、提供されたバイナリーがビルダーの /webapp.war として配置されます。空のままにした場合、Docker および Source ビルド戦略は、このファイルが zip、tar、または tar.gz ファイルであると想定し、ソースとして抽出します。カスタム戦略は、このバイナリーを標準入力として受け取ります。このファイル名にはスラッシュを含めたり、.. または.にすることはできません。

30.5.1.2. .dockerStrategyOptions

Description
DockerStrategyOptions には、コンテナーイメージビルド用の追加の戦略オプションが含まれています
タイプ
object
Expand
プロパティータイプDescription

buildArgs

array (EnvVar_v2)

Args には、Docker に渡されるビルド引数が含まれています。詳細については、https://docs.docker.com/engine/reference/builder/#/arg を参照してください

noCache

boolean

noCache は、ビルド設定の docker-strategy noCache オプションをオーバーライドします

30.5.1.3. .revision

Description
SourceRevision は、ビルドのソースからのリビジョンまたはコミット情報です
タイプ
object
必須
  • type
Expand
プロパティータイプDescription

git

object

GitSourceRevision は、ビルド用の git ソースからのコミット情報です。

type

string

ビルドソースのタイプ。Source、Dockerfile、Binary、または Images のいずれかになります。

30.5.1.4. .revision.git

Description
GitSourceRevision は、ビルド用の git ソースからのコミット情報です。
タイプ
object
Expand
プロパティータイプDescription

author

object

SourceControlUser は、ソース管理のユーザーの ID を定義します。

commit

string

commit は、特定のコミットを識別するコミットハッシュです。

committer

object

SourceControlUser は、ソース管理のユーザーの ID を定義します。

message

string

メッセージは特定のコミットの説明です

30.5.1.5. .revision.git.author

Description
SourceControlUser は、ソース管理のユーザーの ID を定義します。
タイプ
object
Expand
プロパティータイプDescription

email

string

ソース管理ユーザーの電子メール

name

string

ソース管理ユーザーの名前

30.5.1.6. .revision.git.committer

Description
SourceControlUser は、ソース管理のユーザーの ID を定義します。
タイプ
object
Expand
プロパティータイプDescription

email

string

ソース管理ユーザーの電子メール

name

string

ソース管理ユーザーの名前

30.5.1.7. .sourceStrategyOptions

Description
SourceStrategyOptions には、Source ビルド用の追加の戦略オプションが含まれています
タイプ
object
Expand
プロパティータイプDescription

incremental

boolean

増分は、ビルド設定のソース戦略増分オプションをオーバーライドします

30.5.1.8. .triggeredBy

Description
triggeredBy は、ビルド設定の最新の更新を開始したトリガーを記述し、そのトリガーに関する情報を含みます。
タイプ
array

30.5.1.9. .triggeredBy[]

Description
BuildTriggerCause は、トリガーされたビルドに関する情報を保持します。これは、oc describe の各ビルドおよびビルド設定のビルドトリガーデータを表示するのに使用されます。また、ビルド設定の最新の更新につながったトリガーを説明するためにも使用されます。
タイプ
object
Expand
プロパティータイプDescription

bitbucketWebHook

object

BitbucketWebHookCause には、ビルドをトリガーした Bitbucket Webhook に関する情報があります。

genericWebHook

object

GenericWebHookCause は、ビルドをトリガーした汎用 WebHook に関する情報を保持します。

githubWebHook

object

GitHubWebHookCause には、ビルドをトリガーした GitHub Webhook に関する情報があります。

gitlabWebHook

object

GitLabWebHookCause には、ビルドをトリガーした GitLab Webhook に関する情報があります。

imageChangeBuild

object

ImageChangeCause には、ビルドをトリガーしたイメージに関する情報が含まれています

message

string

message は、ビルドがトリガーされた理由に関する人間が読めるメッセージを格納するために使用されます。たとえば、"Manually triggered by user"、"Configuration change" などです。

30.5.1.10. .triggeredBy[].bitbucketWebHook

Description
BitbucketWebHookCause には、ビルドをトリガーした Bitbucket Webhook に関する情報があります。
タイプ
object
Expand
プロパティータイプDescription

revision

object

SourceRevision は、ビルドのソースからのリビジョンまたはコミット情報です

secret

string

Secret は、ビルドのトリガーとなった難読化された Webhook シークレットです。

30.5.1.11. .triggeredBy[].bitbucketWebHook.revision

Description
SourceRevision は、ビルドのソースからのリビジョンまたはコミット情報です
タイプ
object
必須
  • type
Expand
プロパティータイプDescription

git

object

GitSourceRevision は、ビルド用の git ソースからのコミット情報です。

type

string

ビルドソースのタイプ。Source、Dockerfile、Binary、または Images のいずれかになります。

30.5.1.12. .triggeredBy[].bitbucketWebHook.revision.git

Description
GitSourceRevision は、ビルド用の git ソースからのコミット情報です。
タイプ
object
Expand
プロパティータイプDescription

author

object

SourceControlUser は、ソース管理のユーザーの ID を定義します。

commit

string

commit は、特定のコミットを識別するコミットハッシュです。

committer

object

SourceControlUser は、ソース管理のユーザーの ID を定義します。

message

string

メッセージは特定のコミットの説明です

30.5.1.13. .triggeredBy[].bitbucketWebHook.revision.git.author

Description
SourceControlUser は、ソース管理のユーザーの ID を定義します。
タイプ
object
Expand
プロパティータイプDescription

email

string

ソース管理ユーザーの電子メール

name

string

ソース管理ユーザーの名前

30.5.1.14. .triggeredBy[].bitbucketWebHook.revision.git.committer

Description
SourceControlUser は、ソース管理のユーザーの ID を定義します。
タイプ
object
Expand
プロパティータイプDescription

email

string

ソース管理ユーザーの電子メール

name

string

ソース管理ユーザーの名前

30.5.1.15. .triggeredBy[].genericWebHook

Description
GenericWebHookCause は、ビルドをトリガーした汎用 WebHook に関する情報を保持します。
タイプ
object
Expand
プロパティータイプDescription

revision

object

SourceRevision は、ビルドのソースからのリビジョンまたはコミット情報です

secret

string

secret は、ビルドをトリガーした難読化された Webhook シークレットです。

30.5.1.16. .triggeredBy[].genericWebHook.revision

Description
SourceRevision は、ビルドのソースからのリビジョンまたはコミット情報です
タイプ
object
必須
  • type
Expand
プロパティータイプDescription

git

object

GitSourceRevision は、ビルド用の git ソースからのコミット情報です。

type

string

ビルドソースのタイプ。Source、Dockerfile、Binary、または Images のいずれかになります。

30.5.1.17. .triggeredBy[].genericWebHook.revision.git

Description
GitSourceRevision は、ビルド用の git ソースからのコミット情報です。
タイプ
object
Expand
プロパティータイプDescription

author

object

SourceControlUser は、ソース管理のユーザーの ID を定義します。

commit

string

commit は、特定のコミットを識別するコミットハッシュです。

committer

object

SourceControlUser は、ソース管理のユーザーの ID を定義します。

message

string

メッセージは特定のコミットの説明です

30.5.1.18. .triggeredBy[].genericWebHook.revision.git.author

Description
SourceControlUser は、ソース管理のユーザーの ID を定義します。
タイプ
object
Expand
プロパティータイプDescription

email

string

ソース管理ユーザーの電子メール

name

string

ソース管理ユーザーの名前

30.5.1.19. .triggeredBy[].genericWebHook.revision.git.committer

Description
SourceControlUser は、ソース管理のユーザーの ID を定義します。
タイプ
object
Expand
プロパティータイプDescription

email

string

ソース管理ユーザーの電子メール

name

string

ソース管理ユーザーの名前

30.5.1.20. .triggeredBy[].githubWebHook

Description
GitHubWebHookCause には、ビルドをトリガーした GitHub Webhook に関する情報があります。
タイプ
object
Expand
プロパティータイプDescription

revision

object

SourceRevision は、ビルドのソースからのリビジョンまたはコミット情報です

secret

string

secret は、ビルドをトリガーした難読化された Webhook シークレットです。

30.5.1.21. .triggeredBy[].githubWebHook.revision

Description
SourceRevision は、ビルドのソースからのリビジョンまたはコミット情報です
タイプ
object
必須
  • type
Expand
プロパティータイプDescription

git

object

GitSourceRevision は、ビルド用の git ソースからのコミット情報です。

type

string

ビルドソースのタイプ。Source、Dockerfile、Binary、または Images のいずれかになります。

30.5.1.22. .triggeredBy[].githubWebHook.revision.git

Description
GitSourceRevision は、ビルド用の git ソースからのコミット情報です。
タイプ
object
Expand
プロパティータイプDescription

author

object

SourceControlUser は、ソース管理のユーザーの ID を定義します。

commit

string

commit は、特定のコミットを識別するコミットハッシュです。

committer

object

SourceControlUser は、ソース管理のユーザーの ID を定義します。

message

string

メッセージは特定のコミットの説明です

30.5.1.23. .triggeredBy[].githubWebHook.revision.git.author

Description
SourceControlUser は、ソース管理のユーザーの ID を定義します。
タイプ
object
Expand
プロパティータイプDescription

email

string

ソース管理ユーザーの電子メール

name

string

ソース管理ユーザーの名前

30.5.1.24. .triggeredBy[].githubWebHook.revision.git.committer

Description
SourceControlUser は、ソース管理のユーザーの ID を定義します。
タイプ
object
Expand
プロパティータイプDescription

email

string

ソース管理ユーザーの電子メール

name

string

ソース管理ユーザーの名前

30.5.1.25. .triggeredBy[].gitlabWebHook

Description
GitLabWebHookCause には、ビルドをトリガーした GitLab Webhook に関する情報があります。
タイプ
object
Expand
プロパティータイプDescription

revision

object

SourceRevision は、ビルドのソースからのリビジョンまたはコミット情報です

secret

string

Secret は、ビルドのトリガーとなった難読化された Webhook シークレットです。

30.5.1.26. .triggeredBy[].gitlabWebHook.revision

Description
SourceRevision は、ビルドのソースからのリビジョンまたはコミット情報です
タイプ
object
必須
  • type
Expand
プロパティータイプDescription

git

object

GitSourceRevision は、ビルド用の git ソースからのコミット情報です。

type

string

ビルドソースのタイプ。Source、Dockerfile、Binary、または Images のいずれかになります。

30.5.1.27. .triggeredBy[].gitlabWebHook.revision.git

Description
GitSourceRevision は、ビルド用の git ソースからのコミット情報です。
タイプ
object
Expand
プロパティータイプDescription

author

object

SourceControlUser は、ソース管理のユーザーの ID を定義します。

commit

string

commit は、特定のコミットを識別するコミットハッシュです。

committer

object

SourceControlUser は、ソース管理のユーザーの ID を定義します。

message

string

メッセージは特定のコミットの説明です

30.5.1.28. .triggeredBy[].gitlabWebHook.revision.git.author

Description
SourceControlUser は、ソース管理のユーザーの ID を定義します。
タイプ
object
Expand
プロパティータイプDescription

email

string

ソース管理ユーザーの電子メール

name

string

ソース管理ユーザーの名前

30.5.1.29. .triggeredBy[].gitlabWebHook.revision.git.committer

Description
SourceControlUser は、ソース管理のユーザーの ID を定義します。
タイプ
object
Expand
プロパティータイプDescription

email

string

ソース管理ユーザーの電子メール

name

string

ソース管理ユーザーの名前

30.5.1.30. .triggeredBy[].imageChangeBuild

Description
ImageChangeCause には、ビルドをトリガーしたイメージに関する情報が含まれています
タイプ
object
Expand
プロパティータイプDescription

fromRef

ObjectReference_v2

fromRef には、ビルドをトリガーしたイメージに関する詳細情報が含まれています。

imageID

string

imageID は、新しいビルドをトリガーしたイメージの ID です。

30.5.2. API エンドポイント

以下の API エンドポイントを利用できます。

  • /apis/build.openshift.io/v1/namespaces/{namespace}/builds/{name}/clone

    • POST: Build のクローンを作成する
  • /apis/build.openshift.io/v1/namespaces/{namespace}/buildconfigs/{name}/instantiate

    • POST: BuildConfig のインスタンス化を作成する

30.5.2.1. /apis/build.openshift.io/v1/namespaces/{namespace}/builds/{name}/clone

Expand
表30.78 グローバルパスパラメーター
パラメータータイプ説明

name

string

BuildRequest の名前

namespace

string

チームやプロジェクトなどのオブジェクト名と認証スコープ

Expand
表30.79 グローバルクエリーパラメーター
パラメータータイプ説明

dryRun

string

これがある場合、変更を永続化してはならないことを示します。無効または認識されない dryRun ディレクティブは、エラーレスポンスを引き起こし、リクエストをそれ以上処理しません。有効な値: - All: すべてのドライランステージが処理されます。

fieldManager

string

fieldManager は、これらの変更を行っているアクターまたはエンティティーに関連付けられた名前です。値は 128 文字未満である必要があり、https://golang.org/pkg/unicode/#IsPrint で定義されているように、印刷可能な文字のみが含まれている必要があります。

pretty

string

'true' の場合、出力はきれいに印刷されます。

HTTP メソッド
POST
Description
Build のクローンを作成する
Expand
表30.80 ボディパラメーター
パラメータータイプ説明

body

BuildRequest スキーマ

 
Expand
表30.81 HTTP 応答
HTTP コードレスポンス本文

200 - OK

BuildRequest スキーマ

201 - Created

BuildRequest スキーマ

202 - Accepted

BuildRequest スキーマ

401 - Unauthorized

空白

30.5.2.2. /apis/build.openshift.io/v1/namespaces/{namespace}/buildconfigs/{name}/instantiate

Expand
表30.82 グローバルパスパラメーター
パラメータータイプ説明

name

string

BuildRequest の名前

namespace

string

チームやプロジェクトなどのオブジェクト名と認証スコープ

Expand
表30.83 グローバルクエリーパラメーター
パラメータータイプ説明

dryRun

string

これがある場合、変更を永続化してはならないことを示します。無効または認識されない dryRun ディレクティブは、エラーレスポンスを引き起こし、リクエストをそれ以上処理しません。有効な値: - All: すべてのドライランステージが処理されます。

fieldManager

string

fieldManager は、これらの変更を行っているアクターまたはエンティティーに関連付けられた名前です。値は 128 文字未満である必要があり、https://golang.org/pkg/unicode/#IsPrint で定義されているように、印刷可能な文字のみが含まれている必要があります。

pretty

string

'true' の場合、出力はきれいに印刷されます。

HTTP メソッド
POST
Description
BuildConfig のインスタンス化を作成する
Expand
表30.84 ボディパラメーター
パラメータータイプ説明

body

BuildRequest スキーマ

 
Expand
表30.85 HTTP 応答
HTTP コードレスポンス本文

200 - OK

Build スキーマ

201 - Created

Build スキーマ

202 - Accepted

Build スキーマ

401 - Unauthorized

空白

トップに戻る
Red Hat logoGithubredditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

Red Hat をお使いのお客様が、信頼できるコンテンツが含まれている製品やサービスを活用することで、イノベーションを行い、目標を達成できるようにします。 最新の更新を見る.

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

Theme

© 2025 Red Hat