Builds の操作

手順

1. Build リソースを作成し、次のいずれかの CLI を使用して OpenShift Container Platform クラスターに適用します。

   例: oc CLI の使用

   $ oc apply -f - <<EOF
   apiVersion: shipwright.io/v1beta1
   kind: Build
   metadata:
     name: buildah-golang-build
   spec:
     source: 

   1

   
       type: Git
       git:
         url: https://github.com/shipwright-io/sample-go
       contextDir: docker-build
     strategy: 

   2

   
       name: buildah
       kind: ClusterBuildStrategy
     paramValues: 

   3

   
     - name: dockerfile
       value: Dockerfile
     output: 

   4

   
       image: image-registry.openshift-image-registry.svc:5000/buildah-example/sample-go-app
   EOF

   1

   ソースコードが配置される場所。

   2

   コンテナーの構築に使用するビルドストラテジー。

   3

   ビルドストラテジーで定義されるパラメーター。dockerfile ストラテジーパラメーターの値を設定するには、出力イメージの構築に必要な Dockerfile の場所を指定します。

   4

   ビルドイメージがプッシュされる場所。この手順例では、ビルドされたイメージが OpenShift Container Platform クラスターの内部レジストリーにプッシュされます。buildah-example は現在のプロジェクトの名前です。イメージのプッシュを許可するために、指定されたプロジェクトが存在することを確認します。

   例: shp CLI の使用

   $ shp build create buildah-golang-build \
   --source-url="https://github.com/redhat-openshift-builds/samples" --source-context-dir="buildah-build" \

   1

   
   --strategy-name="buildah" \

   2

   
   --dockerfile="Dockerfile" \

   3

   
   --output-image="image-registry.openshift-image-registry.svc:5000/buildah-example/go-app" 

   4

   1

   ソースコードが配置される場所。

   2

   コンテナーの構築に使用するビルドストラテジー。

   3

   ビルドストラテジーで定義されるパラメーター。dockerfile ストラテジーパラメーターの値を設定するには、出力イメージの構築に必要な Dockerfile の場所を指定します。

   4

   ビルドイメージがプッシュされる場所。この手順例では、ビルドされたイメージが OpenShift Container Platform クラスターの内部レジストリーにプッシュされます。buildah-example は現在のプロジェクトの名前です。イメージのプッシュを許可するために、指定されたプロジェクトが存在することを確認します。

2. Build リソースが CLI のいずれかを使用して作成されていることを確認します。

   例: oc CLI の使用

   $ oc get builds.shipwright.io buildah-golang-build

   例: shp CLI の使用

   $ shp build list

3. BuildRun リソースを作成し、次のいずれかの CLI を使用して OpenShift Container Platform クラスターに適用します。

   例: oc CLI の使用

   $ oc apply -f - <<EOF
   apiVersion: shipwright.io/v1beta1
   kind: BuildRun
   metadata:
     name: buildah-golang-buildrun
   spec:
     build:
       name: buildah-golang-build 

   1

   
   EOF

   1

   spec.build.name フィールドは、実行するそれぞれのビルドを示し、同じ namespace で使用できる必要があります。

   例: shp CLI の使用

   $ shp build run buildah-golang-build --follow 

   1

   1

   オプション: --follow オプションのフラグを使用すると、出力結果のビルドログを表示できます。

4. 次のいずれかのコマンドを実行して、BuildRun リソースが作成されているかどうかを確認します。

   例: oc CLI の使用

   $ oc get buildrun buildah-golang-buildrun

   例: shp CLI の使用

   $ shp buildrun list

   BuildRun リソースは TaskRun リソースを作成し、その後ビルドストラテジーの手順を実行する Pod を作成します。

検証

1. すべてのコンテナーがタスクを完了したら、以下を確認します。

   • Pod で STATUS フィールドが Completed として表示されるかどうかを確認します。

     $ oc get pods -w

     出力例

     NAME                                READY   STATUS    RESTARTS   AGE
     buildah-golang-buildrun-dtrg2-pod   2/2     Running   0          4s
     buildah-golang-buildrun-dtrg2-pod   1/2     NotReady  0          7s
     buildah-golang-buildrun-dtrg2-pod   0/2     Completed 0          55s

   • それぞれの TaskRun リソースに SUCCEEDED フィールドが True と表示されているかどうかを確認します。

     $ oc get tr

     出力例

     NAME                           SUCCEEDED  REASON     STARTTIME   COMPLETIONTIME
     buildah-golang-buildrun-dtrg2  True       Succeeded  11m         8m51s

   • それぞれの BuildRun リソースに SUCCEEDED フィールドが True と表示されているかどうかを確認します。

     $ oc get br

     出力例

     NAME                     SUCCEEDED   REASON       STARTTIME     COMPLETIONTIME
     buildah-golang-buildrun  True        Succeeded    13m           11m

     検証中にビルドの実行が失敗した場合は、BuildRun リソースの status.failureDetails フィールドをチェックして、Pod またはコンテナー内で失敗が発生した正確なポイントを特定できます。

     注記

     コンテナーの 1 つがタスクを完了したため、Pod が NotReady 状態に切り替わる可能性があります。これは想定される動作です。

2. build.spec.output.image フィールドで指定されたレジストリーにイメージがプッシュされたかどうかを検証します。内部レジストリーにアクセスできるノードから次のコマンドを実行して、イメージのプルを試みることができます。

   $ podman pull image-registry.openshift-image-registry.svc:5000/<project>/<image> 

   1

   1

   Build リソースの作成時に使用されるプロジェクト名とイメージ名。たとえば、buildah-example をプロジェクト名として、sample-go-app をイメージ名として使用できます。

手順

1. Build リソースを作成し、次のいずれかの CLI を使用して OpenShift Container Platform クラスターに適用します。

   例: oc CLI の使用

   $ oc apply -f - <<EOF
   apiVersion: shipwright.io/v1beta1
   kind: Build
   metadata:
     name: s2i-nodejs-build
   spec:
     source: 

   1

   
       type: Git
       git:
         url: https://github.com/redhat-openshift-builds/samples
       contextDir: s2i-build/nodejs
     strategy: 

   2

   
       name: source-to-image
       kind: ClusterBuildStrategy
     paramValues: 

   3

   
     - name: builder-image
       value: quay.io/centos7/nodejs-12-centos7:master
     output:
       image: quay.io/<repo>/s2i-nodejs-example 

   4

   
       pushSecret: registry-credential 

   5

   
   EOF

   1

   ソースコードが配置される場所。

   2

   コンテナーの構築に使用するビルドストラテジー。

   3

   ビルドストラテジーで定義されるパラメーター。builder-image ストラテジーパラメーターの値を設定するには、出力イメージのビルドに必要なビルダーイメージの場所を指定します。

   4

   ビルドイメージがプッシュされる場所。ビルドされたイメージをカスタム Quay.io リポジトリーにプッシュできます。repo は、有効な Quay.io 組織または Quay ユーザー名に置き換えます。

   5

   コンテナーイメージをプッシュするための認証情報を保存するシークレット名。認証用に docker-registry タイプのシークレットを生成するには、「コンテナーレジストリーへの認証」を参照してください。

   例: shp CLI の使用

   $ shp build create s2i-nodejs-build \
   --source-url="https://github.com/redhat-openshift-builds/samples" --source-context-dir="s2i-build/nodejs" \

   1

   
   --strategy-name="source-to-image" \

   2

   
   --builder-image="quay.io/centos7/nodejs-12-centos7" \

   3

   
   --output-image="quay.io/<repo>/s2i-nodejs-example" \

   4

   
   --output-credentials-secret="registry-credential" 

   5

   1

   ソースコードが配置される場所。

   2

   コンテナーの構築に使用するビルドストラテジー。

   3

   ビルドストラテジーで定義されるパラメーター。builder-image ストラテジーパラメーターの値を設定するには、出力イメージのビルドに必要なビルダーイメージの場所を指定します。

   4

   ビルドイメージがプッシュされる場所。ビルドされたイメージをカスタム Quay.io リポジトリーにプッシュできます。repo は、有効な Quay.io 組織または Quay ユーザー名に置き換えます。

   5

   コンテナーイメージをプッシュするための認証情報を保存するシークレット名。認証用に docker-registry タイプのシークレットを生成するには、「コンテナーレジストリーへの認証」を参照してください。

2. Build リソースが CLI のいずれかを使用して作成されていることを確認します。

   例: oc CLI の使用

   $ oc get builds.shipwright.io s2i-nodejs-build

   例: shp CLI の使用

   $ shp build list

3. BuildRun リソースを作成し、次のいずれかの CLI を使用して OpenShift Container Platform クラスターに適用します。

   例: oc CLI の使用

   $ oc apply -f - <<EOF
   apiVersion: shipwright.io/v1beta1
   kind: BuildRun
   metadata:
     name: s2i-nodejs-buildrun
   spec:
     build:
       name: s2i-nodejs-build 

   1

   
   EOF

   1

   spec.build.name フィールドは、実行するそれぞれのビルドを示し、同じ namespace で使用できる必要があります。

   例: shp CLI の使用

   $ shp build run s2i-nodejs-build --follow 

   1

   1

   オプション: --follow オプションのフラグを使用すると、出力結果のビルドログを表示できます。

4. 次のいずれかのコマンドを実行して、BuildRun リソースが作成されているかどうかを確認します。

   例: oc CLI の使用

   $ oc get buildrun s2i-nodejs-buildrun

   例: shp CLI の使用

   $ shp buildrun list

   BuildRun リソースは TaskRun リソースを作成し、その後ビルドストラテジーの手順を実行する Pod を作成します。

検証

1. すべてのコンテナーがタスクを完了したら、以下を確認します。

   • Pod で STATUS フィールドが Completed として表示されるかどうかを確認します。

     $ oc get pods -w

     出力例

     NAME                                READY   STATUS     RESTARTS   AGE
     s2i-nodejs-buildrun-phxxm-pod       2/2     Running    0          10s
     s2i-nodejs-buildrun-phxxm-pod       1/2     NotReady   0          14s
     s2i-nodejs-buildrun-phxxm-pod       0/2     Completed  0          2m

   • それぞれの TaskRun リソースに SUCCEEDED フィールドが True と表示されているかどうかを確認します。

     $ oc get tr

     出力例

     NAME                           SUCCEEDED  REASON     STARTTIME   COMPLETIONTIME
     s2i-nodejs-buildrun-phxxm      True       Succeeded  2m39s        13s

   • それぞれの BuildRun リソースに SUCCEEDED フィールドが True と表示されているかどうかを確認します。

     $ oc get br

     出力例

     NAME                     SUCCEEDED   REASON       STARTTIME     COMPLETIONTIME
     s2i-nodejs-buildrun      True        Succeeded    2m41s           15s

     検証中にビルドの実行が失敗した場合は、BuildRun リソースの status.failureDetails フィールドをチェックして、Pod またはコンテナー内で失敗が発生した正確なポイントを特定できます。

     注記

     コンテナーの 1 つがタスクを完了したため、Pod が NotReady 状態に切り替わる可能性があります。これは想定される動作です。

2. build.spec.output.image フィールドで指定されたレジストリーにイメージがプッシュされたかどうかを検証します。レジストリーにログインした後、以下のコマンドを実行してイメージをプルできます。

   $ podman pull quay.io/<repo>/<image> 

   1

   1

   Build リソースの作成時に使用されるリポジトリー名とイメージ名。たとえば、イメージ名として s2i-nodejs-example を使用できます。