ビルド構成の実行

ビルド構成を作成した後、そのビルド構成に基づいて実行依頼することができます。ビルドの実行は、コンソールでも CLI でも行えます。

Code Engine には、プロジェクト内のビルドおよびビルド実行に対する割り当て量があります。 Code Engine の制限について詳しくは、Code Engine の制限と割り当て量を参照してください。

完了したビルドは自動的に削除されます。ビルド構成に基づいてビルドが実行された場合、ビルドが成功した場合、このビルドは3時間後に削除されます。ビルド実行が成功しなかった場合、このビルド実行は1週間後に削除されます。

コンソールからのビルドの実行

Code Engine ダッシュボードに進みます。
ビルドを作成したプロジェクトを選択します。
「プロジェクト」ページで、**「イメージ・ビルド (Image builds)」**をクリックします。
「イメージ・ビルド」 タブで、処理するイメージ・ビルドの名前を選択します。
「構成」セクションでは、ビルド構成を確認し、必要に応じて値を変更することができます。
このビルド実行の 「出力イメージ」 などの追加情報を確認するか、 「タイムアウト」 値を上書きします。
**「ビルドの実行依頼 (Submit build)」**をクリックして、ビルドの実行を依頼します。

**「ビルド実行 (Build runs)」**セクションでビルドの進行状況をモニターします。

リポジトリーからのソースに対する CLI を使用したビルドの実行 (非ローカル)

CLI を使用してビルド構成からビルド実行を実行依頼するには、buildrun submit コマンドを使用します。このコマンドには、ビルド構成の名前が必要です。その他のオプション引数を指定できます。オプションの全リストについては、ibmcloud ce buildrun submit コマンドを参照してください。

以下の例では、helloworld-build-runという名前のビルドを実行し、helloworld-buildビルドを使用します。

ibmcloud ce buildrun submit --build helloworld-build --name helloworld-build-run

出力例

Submitting build run 'helloworld-build-run'...
Run 'ibmcloud ce buildrun get -n helloworld-build-run' to check the build run status.
OK

以下の表は、この例の buildrun submit コマンドで使用されるオプションの要約です。コマンドとそのオプションについて詳しくは、ibmcloud ce buildrun submit コマンドを参照してください。

コマンドの説明
オプション	説明
`--build`	使用するビルド構成の名前。この値は必須です。
`--name`	ビルド実行の名前。プロジェクト内で固有の名前を使用してください。名前の先頭と末尾は小文字の英数字でなければなりません。名前は 63 文字以下でなければならず、小文字の英数字とハイフン (-) を含めることができます。

ビルド実行が開始されます。 ibmcloud ce buildrun get コマンドを使用して、進行状況をモニターします。

例えば、前の例のビルド実行の状況を確認するには、以下のようにします。

ibmcloud ce buildrun get --name helloworld-build-run

出力例

Getting build run 'helloworld-build-run'...
[...]
OK

Name:          helloworld-build-run
ID:            abcdefgh-abcd-abcd-abcd-1a2b3c4d5e6f
Project Name:  myproject
Project ID:    01234567-abcd-abcd-abcd-abcdabcd1111
Age:           21m
Created:       2021-03-14T14:50:13-05:00

Summary:  Succeeded
Status:   Succeeded
Reason:   Succeeded

ビルドについて詳しくは、トラブルシューティングのヒントを確認してください。

ローカル・ディレクトリー (ローカル) からのソースに対する CLI を使用したビルドの実行

ローカル・ディレクトリーからソースをプルする CLI を使用してビルド構成からビルド実行を実行依頼するには、**buildrun submit**コマンドを使用します。このコマンドには、ビルド構成の名前と、ローカル・ソースへのパスが必要です。その他のオプション引数を指定できます。オプションの全リストについては、ibmcloud ce buildrun submit コマンドを参照してください。

次のシナリオでは、 IBM Cloud Code Engine GitHub リポジトリのサンプルをローカルのワークステーション上の CodeEngineLocalSample ディレクトリにクローンします。

IBM Cloud Code Engine GitHub repo のサンプルを、 CodeEngineLocalSamples サブディレクトリなど、ローカルのワークステーション上に作成したサブディレクトリにコピーします。このディレクトリから、 git clone コマンドを実行します。例えば、
```
git clone https://github.com/IBM/CodeEngine
```
ワークステーション上のソース・コードがあるディレクトリーに移動します。例えば、 Code Engine サンプルがある CodeEngine サブディレクトリーに移動します。
ソース・コードが置かれているディレクトリーから、ビルド実行を実行依頼します。以下の例では、buildrun-local-dockerfileというビルドを実行し、build-local-dockerfileビルド構成を使用します。 --sourceオプションは、helloworldサンプルへのローカル・ワークステーション上のソースへのパスを指定します。
```
ibmcloud ce buildrun submit --name buildrun-local-dockerfile --build build-local-dockerfile --source ./helloworld
```
出力例
```
Getting build 'build-local-dockerfile'
Packaging files to upload from source path './helloworld' ...
Submitting build run 'buildrun-local-dockerfile'...
Run 'ibmcloud ce buildrun get -n buildrun-local-dockerfile' to check the build run status.
OK
```

ibmcloud ce buildrun getコマンドを使用して、ビルド実行の進行状況をモニターします。例えば、前の例のビルド実行の状況を確認するには、以下のようにします。

ibmcloud ce buildrun get --name helloworld-build-run

出力例

Getting build run 'buildrun-local-dockerfile'...
Run 'C:\Program Files\IBM\Cloud\bin\ibmcloud.exe ce buildrun events -n buildrun-local-dockerfile' to get the system events of the build run.
Run 'C:\Program Files\IBM\Cloud\bin\ibmcloud.exe ce buildrun logs -f -n buildrun-local-dockerfile' to follow the logs of the build run.
OK

Name:          buildrun-local-dockerfile
ID:            abcdefgh-abcd-abcd-abcd-1a2b3c4d5e6f
Project Name:  myproject
Project ID:    01234567-abcd-abcd-abcd-abcdabcd1111
Age:           40s
Created:       2022-01-19T12:22:33-05:00

Summary:       Succeeded
Status:        Succeeded
Reason:        All Steps have completed executing
Source:
  Source Image Digest:  sha256:07159930b5abcf94e1a7451ea18490d4ad1162a77c2b987da5b7493fa1f1e49d
Image Digest:  sha256:04c7be7db438a41040ea24d646314f1c847c191d88fffdbea6f483fc443c2bbe

Build Name:    build-local-dockerfile
Source Image:  us.icr.io/mynamespace/codeengine-build-source
Image:         us.icr.io/mynamespace/codeengine-build
Timeout:       10m0s

ローカル・ディレクトリーからコードをプルするビルドを実行依頼すると、ソース・コードがアーカイブ・ファイルにパックされ、IBM Cloud Container Registryインスタンスにアップロードされます。ビルド実行が完了すると、IBM Cloud Container Registryインスタンスにcodeengine-buildなどのビルド・イメージが表示されます。また、ビルド名の末尾に -source を追加したソース画像もご覧いただけます。例えば、 codeengine-build-source などです。このソース・イメージは、影響を与えずに削除できます。

ビルドについて詳しくは、トラブルシューティングのヒントを確認してください。