執行建置配置

建立建置配置之後，您可以根據該建置配置來提交執行。從主控台或使用 CLI 來執行建置。

Code Engine 在專案內具有建置和建置執行的配額。如需 Code Engine 限制的相關資訊，請參閱 Code Engine的限制和配額。

完成的建立執行會自動刪除。當您的建立執行以建立設定為基礎時，如果建立執行成功，此建立執行會在三小時後刪除。如果建立執行不成功，此建立執行會在一週後刪除。

從主控台執行建置

移至 Code Engine 儀表板。
選取您在其中建立建置的專案。
從專案頁面中，按一下 映像檔建置。
從 映像檔建置 標籤中，選取您要使用的映像檔建置名稱。
在配置區段中，必要的話，您可以檢閱建置配置並變更值。
驗證任何其他資訊，例如此建置執行的 輸出映像檔，或改寫逾時值。
按一下 提交建置來提交建置執行。

在 建置執行 區段中監視建置進度。

使用 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 指令。

下列實務範例會將 Samples for IBM Cloud Code Engine GitHub repo 複製到本端工作站上的 CodeEngineLocalSample 目錄。

將 Samples for IBM Cloud Code Engine GitHub 儲存庫複製到本端工作站上建立的子目錄，例如 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。您可以在沒有影響的情況下刪除此來源映像檔。

如需建置的相關資訊，請檢查疑難排解提示。