Builds について

Build リソースは、アプリケーションのソースコードと、アプリケーションイメージをプッシュする場所を定義します。次の例は、Git ソース、ビルドストラテジー、出力イメージで構成される単純なビルドを示しています。

apiVersion: shipwright.io/v1beta1
kind: Build
metadata:
  name: buildah-golang-build
spec:
  source:
    git:
      url: https://github.com/username/taxi
  strategy:
    name: buildah
    kind: ClusterBuildStrategy
  output:
    image: registry.mycompany.com/my-org/taxi-app:latest

apiVersion: shipwright.io/v1beta1
kind: Build
metadata:
  name: buildah-golang-build
spec:
  source:
    git:
      url: https://github.com/username/taxi
  strategy:
    name: buildah
    kind: ClusterBuildStrategy
  output:
    image: registry.mycompany.com/my-org/taxi-app:latest

また、Build リソースを拡張してイメージをプライベートレジストリーにプッシュしたり、Dockerfile ファイルを使用したりすることもできます。

BuildStrategy および ClusterBuildStrategy リソースは、アプリケーションをアセンブルする一連のステップを定義します。namespace では BuildStrategy リソースを使用でき、クラスターでは ClusterBuildStrategy リソースを使用できます。

BuildStrategy または ClusterBuildStrategy リソースの仕様は、steps オブジェクトで構成されます。以下の例は、buildah クラスタービルドストラテジーの仕様を示しています。

apiVersion: shipwright.io/v1beta1
kind: ClusterBuildStrategy
metadata:
  name: buildah
spec:
  steps:
    - name: build-and-push
      image: quay.io/containers/buildah:v1.31.0
      workingDir: $(params.shp-source-root)
      command:
        - /bin/bash
       # ...
# ...

apiVersion: shipwright.io/v1beta1
kind: ClusterBuildStrategy
metadata:
  name: buildah
spec:
  steps:
    - name: build-and-push
      image: quay.io/containers/buildah:v1.31.0
      workingDir: $(params.shp-source-root)
      command:
        - /bin/bash
       # ...
# ...

BuildRun リソースは、クラスタージョブや Tekton タスク実行と同様に、クラスターのビルドを呼び出します。BuildRun リソースはクラスター上のワークロードを表し、その結果 Pod が実行します。BuildRun は、ビルドで実行中のインスタンスです。クラスター上で特定のパラメーターを使用して実行するビルドをインスタンス化します。

BuildRun リソースを使用すると、以下の要素を定義できます。

各 BuildRun リソースは、namespace 内で利用できます。

build controller は、Build リソースの更新を監視し、以下のタスクを実行します。

build run controller は、Build または TaskRun リソースの更新を監視し、以下のタスクを実行します。

buildah クラスターのビルドストラテジーは、Dockerfile を使用してコンテナーイメージをビルドし、それをターゲットレジストリーにプッシュします。Build CR の spec.paramValues フィールドに Dockerfile を指定する必要があります。

Builds for Red Hat OpenShift Operator は buildah ストラテジーをクラスターレベルでインストールするため、クラスター内の異なる名前空間間で buildah ストラテジーを共有できます。

buildah ストラテジーに対して次のパラメーターを設定できます。

このビルドストラテジーは、source-to-image および buildah で構成されます。このストラテジーを使用して、コンテナーファイルを生成し、ビルダーイメージでアプリケーションをビルドする準備を行うことができます。Build CR の spec.paramValues フィールドにビルダーイメージを指定する必要があります。

Builds for Red Hat OpenShift Operator は source-to-image ストラテジーをクラスターレベルでインストールするため、クラスター内の異なる namespace 間で source-to-image ストラテジーを共有できます。

source-to-image ストラテジーに対して次のパラメーターを設定できます。