指令選項

--name, -n

要綁定的應用程式的名稱。 此欄位為必填項目。

--no-wait, --nw

綁定服務實例，且不等待服務綁定就緒。 如果指定 no-wait 選項，則會啟動服務綁定的建立，並且不等待服務綁定完成就退出命令。 使用 app get 指令檢查應用程式的綁定狀態。 此值為可選項。 預設值為 false。

--prefix, -p

針對此服務連結建立之環境變數的字首。 必須只包含大寫字母、數字和底線 (_)，並且不能以數字開頭。 此值為可選項。

--quiet, -q

指定此選項可減少指令的輸出。 此值為可選項。 預設值為 false。

--role, -r

為此服務綁定所建立之新服務憑證的服務角色名稱。 有效值包括 Reader、Writer、Manager，或特定服務的角色。 此選項預設為「Manager」；若不支援「Manager」，則預設為該服務所提供的第一個角色。 如果指定 --service-credential，則忽略此選項。 此值為可選項。

--service-credential, --sc

用於此服務綁定之現有服務憑證的名稱。 如果未指定服務實例憑證，則會在綁定動作期間產生新憑證。 此值為可選項。

--service-instance, --si

要綁定到應用程式的現有 IBM Cloud 服務實體的名稱。 此值為可選項。

--service-instance-id, --siid

要與應用程式綁定的現有 IBM Cloud 服務實體的 GUID。 此值為可選項。

--wait, -w

綁定服務實例，並等待服務綁定就緒。 如果指定 --wait 選項，應用程式綁定會等待 --wait-timeout 選項設定的最長時間（以秒為單位），讓應用程式綁定成功完成。 如果應用程式綁定在指定的 --wait-timeout 期間內未成功完成或失敗，則命令失敗。 此值為可選項。 預設值為 true。

--wait-timeout, --wto

等待服務綁定就緒所需的時間（以秒為單位）。 如果指定了 --wait 選項，則必須使用此值。 如果指定了 --no-wait 選項，此值會被忽略。 預設值為 300。

範例

在這個範例中，將您的 IBM Cloud Object Storage 服務實例 my-object-storage 綁定到您的應用程式 myapp。

ibmcloud ce application bind --name myapp --service-instance my-object-storage

輸出範例

Binding service instance...
Waiting for service binding to become ready...
Status: Pending (Processing Resource)
Status: Pending (Processing Resource)
Status: Creating service binding
Status: Creating service binding
Status: Ready
Waiting for application revision to become ready...
Traffic is not yet migrated to the latest revision.
Ingress has not yet been reconciled.
Waiting for load balancer to be ready
OK

指令選項

-n, --name

應用程式的名稱。 請使用專案內唯一的名稱。

• 名稱必須以小寫字母開頭。
• 名稱必須以小寫英數字元結尾。
• 名稱必須為 63 個字元或以下，並可包含小寫字母、數字和連字符號 (-)。

此欄位為必填項目。

--argument, --arg, -a

設定應用程式的參數。 每個 --argument 選項指定一個參數；例如，-a argA -a argB。 此值會覆寫容器映像中指定的預設值。 此值為可選項。

--build-commit, --commit, --bcm, --cm, --revision

來源儲存庫中要取回的確定、標籤或分支。 只有設定了 --build-source 選項，才允許使用 build commit 選項。 此值為可選項。

--build-context-dir, --context-dir, --bcdr, --cdr

套件庫中包含 buildpacks 檔案或 Dockerfile 的目錄。 只有設定 --build-source 選項時，才允許使用建立上下文目錄選項。 此值為可選項。

--build-dockerfile, --dockerfile, --bdf, --df

Dockerfile 的路徑。 僅在名稱不是 Dockerfile 時指定此選項。 只有當 --build-source 選項被設定時，才允許使用 build dockerfile 選項。 此值為可選項。 預設值為 Dockerfile。

--build-git-repo-secret, --git-repo-secret, --bgrs, --grs, --repo

SSH 密鑰的名稱，其中包含用來存取專用儲存庫的認證，該專用儲存庫包含用來建置容器映像檔的原始碼。 若要建立此 SSH 秘密，請使用 secret create --format SSH 指令。 SSH 秘密也可用作 Git 儲存庫存取秘 密。 只有在 --build-source 選項設定為 Git 儲存庫的 URL 時，才允許使用此選項。 此值為可選項。

--build-size, --size, --bsz, --sz

建置的規模，這將決定所使用的資源量。 有效值包括：small、medium、large、xlarge 以及 xxlarge。 如需詳細資訊，請參閱 確定建立的大小。 只有設定 --build-source 選項時，才允許使用建立大小選項。 此值為可選項。 預設值為 medium。

--build-source, --source, --bsrc, --src

Git 儲存庫的 URL 或包含您原始碼的本機原始碼路徑；例如 https://github.com/IBM/CodeEngine 或 .。 此值為可選項。

--build-strategy, --strategy, --bstr, --str

用於建置映像檔的策略。 有效值為 dockerfile 和 buildpacks。 只有設定 --build-source 選項時，才允許使用建立策略選項。 如果未指定，則在指定 --build-source 且原始碼位於本機的情況下，由 Code Engine 決定建立策略。 此值為可選項。 預設值為 dockerfile。

--build-timeout, --bto

在建立成功或失敗之前所能經過的時間，以秒為單位。 只有設定 --build-source 選項時，才允許使用建立逾時選項。 此值為可選項。 預設值為 600。

--cluster-local, --cl

使用僅限專案端點來部署應用程式。 設定「僅限專案」端點，表示您的應用程式無法透過公共網際網路存取，且僅能由在同一專案中執行的其他 Code Engine 元件進行網路存取。 此值為可選項。 預設值為 false。

--command, --cmd, -c

設定應用程式的指令。 每個 --command 選項指定一個指令；例如，--cmd cmdA --cmd cmdB。 此值會覆寫在容器影像中指定的預設命令。 此值為可選項。

--concurrency, --cn

每個執行個體可同時處理的請求最大數量。 此值為可選項。 預設值為 100。

--concurrency-target, --ct

建立一個或多個額外實體時，每個實體的並發請求臨界值。 使用此值可根據並發請求數擴充實體。 如果 --concurrency-target 未指定，則此選項預設為 --concurrency 選項的值。 此值為可選項。 預設值為 0。

--cpu

為該應用程式執行個體設定的 CPU 數量。 有關有效值，請參閱 支援的記憶體和 CPU 組合。 此值為可選項。 預設值為 1。

--env, -e

在應用程式中設定環境變數。 必須採用 NAME=VALUE 格式。 此動作可新增環境變數或覆寫現有的環境變數。 每個 --env 選項指定一個環境變數；例如，--env envA=A --env envB=B。 此值為可選項。

--env-cm, --env-from-configmap

使用下列其中一種方式，從儲存於此 configmap 的 key-value 對中設定環境變數：

• 若要為名為 configmapName 的 configmap 中的所有按鍵新增環境變數，請使用值 configmapName。 您可以在引用 configmap 時指定前綴來修改環境變數名稱。 若要指定前綴，請使用 PREFIX=CONFIGMAP_NAME。 每個結果環境變數的格式為 <PREFIX><NAME_OF_KEY_IN_CONFIGMAP>. 例如，要將配置表 configmapName 中所有變量名稱的鍵的前綴設為 CUSTOM_，請使用值 CUSTOM_=configmapName。 如果配置映射 configmapName 包含 KEY_A，環境變數名稱就是 CUSTOM_KEY_A。
• 若要為個別金鑰新增環境變數，請使用格式 NAME:KEY_A,KEY_B. 例如，若要在名為 configmapName 的 configmap 中為單一關鍵 key1 新增環境變數，請使用 configmapName:key1。 若要為引用的按鍵指定不同的名稱，請使用格式 NAME:NEW_NAME=KEY_A。 例如，若要為名為 configmapName 的 configmap 中的單一鍵 key1 新增名為 myKey 的環境變數，請使用值 configmapName:myKey=key1。

此值為可選項。

--env-sec, --env-from-secret

使用下列其中一種方式，從儲存於秘密中的鍵值對設定環境變數：

• 若要為命名為 secretName 的秘密中的所有金鑰新增環境變數，請使用 secretName。 您可以在引用秘密時指定前綴來修改環境變數名稱。 若要指定前綴，請使用 PREFIX=SECRET_NAME。 每個結果環境變數的格式為 <PREFIX><NAME_OF_KEY_IN_SECRET>. 例如，若要將密碼 secretName 中所有變數名稱的前綴設定為 CUSTOM_，請使用值 CUSTOM_=secretName。 如果密文 secretName 包含 KEY_A，環境變數名稱就是 CUSTOM_KEY_A。
• 若要為個別金鑰新增環境變數，請使用格式 NAME:KEY_A,KEY_B. 例如，若要在名稱為 secretName 的秘密中為單一金鑰 key1 新增環境變數，請使用 secretName:key1。 若要為引用的按鍵指定不同的名稱，請使用格式 NAME:NEW_NAME=KEY_A。 例如，要在一個名為 secretName 的秘密中為單一金鑰 key1 新增一個名為 myKey 的環境變數，請使用 secretName:myKey=key1 的值。

此值為可選項。

--ephemeral-storage, --es

要為應用程式實例設定的暫時儲存體數量。 若要表示兆位元組，請使用 M ；若要表示吉位元組，請使用 G。 此值為可選項。 預設值為 400M。

--force, -f

不驗證指定的 configmap 和 secret 參照是否存在。 Configmap 引用是使用 --env-from-configmap 或 --mount-configmap 選項指定的。 秘密參照使用 --env-from-secret、--mount-secret 或 --registry-secret 選項指定。 此值為可選項。 預設值為 false。

--image, -i

用於此應用程式的影像名稱。 格式為 REGISTRY/NAMESPACE/REPOSITORY:TAG，其中 REGISTRY 和 TAG 皆為可選項目。 若未指定 REGISTRY，預設值為 docker.io。 若未指定 TAG，預設值為 latest。 若未指定 --build-source 選項，則必須指定 image 選項。 此值為可選項。

--max-scale, --max, --maxscale

此應用程式可使用的最大實體數。 若將此值設定為 0``，應用程式便會根據需求進行擴展。 應用程式調整大小僅受限於應用程式專案的每個資源配額的實例數。 請參閱 Code Engine 的限制和配額。 此值為可選項。 預設值為 10。

--memory, -m

為該應用程式執行個體設定的記憶體用量。 若要表示兆位元組，請使用 M ；若要表示吉位元組，請使用 G。 有關有效值，請參閱 支援的記憶體和 CPU 組合。 此值為可選項。 預設值為 4G。

--min-scale, --min, --minscale

此應用程式可使用的最小實體數量。 此選項有助於確保在不需要時不會執行任何實體。 此值為可選項。 預設值為 0。

--mount-configmap, --mount-cm

透過提供掛載目錄和 configmap 的名稱，將 configmap 的內容加入應用程式容器的檔案系統，格式為 MOUNT_DIRECTORY=CONFIGMAP_NAME. 每個掛載的 configmap 必須使用唯一的掛載目錄。 對於 configmap 中的每個 key-value 對，都會新增一個檔案到指定的 mount 目錄，其中檔案名稱是 key，檔案內容是 key-value 對的值。 每個 --mount-configmap 選項指定一個掛載設定；例如，--mount-configmap /etc/config-a=config-a --mount-configmap /etc/config-b=config-b。 此值為可選項。

--mount-data-store, --mount-ds

裝載持續資料儲存庫。 格式為 MOUNT_DIRECTORY=STORAGE_NAME [:SUBPATH]。 SUBPATH 為選用。 此選項可以指定多次。 此值為可選項。

--mount-secret, --mount-sec

透過提供掛載目錄和秘密名稱，將秘密的內容加入應用程式容器的檔案系統，格式為 MOUNT_DIRECTORY=SECRET_NAME. 每個掛載的秘密必須使用唯一的掛載目錄。 對於秘密中的每個鍵值對，都會在指定的掛載目錄中加入一個檔案，其中檔案名稱是鍵，檔案內容是鍵值對的值。 每個 --mount-secret 選項指定一個掛載設定；例如，--mount-secret /etc/secret-a=secret--a --mount-secret /etc/secret-b=secret-b。 此值為可選項。

--no-cluster-local, --ncl

部署帶有公用端點的應用程式。 此應用程式的部署方式，使其能夠接收來自公共網際網路或「Code Engine」專案內各元件的請求。 此值為可選項。 預設值為 true。

--no-wait, --nw

建立應用程式，不要等待應用程式就緒。 如果您指定 --no-wait 選項，應用程式建立會開始，不會等待。 使用 app get 指令檢查應用程式狀態。 此值為可選項。 預設值為 false。

--output, -o

指定指令輸出的格式。 有效值包括：json、yaml、jsonpath=JSONPATH_EXPRESSION、jsonpath-as-json=JSONPATH_EXPRESSION、url 以及 project-url。 使用 jsonpath 指定 JSON 輸出元素的路徑。 此值為可選項。

--port, -p

應用程式監聽的連接埠。 格式為 [NAME:]PORT，其中 [NAME:] 為可選項目。 如果指定 [NAME:]，有效值為 h2c，或 http1。 當 [NAME:] 未指定或為 http1 時，埠會使用 HTTP/1.1。 當 [NAME:] 為 h2c 時，連接埠使用未加密的 HTTP/2。 預設情況下，Code Engine 假定應用程式會在 8080 連接埠上聽取傳入的連線。 如果您的應用程式需要在 8080 以外的連接埠聆聽，請使用 --port 指定連接埠。 此值為可選項。

--probe-live, --pl

以 NAME=VALUE 格式配置此應用程式的活性探測。 NAME 的有效選項為 type, port, path, interval, initial-delay, timeout, failure-threshold。此選項可指定多次。 type 屬性為必填項目，有效值為 tcp 和 http。 例如，--probe-live type=tcp --probe-live port=8080。 有關使用探針的詳細資訊，請參閱 為您的應用程式配置探針。 此值為可選項。

--probe-ready, --pr

以 NAME=VALUE 格式配置此應用程式的就緒探測。 NAME 的有效選項為 type, port, path, interval, initial-delay, timeout, failure-threshold。此選項可指定多次。 type 屬性為必填項目，有效值為 tcp 和 http。 例如，--probe-ready type=tcp --probe-ready port=8080。 有關使用探針的詳細資訊，請參閱 為您的應用程式配置探針。 此值為可選項。

--quiet, -q

指定此選項可減少指令的輸出。 此值為可選項。 預設值為 false。

--registry-secret, --rs

登錄密鑰的名稱。 當您下載容器映像檔時，會使用登錄密鑰向專用登錄進行鑑別。 此值為可選項。

--request-timeout, --rt, --timeout, -t

向應用程式提出的要求必須成功或失敗之前所能經過的時間 (以秒為單位)。 此值為可選項。 預設值為 300。

--rn, --revision-name

修訂的名稱。 請使用在該應用程式內具有唯一性的名稱。

• 名稱可以包含小寫字母、數字和連字號（-）。
• 名稱必須以小寫英數字元結尾。
• 完全限定的版本名稱格式必須為 Name_of_application-Name of revision。
• 完全合格的版本名稱必須少於 63 個字元。

此值為可選項。

--scale-down-delay, --sdd

縮減應用程式之前，必須以減少並行處理的時間（秒）。 並發要求數量的增加會導致應用程式擴充。 如果請求數下降（並發量降低），此選項的指定時間量會決定在應用程式縮小之前，並發量降低需要持續多久。 預設情況下，如果偵測到並發量減少，應用程式會立即縮小。 此值為可選項。 預設值為 0。

--service-account, --sa

服務帳戶的名稱。 服務帳戶提供在實例中執行之程序的身分。 對於內建服務帳戶，您可以使用縮寫名稱 manager, none, reader，以及 writer。 您也可以使用以 Kubernetes Config Context 為前綴的全名，這可以使用 project current 指令來確定。 此值為可選項。

--trusted-profiles-enabled, --trusted, --tpe

啟用計算資源記號裝載到此應用程式的儲存器。 此值為可選項。 預設值為 false。

--user, -u

用於執行應用程式的使用者 ID (UID)。 此值會覆寫應用程式 Dockerfile 中設定的任何使用者 ID。 ID 必須符合容器的作業系統要求。 此值為可選項。 預設值為 0。

--visibility, -v

應用程式的可見性。 有效值為 public、private 以及 project。 設定能見度為 public 表示您的應用程式可以接收來自公開網際網路或 Code Engine 專案內元件的請求。 設定能見度為 private 表示您的應用程式無法從公共網際網路存取，只能從使用虛擬私人端點 (VPE) 的其他 IBM Cloud 或在相同專案中執行的 Code Engine 元件進行網路存取。 只有當專案支援「應用程式私有」可見性時，可見性才可能為 private。 將可見性設定為「project」，表示您的應用程式無法透過公共網際網路存取，且僅能由在同一專案中執行的其他 Code Engine 元件進行網路存取。 此值為可選項。

--wait, -w

建立應用程式，等待應用程式就緒。 如果指定 --wait 選項，則應用程式建立會等待 --wait-timeout 選項設定的最長時間（以秒為單位），讓應用程式準備就緒。 如果應用程式未在指定的 wait-timeout 期間內就緒，則應用程式建立失敗。 此值為可選項。 預設值為 true。

--wait-timeout, --wto

等待應用程式就緒所需的時間（以秒為單位）。 如果指定了 --wait 選項，則必須使用此值。 如果指定了 --no-wait 選項，此值會被忽略。 預設值為 600。

範例

ibmcloud ce application create --name myapp --image icr.io/codeengine/hello

輸出範例

Creating application 'myapp'...
[...]
Run `ibmcloud ce application get -n 'myapp'` to check the application status.
OK
https://myapp.4svg40kna19.us-south.codeengine.appdomain.cloud

當您執行 ibmcloud ce application get -n 'myapp' 來檢查應用程式狀態時，系統會顯示該應用程式的 URL。

指令選項

--name, -n

應用程式的名稱。 此欄位為必填項目。

--force, -f

強制刪除，而不進行確認。 此值為可選項。 預設值為 false。

--ignore-not-found, --inf

如果未找到，請勿失敗。 此值為可選項。 預設值為 false。

--no-wait, --nw

刪除應用程式，不要等待應用程式被刪除。 如果指定 no-wait 選項，應用程式會開始刪除，不會等待。 使用 app get 指令檢查應用程式狀態。 此值為可選項。 預設值為 true。

--quiet, -q

指定此選項可減少指令的輸出。 此值為可選項。 預設值為 false。

--wait, -w

刪除該應用程式，並等待應用程式完成刪除。 如果您指定 --wait 選項，應用程式刪除會等待 --wait-timeout 選項設定的最長秒數（以秒為單位），等待應用程式被刪除。 如果在指定的 --wait-timeout 期間內未刪除應用程式，則應用程式刪除失敗。 此值為可選項。 預設值為 false。

--wait-timeout, --wto

等待應用程式被刪除所需的時間（以秒為單位）。 如果指定了 --wait 選項，則必須使用此值。 如果指定了 --no-wait 選項，此值會被忽略。 預設值為 600。

範例

ibmcloud ce application delete --name myapp -f

輸出範例

Deleted application 'myapp'

指令選項

--application, --app, -a, --name, -n

顯示指定應用程式所有實體的事件。 如果未指定 --instance，則必須使用此值。

--instance, -i

特定應用程式實例的名稱。 使用 app get 指令找出實體名稱。 如果未指定 --application，則必須使用此值。

--output, -o

指定指令輸出的格式。 有效值為 json, yaml, jsonpath=JSONPATH_EXPRESSION，和 jsonpath-as-json=JSONPATH_EXPRESSION。 使用 jsonpath 指定 JSON 輸出元素的路徑。 此值為可選項。

--quiet, -q

指定此選項可減少指令的輸出。 此值為可選項。 預設值為 false。

範例

以下範例顯示指定應用程式所有實體的系統事件資訊。

ibmcloud ce application events --application myapp

Getting events for all instances of application 'myapp'...
OK
myapp-atfte-1-deployment-6b49c5fb85-kf4m2:
    Type    Reason     Age  Source                Messages
    Normal  Scheduled  31s  default-scheduler     Successfully assigned 4svg40kna19/myapp-atfte-1-deployment-6b49c5fb85-kf4m2 to 10.240.0.15
    Normal  Pulling    29s  kubelet, 10.240.0.15  Pulling image "icr.io/codeengine/hello@sha256:f0dc03250736a7b40a66ee70fee94fc470e08c864197aa2140054fee6ca9f9d6"
    Normal  Pulled     24s  kubelet, 10.240.0.15  Successfully pulled image "icr.io/codeengine/hello@sha256:f0dc03250736a7b40a66ee70fee94fc470e08c864197aa2140054fee6ca9f9d6" in 4.907426108s
    Normal  Created    24s  kubelet, 10.240.0.15  Created container user-container
    Normal  Started    24s  kubelet, 10.240.0.15  Started container user-container
    Normal  Pulled     24s  kubelet, 10.240.0.15  Container image "icr.io/obs/codeengine/knative-serving/queue-39be6f1d08a095bd076a71d288d295b6:v0.20.0-rc1@sha256:8988bea781130827b3e1006e6e5e7f49094343a5505c1927bb832be3470455f6" already present on machine
    Normal  Created    23s  kubelet, 10.240.0.15  Created container queue-proxy
    Normal  Started    23s  kubelet, 10.240.0.15  Started container queue-proxy

應用程式指定範例的系統事件資訊範例

以下範例顯示應用程式指定實例的系統事件資訊。 使用 app get 命令顯示應用程式的詳細資訊，包括應用程式的執行實體。

ibmcloud ce application events --instance myapp-li17x-1-deployment-69fd57bcb6-sr9tl

Getting events for application instance 'myapp-li17x-1-deployment-69fd57bcb6-sr9tl'...
OK
myapp-li17x-1-deployment-69fd57bcb6-sr9tl:
    Type     Reason     Age                    Source                Messages
    Normal   Scheduled  6m40s                  default-scheduler     Successfully assigned 4svg40kna19/myapp-li17x-1-deployment-69fd57bcb6-sr9tl to 10.240.64.6
    Normal   Pulling    6m39s                  kubelet, 10.240.64.6  Pulling image "icr.io/codeengine/hello@sha256:f0dc03250736a7b40a66ee70fee94fc470e08c864197aa2140054fee6ca9f9d6"
    Normal   Pulled     6m36s                  kubelet, 10.240.64.6  Successfully pulled image "icr.io/codeengine/hello@sha256:f0dc03250736a7b40a66ee70fee94fc470e08c864197aa2140054fee6ca9f9d6"
    Normal   Created    6m34s                  kubelet, 10.240.64.6  Created container user-container
    Normal   Started    6m33s                  kubelet, 10.240.64.6  Started container user-container
    Normal   Pulled     6m33s                  kubelet, 10.240.64.6  Container image "icr.io/obs/codeengine/knative-serving/queue-39be6f1d08a095bd076a71d288d295b6:v0.19.0-rc3@sha256:9cb525af53896afa6b5210b5ac56a893cf85b6cd013a61cb6503a005e40c5c6f" already present on machine
    Normal   Created    6m33s                  kubelet, 10.240.64.6  Created container queue-proxy
    Normal   Started    6m32s                  kubelet, 10.240.64.6  Started container queue-proxy
    [...]

指令選項

--name, -n

應用程式的名稱。 此欄位為必填項目。

--output, -o

指定指令輸出的格式。 有效值包括：json、yaml、jsonpath=JSONPATH_EXPRESSION、jsonpath-as-json=JSONPATH_EXPRESSION、url 以及 project-url。 使用 jsonpath 指定 JSON 輸出元素的路徑。 此值為可選項。

--quiet, -q

指定此選項可減少指令的輸出。 此值為可選項。 預設值為 false。

--show-all-revisions, -r

顯示此申請的所有修訂。 如果未指定，則只顯示設定為接收流量的修訂。 此值為可選項。 預設值為 false。

範例

ibmcloud ce application get --name myapp

輸出範例

Run 'ibmcloud ce application events -n myapp' to get the system events of the application instances.
Run 'ibmcloud ce application logs -f -n myapp' to follow the logs of the application instances.
OK
Name:          myapp
ID:            abcdefgh-abcd-abcd-abcd-1a2b3c4d5e6f
Project Name:  myproject
Project ID:    01234567-abcd-abcd-abcd-abcdabcd1111
Age:                31m
Created:            2021-09-09T14:01:02-04:00
URL:                https://myapp.abcdabcdabc.us-south.codeengine.appdomain.cloud
Cluster Local URL:  http://myapp.abcdabcdabc.svc.cluster.local
Console URL:        https://cloud.ibm.com/codeengine/project/us-south/01234567-abcd-abcd-abcd-abcdabcd1111/application/myapp/configuration
Status Summary:     Application deployed successfully  
Environment Variables:    
  Type     Name             Value  
  Literal  CE_API_BASE_URL  https://api.private.us-south.codeengine.cloud.ibm.com
  Literal  CE_APP           myapp  
  Literal  CE_DOMAIN        us-south.codeengine.appdomain.cloud  
  Literal  CE_PROJECT_ID    abcdefgh-abcd-abcd-abcd-1a2b3c4d5e6f
  Literal  CE_REGION        us-south  
  Literal  CE_SUBDOMAIN     abcdabcdab  
Image:                  icr.io/codeengine/helloworld  
Resource Allocation:      
  CPU:                1  
  Ephemeral Storage:  400M  
  Memory:             4G  
Revisions:     
  myapp-00001:    
    Age:                42s  
    Latest:             true  
    Traffic:            100%  
    Image:              icr.io/codeengine/helloworld (pinned to 1cee99)  
    Running Instances:  1  
Runtime:       
  Concurrency:       100  
  Maximum Scale:     10  
  Minimum Scale:     0  
  Scale Down Delay:  0  
  Timeout:           300  
Conditions:    
  Type                 OK    Age  Reason  
  ConfigurationsReady  true  25s    
  Ready                true  12s    
  RoutesReady          true  12s    
Events:        
  Type    Reason   Age  Source              Messages  
  Normal  Created  44s  service-controller  Created Configuration "myapp"  
  Normal  Created  43s  service-controller  Created Route "myapp"  
Instances:     
  Name                                    Revision     Running  Status   Restarts  Age  
  myapp-00001-deployment-d59b87654-xkqh7  myapp-00001  3/3      Running  0         43s

指令選項

--output, -o

指定指令輸出的格式。 有效值為 json, yaml, jsonpath=JSONPATH_EXPRESSION，和 jsonpath-as-json=JSONPATH_EXPRESSION。 使用 jsonpath 指定 JSON 輸出元素的路徑。 此值為可選項。

--quiet, -q

指定此選項可減少指令的輸出。 此值為可選項。 預設值為 false。

--sort-by, -s

指定清單排序的直欄。 有效值為 name 和 age。 此值為可選項。 預設值為 name。

範例

ibmcloud ce app list --sort-by age

輸出範例

Listing all applications...
OK
Name           Status  URL                                                                    Latest                 Age   Conditions  Reason
myapptestapp2  Ready   https://myapptestapp2.4svg40kna19.us-south.codeengine.appdomain.cloud  myapptestapp2-emy0q-1  52s   3 OK / 3
myapptestapp1  Ready   https://myapptestapp1.4svg40kna19.us-south.codeengine.appdomain.cloud  myapptestapp1-ps4ca-1  104s  3 OK / 3
myapp-e        Ready   https://myapp-e.4svg40kna19.us-south.codeengine.appdomain.cloud        myapp-e-gx6xa-1        12m   3 OK / 3
myappd         Ready   https://myappd.4svg40kna19.us-south.codeengine.appdomain.cloud         myappd-lxjxm-1         13m   3 OK / 3
myappc         Ready   https://myappc.4svg40kna19.us-south.codeengine.appdomain.cloud         myappc-qffan-1         14m   3 OK / 3
myappb         Ready   https://myappb.4svg40kna19.us-south.codeengine.appdomain.cloud         myappb-i3hw3-1         15m   3 OK / 3
myapp          Ready   https://myapp.4svg40kna19.us-south.codeengine.appdomain.cloud          myapp-jmxwd-1          17m   3 OK / 3

指令選項

--all-containers, --all

顯示指定應用程式實例的所有容器的日誌。 此值為可選項。 預設值為 false。

--application, --app, -a, --name, -n

顯示指定應用程式所有實體的日誌。 如果未指定 --instance，則必須使用此值。

--follow, -f

跟蹤應用程式實例的日誌。 使用此選項串流應用程式實體的記錄。 如果指定 --follow 選項，則必須輸入 Ctrl+C 才能終止此記錄指令。 此值為可選項。 預設值為 false。

--instance, -i

特定應用程式實例的名稱。 使用 app get 指令找出實體名稱。 如果未指定 --application，則必須使用此值。

--output, -o

指定指令輸出的格式。 有效值為 json, yaml, jsonpath=JSONPATH_EXPRESSION，和 jsonpath-as-json=JSONPATH_EXPRESSION。 使用 jsonpath 指定 JSON 輸出元素的路徑。 此值為可選項。

--quiet, -q

指定此選項可減少指令的輸出。 此值為可選項。 預設值為 false。

--raw, -r

顯示沒有實體和容器標籤的記錄。 此值為可選項。 預設值為 false。

--tail, -t

將指定應用程式實例的容器日誌顯示限制為每個容器的最近行數上限。 例如，若要顯示指定應用程式實體的容器的最後 3 行日誌，請指定 --tail 3。 如果未指定此選項，則會顯示指定應用程式實例的容器的所有日誌行。 此值為可選項。 預設值為 -1。

--timestamps, --ts

請在日誌輸出的每一行中加入時間戳記。 此值為可選項。 預設值為 false。

範例

以下範例會顯示應用程式特定實例的記錄。 使用 app get 指令取得應用程式實體的名稱。

ibmcloud ce application logs --instance myapp-zhk9x-1-deployment-6f955f5cc5-abcde

輸出範例

Getting logs for application instance 'myapp-zhk9x-1-deployment-6f955f5cc5-abcde'...
OK
myapp-zhk9x-1-deployment-6f955f5cc5-abcde:
Server running at http://0.0.0.0:8080/

應用程式所有實例的日誌範例

以下範例會顯示應用程式所有實體的日誌。

ibmcloud ce application logs --app myapp

Getting application 'myapp'...
Getting revisions for application 'myapp'...
Getting instances for application 'myapp'...
Getting logs for all instances of application 'myapp'...
OK
myapp-zhk9x-1-deployment-6f955f5cc5-abcde:
Server running at http://0.0.0.0:8080/

指令選項

--application, --app, -a, --name, -n

重新啟動所指定應用程式的所有執行中實例。 如果未指定 --instance，則必須使用此值。

--instance, -i

特定應用程式實例的名稱。 使用 app get 指令找出實體名稱。 如果未指定 --application，則必須使用此值。

--quiet, -q

指定此選項可減少指令的輸出。 此值為可選項。 預設值為 false。

範例

ibmcloud ce application restart --name myapp

輸出範例

Restarting all running instances of application 'myapp'...
OK

指令選項

--name, -n

要解除綁定的應用程式名稱。 此欄位為必填項目。

--all, -A

解除此應用程式所有服務實例的綁定。 如果未指定 --binding，則必須使用此值。 預設值為 false。

--binding, -b

要解除綁定的綁定名稱。 執行 ibmcloud ce app get -n APP_NAME 以檢視綁定名稱。 如果未指定 --all，則必須使用此值。

--quiet, -q

指定此選項可減少指令的輸出。 此值為可選項。 預設值為 false。

範例

在本範例中，移除應用程式中所有稱為 myapp 的綁定。

ibmcloud ce application unbind --name myapp --all

輸出範例

Removing service bindings...
OK

指令選項

--name, -n

應用程式的名稱。 此欄位為必填項目。

--argument, --arg, -a

設定應用程式的參數。 每個 --argument 選項指定一個參數；例如，-a argA -a argB。 此值為可選項。

--arguments-clear, --ac

清除應用程式參數。 此值為可選項。 預設值為 false。

--build-clear, --bc

從此應用程式中移除建置的關聯。 只有當您的應用程式目前有關聯的建立時，才允許使用建立清除選項。 此值為可選項。 預設值為 false。

--build-commit, --commit, --bcm, --cm, --revision

來源儲存庫中要取回的確定、標籤或分支。 只有當 --build-source 選項在此 app update 指令上設定為 Git 儲存庫的 URL，或您的應用程式目前有來自 Git 儲存庫來源的相關建置，才允許使用 build commit 選項。 此值為可選項。

--build-commit-clear, --commit-clear, --bcmc, --cmc

清除來源儲存庫中要取回的確定、標籤或分支。 如果您的應用程式目前有相關的建立，則允許使用 commit clear 選項。 此值為可選項。 預設值為 false。

--build-context-dir, --context-dir, --bcdr, --cdr

套件庫中包含 buildpacks 檔案或 Dockerfile 的目錄。 如果在此 app update 指令上設定了 --build-source 選項，或您的應用程式目前有相關的建立，則允許使用建立上下文目錄選項。 此值為可選項。

--build-dockerfile, --dockerfile, --bdf, --df

Dockerfile 的路徑。 僅在名稱不是 Dockerfile 時指定此選項。 build dockerfile 選項只有在 --build-source 選項被設定在這個 app update 指令上，或是你的應用程式目前有一個相關的 build 時才允許使用。 此值為可選項。 預設值為 Dockerfile。

--build-git-repo-secret, --git-repo-secret, --bgrs, --grs, --repo

SSH 密鑰的名稱，其中包含用來存取專用儲存庫的認證，該專用儲存庫包含用來建置容器映像檔的原始碼。 若要建立此 SSH 秘密，請使用 secret create --format SSH 指令。 SSH 秘密也可用作 Git 儲存庫存取秘 密。 只有當 --build-source 選項在此 application update 指令上設定為 Git 儲存庫的 URL，或您的應用程式目前有一個來自 Git 儲存庫來源的關聯建立，才允許使用此選項。 此值為可選項。

--build-git-repo-secret-clear, --git-repo-secret-clear, --bgrsc, --grsc

清除 SSH 密鑰。 如果您的應用程式目前有相關的建立，則允許使用此選項。 此值為可選項。 預設值為 false。

--build-size, --size, --bsz, --sz

建置的規模，這將決定所使用的資源量。 有效值包括：small、medium、large、xlarge 以及 xxlarge。 如需詳細資訊，請參閱 確定建立的大小。 只有在 app update 指令上設定了 --build-source 選項，或您的應用程式目前有相關的建立，才允許使用建立大小選項。 此值為可選項。 預設值為 medium。

--build-source, --source, --bsrc, --src

Git 儲存庫的 URL 或包含您原始碼的本機原始碼路徑；例如 https://github.com/IBM/CodeEngine 或 .。 此值為可選項。

--build-strategy, --strategy, --bstr, --str

用於建置映像檔的策略。 有效值為 dockerfile 和 buildpacks。 只有在 app update 指令上設定了 --build-source 選項，或您的應用程式目前有相關的建立，才允許使用建立策略選項。 如果未指定，則在指定 --build-source 且原始碼位於本機的情況下，由 Code Engine 決定建立策略。 此值為可選項。 預設值為 dockerfile。

--build-timeout, --bto

在建立成功或失敗之前所能經過的時間，以秒為單位。 僅當 --build-source 選項已在此 app update 指令上設定，或您的應用程式目前有相關的建立時，才允許使用建立逾時選項。 此值為可選項。 預設值為 600。

--cluster-local, --cl

使用僅限專案端點來部署應用程式。 設定「僅限專案」端點，表示您的應用程式無法透過公共網際網路存取，且僅能由在同一專案中執行的其他 Code Engine 元件進行網路存取。 此值為可選項。 預設值為 false。

--command, --cmd, -c

設定應用程式的指令。 每個 --command 選項指定一個指令；例如，--cmd cmdA --cmd cmdB。 此值會覆寫在容器影像中指定的預設命令。 此值為可選項。

--commands-clear, --cc

清除應用程式指令。 此值為可選項。 預設值為 false。

--concurrency, --cn

每個執行個體可同時處理的請求最大數量。 此值為可選項。 預設值為 0。

--concurrency-target, --ct

建立一個或多個額外實體時，每個實體的並發請求臨界值。 使用此值可根據並發請求數擴充實體。 如果 --concurrency-target 未指定，則此選項預設為 --concurrency 選項的值。 此值為可選項。 預設值為 0。

--cpu

為該應用程式執行個體設定的 CPU 數量。 有關有效值，請參閱 支援的記憶體和 CPU 組合。 此值為可選項。 預設值為 0。

--env, -e

在應用程式中設定環境變數。 必須採用 NAME=VALUE 格式。 此動作可新增環境變數或覆寫現有的環境變數。 每個 --env 選項指定一個環境變數；例如，--env envA=A --env envB=B。 此值為可選項。

--env-cm, --env-from-configmap

使用下列其中一種方式，從儲存於此 configmap 的 key-value 對中設定環境變數：

• 若要為名為 configmapName 的 configmap 中的所有按鍵新增環境變數，請使用值 configmapName。 您可以在引用 configmap 時指定前綴來修改環境變數名稱。 若要指定前綴，請使用 PREFIX=CONFIGMAP_NAME。 每個結果環境變數的格式為 <PREFIX><NAME_OF_KEY_IN_CONFIGMAP>. 例如，要將配置表 configmapName 中所有變量名稱的鍵的前綴設為 CUSTOM_，請使用值 CUSTOM_=configmapName。 如果配置映射 configmapName 包含 KEY_A，環境變數名稱就是 CUSTOM_KEY_A。
• 若要為個別金鑰新增環境變數，請使用格式 NAME:KEY_A,KEY_B. 例如，若要在名為 configmapName 的 configmap 中為單一關鍵 key1 新增環境變數，請使用 configmapName:key1。 若要為引用的按鍵指定不同的名稱，請使用格式 NAME:NEW_NAME=KEY_A。 例如，若要為名為 configmapName 的 configmap 中的單一鍵 key1 新增名為 myKey 的環境變數，請使用值 configmapName:myKey=key1。

此值為可選項。

--env-from-configmap-rm, --env-cm-rm

使用 configmap 名稱，移除對完整 configmap 的環境變數參照。 若要移除對 configmaps 的個別關鍵參照，請使用 --env-rm 選項。 此選項可以指定多次。 此值為可選項。

--env-sec, --env-from-secret

使用下列其中一種方式，從儲存於秘密中的鍵值對設定環境變數：

• 若要為命名為 secretName 的秘密中的所有金鑰新增環境變數，請使用 secretName。 您可以在引用秘密時指定前綴來修改環境變數名稱。 若要指定前綴，請使用 PREFIX=SECRET_NAME。 每個結果環境變數的格式為 <PREFIX><NAME_OF_KEY_IN_SECRET>. 例如，若要將密碼 secretName 中所有變數名稱的前綴設定為 CUSTOM_，請使用值 CUSTOM_=secretName。 如果密文 secretName 包含 KEY_A，環境變數名稱就是 CUSTOM_KEY_A。
• 若要為個別金鑰新增環境變數，請使用格式 NAME:KEY_A,KEY_B. 例如，若要在名稱為 secretName 的秘密中為單一金鑰 key1 新增環境變數，請使用 secretName:key1。 若要為引用的按鍵指定不同的名稱，請使用格式 NAME:NEW_NAME=KEY_A。 例如，要在一個名為 secretName 的秘密中為單一金鑰 key1 新增一個名為 myKey 的環境變數，請使用 secretName:myKey=key1 的值。

此值為可選項。

--env-from-secret-rm, --env-sec-rm

使用秘密名稱，移除對完整秘密的環境變數參照。 若要移除秘密的個別金鑰參照，請使用 --env-rm 選項。 此選項可以指定多次。 此值為可選項。

--env-rm

移除對 configmap 或 secret 中鍵值對的 key 的環境變數參照。 若要移除個別的關鍵參照和字面值，請指定關鍵的名稱。 此選項可以指定多次。 此值為可選項。

--ephemeral-storage, --es

要為應用程式實例設定的暫時儲存體數量。 若要表示兆位元組，請使用 M ；若要表示吉位元組，請使用 G。 此值為可選項。

--force, -f

不驗證指定的 configmap 和 secret 參照是否存在。 Configmap 引用是使用 --env-from-configmap 或 --mount-configmap 選項指定的。 秘密參照使用 --env-from-secret、--mount-secret 或 --registry-secret 選項指定。 此值為可選項。 預設值為 false。

--image, -i

用於此應用程式的影像名稱。 格式為 REGISTRY/NAMESPACE/REPOSITORY:TAG，其中 REGISTRY 和 TAG 皆為可選項目。 若未指定 REGISTRY，預設值為 docker.io。 若未指定 TAG，預設值為 latest。 此值為可選項。

--max-scale, --max, --maxscale

此應用程式可使用的最大實體數。 若將此值設定為 0``，應用程式便會根據需求進行擴展。 應用程式調整大小僅受限於應用程式專案的每個資源配額的實例數。 請參閱 Code Engine 的限制和配額。 此值為可選項。 預設值為 10。

--memory, -m

為該應用程式執行個體設定的記憶體用量。 若要表示兆位元組，請使用 M ；若要表示吉位元組，請使用 G。 有關有效值，請參閱 支援的記憶體和 CPU 組合。 此值為可選項。

--min-scale, --min, --minscale

此應用程式可使用的最小實體數量。 此值為可選項。 預設值為 0。

--mount-configmap, --mount-cm

透過提供掛載目錄和 configmap 的名稱，將 configmap 的內容加入應用程式容器的檔案系統，格式為 MOUNT_DIRECTORY=CONFIGMAP_NAME. 每個掛載的 configmap 必須使用唯一的掛載目錄。 對於 configmap 中的每個 key-value 對，都會新增一個檔案到指定的 mount 目錄，其中檔案名稱是 key，檔案內容是 key-value 對的值。 每個 --mount-configmap 選項指定一個掛載設定；例如，--mount-configmap /etc/config-a=config-a --mount-configmap /etc/config-b=config-b。 此值為可選項。

--mount-data-store, --mount-ds

裝載持續資料儲存庫。 格式為 MOUNT_DIRECTORY=STORAGE_NAME [:SUBPATH]。 SUBPATH 為選用。 此選項可以指定多次。 此值為可選項。

--mount-rm

從應用程式容器的檔案系統中移除 configmap 或 secret 的內容，方法是指定掛載 configmap 或 secret 的目錄。 每個 --mount-rm 選項指定一個掛載目錄；例如，--mount-rm /etc/configmap-a --mount-rm /etc/secret-b。 此值為可選項。

--mount-secret, --mount-sec

透過提供掛載目錄和秘密名稱，將秘密的內容加入應用程式容器的檔案系統，格式為 MOUNT_DIRECTORY=SECRET_NAME. 每個掛載的秘密必須使用唯一的掛載目錄。 對於秘密中的每個鍵值對，都會在指定的掛載目錄中加入一個檔案，其中檔案名稱是鍵，檔案內容是鍵值對的值。 每個 --mount-secret 選項指定一個掛載設定；例如，--mount-secret /etc/secret-a=secret--a --mount-secret /etc/secret-b=secret-b。 此值為可選項。

--no-cluster-local, --ncl

部署帶有公用端點的應用程式。 此應用程式的部署方式，使其能夠接收來自公共網際網路或「Code Engine」專案內各元件的請求。 此值為可選項。 預設值為 true。

--no-wait, --nw

更新申請，不要等待申請就緒。 如果指定 no-wait 選項，應用程式更新會開始，不會等待。 使用 app get 指令檢查應用程式狀態。 此值為可選項。 預設值為 false。

--output, -o

指定指令輸出的格式。 有效值包括：json、yaml、jsonpath=JSONPATH_EXPRESSION、jsonpath-as-json=JSONPATH_EXPRESSION、url 以及 project-url。 使用 jsonpath 指定 JSON 輸出元素的路徑。 此值為可選項。

--port, -p

應用程式監聽的連接埠。 格式為 [NAME:]PORT，其中 [NAME:] 為可選項目。 如果指定 [NAME:]，有效值為 h2c，或 http1。 當 [NAME:] 未指定或為 http1 時，埠會使用 HTTP/1.1。 當 [NAME:] 為 h2c 時，連接埠使用未加密的 HTTP/2。 預設情況下，Code Engine 假定應用程式會在 8080 連接埠上聽取傳入的連線。 如果您的應用程式需要在 8080 以外的連接埠聆聽，請使用 --port 指定連接埠。 此值為可選項。

--probe-live, --pl

以 NAME=VALUE 格式配置此應用程式的活性探測。 NAME 的有效選項為 type, port, path, interval, initial-delay, timeout, failure-threshold。此選項可指定多次。 type 屬性為必填項目，有效值為 tcp 和 http。 例如，--probe-live type=tcp --probe-live port=8080。 有關使用探針的詳細資訊，請參閱 為您的應用程式配置探針。 此值為可選項。

--probe-live-clear, --plr

移除活性探測。 只有當您的應用程式目前有一個 liveness probe 時，才允許此選項。 此值為可選項。 預設值為 false。

--probe-ready, --pr

以 NAME=VALUE 格式配置此應用程式的就緒探測。 NAME 的有效選項為 type, port, path, interval, initial-delay, timeout, failure-threshold。此選項可指定多次。 type 屬性為必填項目，有效值為 tcp 和 http。 例如，--probe-ready type=tcp --probe-ready port=8080。 有關使用探針的詳細資訊，請參閱 為您的應用程式配置探針。 此值為可選項。

--probe-ready-reset, --prr

將就緒探測重設為預設配置。 此值為可選項。 預設值為 false。

--quiet, -q

指定此選項可減少指令的輸出。 此值為可選項。 預設值為 false。

--rebuild

從來源重建映像檔。 如果您的應用程式目前有相關的建立，則允許使用重建選項。 此值為可選項。 預設值為 false。

--registry-secret, --rs

登錄密鑰的名稱。 當您下載容器映像檔時，會使用登錄密鑰向專用登錄進行鑑別。 此值為可選項。

--registry-secret-clear, --rsc

清除登錄密鑰。 此值為可選項。 預設值為 false。

--request-timeout, --rt, --timeout, -t

向應用程式提出的要求必須成功或失敗之前所能經過的時間 (以秒為單位)。 此值為可選項。 預設值為 0。

--rn, --revision-name

修訂的名稱。 請使用在該應用程式內具有唯一性的名稱。

• 名稱可以包含小寫字母、數字和連字號（-）。
• 名稱必須以小寫英數字元結尾。
• 完全限定的版本名稱格式必須為 Name_of_application-Name of revision。
• 完全合格的版本名稱必須少於 63 個字元。

此值為可選項。

--scale-down-delay, --sdd

縮減應用程式之前，必須以減少並行處理的時間（秒）。 並發要求數量的增加會導致應用程式擴充。 如果請求數下降（並發量降低），此選項的指定時間量會決定在應用程式縮小之前，並發量降低需要持續多久。 預設情況下，如果偵測到並發量減少，應用程式會立即縮小。 此值為可選項。 預設值為 0。

--service-account, --sa

服務帳戶的名稱。 服務帳戶提供在實例中執行之程序的身分。 對於內建服務帳戶，您可以使用縮寫名稱 manager, none, reader，以及 writer。 您也可以使用以 Kubernetes Config Context 為前綴的全名，這可以使用 project current 指令來確定。 此值為可選項。

--service-account-clear, --sac

清除服務帳戶。 此值為可選項。 預設值為 false。

--trusted-profiles-enabled, --trusted, --tpe

啟用計算資源記號裝載到此應用程式的儲存器。 此值為可選項。 預設值為 false。

--user, -u

用於執行應用程式的使用者 ID (UID)。 此值會覆寫應用程式 Dockerfile 中設定的任何使用者 ID。 ID 必須符合容器的作業系統要求。 此值為可選項。 預設值為 0。

--visibility, -v

應用程式的可見性。 有效值為 public、private 以及 project。 設定能見度為 public 表示您的應用程式可以接收來自公開網際網路或 Code Engine 專案內元件的請求。 設定能見度為 private 表示您的應用程式無法從公共網際網路存取，只能從使用虛擬私人端點 (VPE) 的其他 IBM Cloud 或在相同專案中執行的 Code Engine 元件進行網路存取。 只有當專案支援「應用程式私有」可見性時，可見性才可能為 private。 將可見性設定為「project」，表示您的應用程式無法透過公共網際網路存取，且僅能由在同一專案中執行的其他 Code Engine 元件進行網路存取。 此值為可選項。

--wait, -w

更新應用程式，並等待應用程式就緒。 如果指定 --wait 選項，應用程式更新會等待 --wait-timeout 選項設定的最長時間（以秒為單位），讓應用程式準備就緒。 如果應用程式未在指定的 --wait-timeout 期間內就緒，則應用程式建立失敗。 此值為可選項。 預設值為 true。

--wait-timeout, --wto

等待應用程式更新的時間（以秒為單位）。 如果指定了 --wait 選項，則必須使用此值。 如果指定了 --no-wait 選項，此值會被忽略。 預設值為 600。

範例

ibmcloud ce application update --name myapp --image icr.io/codeengine/hello

輸出範例

Updating application 'myapp' to latest revision.
[...]
Run 'ibmcloud ce application get -n myapp' to check the application status.
OK
https://myapp.4svg40kna19.us-south.codeengine.appdomain.cloud

範例

ibmcloud ce beta help

輸出範例

NAME:
  ibmcloud code-engine beta - Beta Code Engine commands
USAGE:
  ibmcloud code-engine beta command [arguments...] [command options]
COMMANDS:
  help, h   Show help
Enter 'ibmcloud code-engine beta help [command]' for more information about a command.

指令選項

-n, --name

建立的名稱。 請使用專案內唯一的名稱。

• 名稱必須以小寫的英數字元開頭，並以小寫的英數字元結尾。
• 名稱必須為 63 個字元或以下，並可包含小寫字母數字字元和連字號 (-)。

此欄位為必填項目。

--build-type, --bt

建置的類型。 有效值為 git 和 local。 如果建立的類型是 local，那麼 --source、--commit 和 --git-repo-secret 選項就無效。 此值為可選項。 預設值為 git。

--commit, --cm, --revision

來源儲存庫中要取回的確定、標籤或分支。 如果 --build-type 選項是 git，則允許使用 commit 選項；如果 --build-type 選項是 local，則不允許使用 commit 選項。 此值為可選項。

--context-dir, --cdr

套件庫中包含 buildpacks 檔案或 Dockerfile 的目錄。 此值為可選項。

--dockerfile, --df

Dockerfile 的路徑。 僅在名稱不是 Dockerfile 時指定此選項。 此值為可選項。 預設值為 Dockerfile。

--force, -f

不驗證指定的秘密參照是否存在。 秘密參照使用 --get-repo-secret 或 --registry-secret 選項指定。 此值為可選項。 預設值為 false。

--git-repo-secret, --grs, --repo, -r

SSH 密鑰的名稱，其中包含用來存取專用儲存庫的認證，該專用儲存庫包含用來建置容器映像檔的原始碼。 若要建立此 SSH 秘密，請使用 secret create --format SSH 指令。 SSH 秘密也可用作 Git 儲存庫存取秘 密。 如果 --build-type 選項為 git，則允許使用此選項；如果 --build-type 選項為 local，則不允許使用此選項。 此值為可選項。

--image, -i

影像登錄的位置。 格式為 REGISTRY/NAMESPACE/REPOSITORY:TAG，其中 TAG 為可選項目。 若未指定 TAG，預設值為 latest。 此值為可選項。

--output, -o

指定指令輸出的格式。 有效值為 json, yaml, jsonpath=JSONPATH_EXPRESSION，和 jsonpath-as-json=JSONPATH_EXPRESSION。 使用 jsonpath 指定 JSON 輸出元素的路徑。 此值為可選項。

--quiet, -q

指定此選項可減少指令的輸出。 此值為可選項。 預設值為 false。

--registry-secret, --rs

用於存取註冊表的註冊表密碼。 您可以透過執行 registry create 指令來新增註冊密碼。 此值為可選項。

--size, --sz

建置的規模，這將決定所使用的資源量。 有效值包括：small、medium、large、xlarge 以及 xxlarge。 如需詳細資訊，請參閱 確定建立的大小。 此值為可選項。 預設值為 medium。

--source, --src

包含您的原始碼的 Git 套件庫的 URL；例如 https://github.com/IBM/CodeEngine。 如果 --build-type 選項是 git，則需要使用來源選項；如果 --build-type 選項是 local，則不允許使用來源選項。 此值為可選項。

--strategy, --str

用於建置映像檔的策略。 對於應用程式和職位，有效值為 dockerfile 及 buildpacks。 對於函數，有效值的格式為 codebundle-[RUNTIME-ID]。 例如，如果您要為運行時 ID 為 nodejs-24 的函數建立程式碼束，請使用 codebundle-nodejs-24 作為建立策略。 您可以透過執行 ibmcloud ce fn runtimes 指令，找出任何支援的函式執行時的 ID。 此值為可選項。 預設值為 dockerfile。

--timeout, --to

在建立成功或失敗之前所能經過的時間，以秒為單位。 此值為可選項。 預設值為 600。

範例

以下範例從原始 Dockerfile 建立一個名為 helloworld-build 的建立設定檔，該檔案位於 main 分支中 hello 目錄內的 https://github.com/IBM/CodeEngine，策略為 dockerfile，大小為 medium。 當提交此建立時，建立的容器映像會儲存在 us.icr.io/mynamespace/codeengine-helloworld 的 Container Registry 實例中，該實例可透過使用稱為 myregistry 的映像註冊密碼來存取。

ibmcloud ce build create --name helloworld-build --source https://github.com/IBM/CodeEngine  --context-dir /hello --commit main --strategy dockerfile --size medium --image us.icr.io/mynamespace/codeengine-helloworld --registry-secret myregistry

輸出範例

Creating build helloworld-build...
OK

指令選項

--name, -n

建立的名稱。 此欄位為必填項目。

--force, -f

強制刪除，而不進行確認。 此值為可選項。 預設值為 false。

--ignore-not-found, --inf

如果未找到，請勿失敗。 此值為可選項。 預設值為 false。

--quiet, -q

指定此選項可減少指令的輸出。 此值為可選項。 預設值為 false。

範例

ibmcloud ce build delete --name helloworld-build

輸出範例

Are you sure you want to delete build helloworld-build? [y/N]> y
Deleting build 'helloworld-build'...
OK

指令選項

--name, -n

建立的名稱。 此欄位為必填項目。

--output, -o

指定指令輸出的格式。 有效值為 json, yaml, jsonpath=JSONPATH_EXPRESSION，和 jsonpath-as-json=JSONPATH_EXPRESSION。 使用 jsonpath 指定 JSON 輸出元素的路徑。 此值為可選項。

--quiet, -q

指定此選項可減少指令的輸出。 此值為可選項。 預設值為 false。

範例

ibmcloud ce build get --name helloworld-build

輸出範例

Getting build 'helloworld-build'
OK
Name:          helloworld-build
ID:            abcdefgh-abcd-abcd-abcd-1a2b3c4d5e6f
Project Name:  myproject
Project ID:    01234567-abcd-abcd-abcd-abcdabcd1111
Age:           15s
Created:       2021-03-14T14:48:19-05:00  
Status:        Succeeded
Reason:        all validations succeeded
Last Build Run:
  Name:     helloworld-build-run
  Age:      39d
  Created:  2021-09-30T15:19:33-04:00
Image:              us.icr.io/mynamespace/codeengine-helloworld
Registry Secret:    myregistry
Build Strategy:     dockerfile-medium
Timeout:            10m0s
Source:             https://github.com/IBM/CodeEngine
Commit:             main
Context Directory:  /hello
Dockerfile:         Dockerfile
Build Runs:
  Name                  Status                              Image                                        Age
  helloworld-build-run  All Steps have completed executing  us.icr.io/mynamespace/codeengine-helloworld  39d

指令選項

--output, -o

指定指令輸出的格式。 有效值為 json, yaml, jsonpath=JSONPATH_EXPRESSION，和 jsonpath-as-json=JSONPATH_EXPRESSION。 使用 jsonpath 指定 JSON 輸出元素的路徑。 此值為可選項。

--quiet, -q

指定此選項可減少指令的輸出。 此值為可選項。 預設值為 false。

--sort-by, -s

指定清單排序的直欄。 有效值為 name 和 age。 此值為可選項。 預設值為 name。

範例

ibmcloud ce build list

輸出範例

Listing builds...
OK
Name                    Status     Reason                     Image                                               Build Strategy     Age    Last Build Run Name                        Last Build Run Age
myhellobuild           Succeeded  all validations succeeded  us.icr.io/mynamespace/codeengine-codeengine-200      dockerfile-medium  160d   myhellobuild-run-4xdnb                    160d
hello-build-5ckgs      Succeeded  all validations succeeded  us.icr.io/mynamespace/codeengine-codeengine-51       dockerfile-medium  39d    helloapp3-build-5ckgs-run-210803-2129500   39d
hello-build-pmg6v      Succeeded  all validations succeeded  us.icr.io/mynamespace/codeengine-codeengine-4f       dockerfile-medium  40d    hellooapp2-build-pmg6v-run-210802-2112310  40d
helloworld-build       Succeeded  all validations succeeded  us.icr.io/mynamespace/codeengine-helloworld          dockerfile-medium  39d    helloworld-build-run                       39d

指令選項

--name, -n

建立的名稱。 此欄位為必填項目。

--commit, --cm, --revision

來源儲存庫中要取回的確定、標籤或分支。 此值為可選項。

--commit-clear, --cmc

清除來源儲存庫中要取回的確定、標籤或分支。 此值為可選項。 預設值為 false。

--context-dir, --cdr

套件庫中包含 buildpacks 檔案或 Dockerfile 的目錄。 此值為可選項。

--dockerfile, --df

Dockerfile 的路徑。 僅在名稱不是 Dockerfile 時指定此選項。 此值為可選項。 預設值為 Dockerfile。

--force, -f

不驗證指定的秘密參照是否存在。 秘密參照使用 --get-repo-secret 或 --registry-secret 選項指定。 此值為可選項。 預設值為 false。

--git-repo-secret, --grs, --repo, -r

SSH 密鑰的名稱，其中包含用來存取專用儲存庫的認證，該專用儲存庫包含用來建置容器映像檔的原始碼。 若要建立此 SSH 秘密，請使用 secret create --format SSH 指令。 SSH 秘密也可用作 Git 儲存庫存取秘 密。 此值為可選項。

--git-repo-secret-clear, --grsc

清除 SSH 密鑰。 此值為可選項。 預設值為 false。

--image, -i

影像登錄的位置。 格式為 REGISTRY/NAMESPACE/REPOSITORY:TAG，其中 TAG 為可選項目。 若未指定 TAG，預設值為 latest。 此值為可選項。

--output, -o

指定指令輸出的格式。 有效值為 json, yaml, jsonpath=JSONPATH_EXPRESSION，和 jsonpath-as-json=JSONPATH_EXPRESSION。 使用 jsonpath 指定 JSON 輸出元素的路徑。 此值為可選項。

--quiet, -q

指定此選項可減少指令的輸出。 此值為可選項。 預設值為 false。

--registry-secret, --rs

登錄密鑰的名稱。 當您下載容器映像檔時，會使用登錄密鑰向專用登錄進行鑑別。 此值為可選項。

--size, --sz

建置的規模，這將決定所使用的資源量。 有效值包括：small、medium、large、xlarge 以及 xxlarge。 如需詳細資訊，請參閱 確定建立的大小。 此值為可選項。

--source, --src

包含您的原始碼的 Git 套件庫的 URL；例如 https://github.com/IBM/CodeEngine。 此值為可選項。

--strategy, --str

用於建置映像檔的策略。 對於應用程式和職位，有效值為 dockerfile 及 buildpacks。 對於函數，有效值的格式為 codebundle-[RUNTIME-ID]。 例如，如果您要為運行時 ID 為 nodejs-24 的函數建立程式碼束，請使用 codebundle-nodejs-24 作為建立策略。 您可以透過執行 ibmcloud ce fn runtimes 指令，找出任何支援的函式執行時的 ID。 此值為可選項。

--timeout, --to

在建立成功或失敗之前所能經過的時間，以秒為單位。 此值為可選項。 預設值為 600。

範例

ibmcloud ce build update --name helloworld-build --source https://github.com/IBM/CodeEngine  --context-dir /hello --commit main --timeout 900

輸出範例

Updating build helloworld-build...
OK

指令選項

--name, -n

建立執行的名稱。 此欄位為必填項目。

--quiet, -q

指定此選項可減少指令的輸出。 此值為可選項。 預設值為 false。

範例

ibmcloud ce buildrun cancel --name mybuildrun

輸出範例

Canceling build run 'mybuildrun'...
OK

指令選項

--build, -b

使用此選項刪除指定建置的所有建置執行。 如果未指定 --name 值，則 --build 選項為必填選項。 此值為可選項。

--force, -f

強制刪除，而不進行確認。 此值為可選項。 預設值為 false。

--ignore-not-found, --inf

如果未找到，請勿失敗。 此值為可選項。 預設值為 false。

--name, -n

建立執行的名稱。 如果未指定 --build 值，則 --name 選項為必填選項。 此值為可選項。

--quiet, -q

指定此選項可減少指令的輸出。 此值為可選項。 預設值為 false。

範例

ibmcloud ce buildrun delete --name mybuildrun

輸出範例

Are you sure you want to delete build run mybuildrun? [y/N]> y
Deleting build run 'mybuildrun'...
OK

指令選項

--buildrun, -b, --br, --name, -n

建立執行的名稱。 此欄位為必填項目。

--output, -o

指定指令輸出的格式。 有效值為 json, yaml, jsonpath=JSONPATH_EXPRESSION，和 jsonpath-as-json=JSONPATH_EXPRESSION。 使用 jsonpath 指定 JSON 輸出元素的路徑。 此值為可選項。

--quiet, -q

指定此選項可減少指令的輸出。 此值為可選項。 預設值為 false。

範例

本範例顯示建立執行的系統事件資訊。

ibmcloud ce buildrun events --buildrun mybuildrun

輸出範例

Getting build run 'mybuildrun'...
Getting instances of build run 'mybuildrun'...
Getting events for build run 'mybuildrun'...
OK
mybuildrun-l4mr2-pod-89z4t:
    Type    Reason     Age  Source                  Messages
    Normal  Scheduled  33s  default-scheduler       Successfully assigned 4svg40kna19/mybuildrun-l4mr2-pod-89z4t to 10.240.128.97
    Normal  Pulled     31s  kubelet, 10.240.128.97  Container image "gcr.io/distroless/base@sha256:92720b2305d7315b5426aec19f8651e9e04222991f877cae71f40b3141d2f07e" already present on machine
    Normal  Created    31s  kubelet, 10.240.128.97  Created container working-dir-initializer
    Normal  Started    31s  kubelet, 10.240.128.97  Started container working-dir-initializer
    Normal  Pulled     30s  kubelet, 10.240.128.97  Container image "icr.io/obs/codeengine/tekton-pipeline/entrypoint-bff0a22da108bc2f16c818c97641a296:v0.20.1-rc2@sha256:19ec0672b5e84a4c5939c6ece6fa69efbce0d38479baf35ce894cf1c67f7e435" already present on machine
    Normal  Created    30s  kubelet, 10.240.128.97  Created container place-tools
    Normal  Started    29s  kubelet, 10.240.128.97  Started container place-tools
    Normal  Pulled     28s  kubelet, 10.240.128.97  Container image "gcr.io/distroless/base@sha256:92720b2305d7315b5426aec19f8651e9e04222991f877cae71f40b3141d2f07e" already present on machine
    Normal  Created    28s  kubelet, 10.240.128.97  Created container step-create-dir-image-l7lf2
    Normal  Created    25s  kubelet, 10.240.128.97  Created container step-git-source-source-46fm7
    Normal  Pulled     25s  kubelet, 10.240.128.97  Container image "icr.io/obs/codeengine/tekton-pipeline/git-init-4874978a9786b6625dd8b6ef2a21aa70:v0.20.1-rc2@sha256:5febfb32459a114b7beafdc593770a0f692a09d874ac6b59ce85507844641cdf" already present on machine
    Normal  Started    25s  kubelet, 10.240.128.97  Started container step-create-dir-image-l7lf2
    Normal  Started    24s  kubelet, 10.240.128.97  Started container step-git-source-source-46fm7
    Normal  Pulled     24s  kubelet, 10.240.128.97  Container image "icr.io/obs/codeengine/kaniko/executor:v1.3.0-rc1" already present on machine
    Normal  Created    24s  kubelet, 10.240.128.97  Created container step-build-and-push
    Normal  Started    24s  kubelet, 10.240.128.97  Started container step-build-and-push
    Normal  Pulled     24s  kubelet, 10.240.128.97  Container image "icr.io/obs/codeengine/tekton-pipeline/imagedigestexporter-6e7c518e6125f31761ebe0b96cc63971:v0.20.1-rc2@sha256:21b3120ce9b930b4eb1359eb20a3109e3a6643e9d2777ef9694efb033367e57c" already present on machine
    Normal  Created    24s  kubelet, 10.240.128.97  Created container step-image-digest-exporter-gnbrp
    Normal  Started    23s  kubelet, 10.240.128.97  Started container step-image-digest-exporter-gnbrp

指令選項

--name, -n

建立執行的名稱。 此欄位為必填項目。

--output, -o

指定指令輸出的格式。 有效值為 json, yaml, jsonpath=JSONPATH_EXPRESSION，和 jsonpath-as-json=JSONPATH_EXPRESSION。 使用 jsonpath 指定 JSON 輸出元素的路徑。 此值為可選項。

--quiet, -q

指定此選項可減少指令的輸出。 此值為可選項。 預設值為 false。

範例

ibmcloud ce buildrun get --name mybuildrun

輸出範例

Getting build run 'mybuildrun'...
Run 'ibmcloud ce buildrun events -n mybuildrun' to get the system events of the build run.
Run 'ibmcloud ce buildrun logs -f -n mybuildrun' to follow the logs of the build run.
OK
Name:          mybuildrun
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:        All Steps have completed executing  
Source:          
  Commit Branch:  main  
  Commit SHA:     abcdeb88263442e28af6ae26d2082dea1d6abcde  
  Commit Author:  myauthor  
Image Digest:  sha256:522488ca3b54eb65f8c1e609a7b27c08558d08166fe062e7dde6838d4a609d61  
Image:  us.icr.io/mynamespace/test

指令選項

--build, -b

使用此選項可僅顯示指定建置的建置執行。 此值為可選項。

--output, -o

指定指令輸出的格式。 有效值為 json, yaml, jsonpath=JSONPATH_EXPRESSION，和 jsonpath-as-json=JSONPATH_EXPRESSION。 使用 jsonpath 指定 JSON 輸出元素的路徑。 此值為可選項。

--quiet, -q

指定此選項可減少指令的輸出。 此值為可選項。 預設值為 false。

--sort-by, -s

指定清單排序的直欄。 有效值為 name 和 age。 此值為可選項。 預設值為 name。

範例

ibmcloud ce buildrun list

輸出範例

Listing builds...
OK
Name                                  Status     Build Name        Age
helloworld-build-run                  Succeeded  helloworld-build  5d22h
mybuildrun                            Succeeded  helloworld-build  7m23s
mybuildrun2                           Succeeded  helloworld-build  3m4s

指令選項

--buildrun, -b, --br, --name, -n

建立執行的名稱。 此欄位為必填項目。

--follow, -f

遵循建立執行的記錄。 使用此選項串流建立執行的記錄。 如果指定 --follow 選項，則必須輸入 Ctrl+C 才能終止此記錄指令。 此值為可選項。 預設值為 false。

--output, -o

指定指令輸出的格式。 有效值為 json, yaml, jsonpath=JSONPATH_EXPRESSION，和 jsonpath-as-json=JSONPATH_EXPRESSION。 使用 jsonpath 指定 JSON 輸出元素的路徑。 此值為可選項。

--quiet, -q

指定此選項可減少指令的輸出。 此值為可選項。 預設值為 false。

--raw, -r

顯示沒有實體和容器標籤的記錄。 此值為可選項。 預設值為 false。

--tail, -t

將指定建立執行的容器日誌顯示限制為每個容器最近行數的最大值。 例如，若要顯示指定建立執行的容器的最後 3 行日誌，請指定 --tail 3。 如果未指定此選項，則會顯示指定建立執行的容器的所有日誌行。 此值為可選項。 預設值為 -1。

--timestamps, --ts

請在日誌輸出的每一行中加入時間戳記。 此值為可選項。 預設值為 false。

範例

ibmcloud ce buildrun logs --name mybuildrun

輸出範例

Getting build run 'mybuildrun'...
Getting instances of build run 'mybuildrun'...
Getting logs for build run 'mybuildrun'...
OK
mybuildrun-v2mb8-pod-tlzdx/step-git-source-source-g2kbf:
{"level":"info","ts":1614089507.7123275,"caller":"git/git.go:165","msg":"Successfully cloned https://github.com/IBM/CodeEngine @ 433e2b8d6529e4a55f5e0f72d3772a79602a5ee8 (grafted, HEAD, origin/main) in path /workspace/source"}
{"level":"info","ts":1614089509.0128207,"caller":"git/git.go:203","msg":"Successfully initialized and updated submodules in path /workspace/source"}
mybuildrun-v2mb8-pod-tlzdx/step-build-and-push:
INFO[0000] Retrieving image manifest node:12-alpine
INFO[0000] Retrieving image node:12-alpine
INFO[0001] Retrieving image manifest node:12-alpine
INFO[0001] Retrieving image node:12-alpine
INFO[0001] Built cross stage deps: map[]
INFO[0001] Retrieving image manifest node:12-alpine
INFO[0001] Retrieving image node:12-alpine
INFO[0002] Retrieving image manifest node:12-alpine
INFO[0002] Retrieving image node:12-alpine
INFO[0002] Executing 0 build triggers
INFO[0002] Unpacking rootfs as cmd RUN npm install requires it.
INFO[0006] RUN npm install
INFO[0006] Taking snapshot of full filesystem...
INFO[0008] cmd: /bin/sh
INFO[0008] args: [-c npm install]
INFO[0008] Running: [/bin/sh -c npm install]
npm WARN saveError ENOENT: no such file or directory, open '/package.json'
npm notice created a lockfile as package-lock.json. You should commit this file.
npm WARN enoent ENOENT: no such file or directory, open '/package.json'
npm WARN !invalid#2 No description
npm WARN !invalid#2 No repository field.
npm WARN !invalid#2 No README data
npm WARN !invalid#2 No license field.
up to date in 0.27s
found 0 vulnerabilities
INFO[0010] Taking snapshot of full filesystem...
INFO[0010] COPY server.js .
INFO[0010] Taking snapshot of files...
INFO[0010] EXPOSE 8080
INFO[0010] cmd: EXPOSE
INFO[0010] Adding exposed port: 8080/tcp
INFO[0010] CMD [ "node", "server.js" ]
mybuildrun-v2mb8-pod-tlzdx/step-image-digest-exporter-hcvmf:
2021/02/23 14:11:43 warning: unsuccessful cred copy: ".docker" from "/tekton/creds" to "/tekton/home": unable to open destination: open /tekton/home/.docker/config.json: permission denied
{"severity":"INFO","timestamp":"2021-02-23T14:12:05.65581098Z","caller":"logging/config.go:115","message":"Successfully created the logger.","logging.googleapis.com/labels":{},"logging.googleapis.com/sourceLocation":{"file":"github.com/tektoncd/pipeline/vendor/knative.dev/pkg/logging/config.go","line":"115","function":"github.com/tektoncd/pipeline/vendor/knative.dev/pkg/logging.newLoggerFromConfig"}}
{"severity":"INFO","timestamp":"2021-02-23T14:12:05.655937558Z","caller":"logging/config.go:116","message":"Logging level set to: info","logging.googleapis.com/labels":{},"logging.googleapis.com/sourceLocation":{"file":"github.com/tektoncd/pipeline/vendor/knative.dev/pkg/logging/config.go","line":"116","function":"github.com/tektoncd/pipeline/vendor/knative.dev/pkg/logging.newLoggerFromConfig"}}

指令選項

--build, -b, --bd

要使用的建置配置名稱。 此值為可選項。

--commit, --cm, --revision

來源儲存庫中要取回的確定、標籤或分支。 如果 --source 選項設定為 Git 儲存庫的 URL，則允許 build commit 選項；如果 --source 選項未設定為 Git 儲存庫的 URL，則不允許 build commit 選項。 此值為可選項。

--context-dir, --cdr

套件庫中包含 buildpacks 檔案或 Dockerfile 的目錄。 如果 --build 選項未設定，則允許使用建立上下文目錄選項；如果 --build 選項已設定，則不允許使用建立上下文目錄選項。 此值為可選項。

--dockerfile, --df

Dockerfile 的路徑。 僅在名稱不是 Dockerfile 時指定此選項。 如果沒有設定 --build 選項，就允許使用 build dockerfile 選項；如果設定了 --build 選項，就不允許使用 build dockerfile 選項。 此值為可選項。 預設值為 Dockerfile。

--git-repo-secret, --grs, --repo, -r

SSH 密鑰的名稱，其中包含用來存取專用儲存庫的認證，該專用儲存庫包含用來建置容器映像檔的原始碼。 若要建立此 SSH 秘密，請使用 secret create --format SSH 指令。 SSH 秘密也可用作 Git 儲存庫存取秘 密。 只有在 --build-source 選項設定為 Git 儲存庫的 URL 時，才允許使用此選項。 此值為可選項。

--image, -i

影像登錄的位置。 格式為 REGISTRY/NAMESPACE/REPOSITORY:TAG，其中 TAG 為可選項目。 若未指定 TAG，預設值為 latest。 此值為可選項。

-n, --name

建立執行的名稱。 請使用專案內唯一的名稱。 如果設定了 --build 選項，則 name 選項是可選的。 如果未設定 --build 選項，則必須使用 name 選項。

• 名稱必須以小寫的英數字元開頭，並以小寫的英數字元結尾。
• 名稱必須為 63 個字元或以下，並可包含小寫字母數字字元和連字號 (-)。

此值為可選項。

--no-wait, --nw

提交建立執行，不要等待此建立執行完成。 如果指定 --no-wait 選項，則會開始提交建立執行，而不會等待。 使用 buildrun get 指令檢查建立執行狀態。 此值為可選項。 預設值為 true。

--output, -o

指定指令輸出的格式。 有效值為 json, yaml, jsonpath=JSONPATH_EXPRESSION，和 jsonpath-as-json=JSONPATH_EXPRESSION。 使用 jsonpath 指定 JSON 輸出元素的路徑。 此值為可選項。

--quiet, -q

指定此選項可減少指令的輸出。 此值為可選項。 預設值為 false。

--registry-secret, --rs

登錄密鑰的名稱。 當您下載容器映像檔時，會使用登錄密鑰向專用登錄進行鑑別。 如果 --build 選項未設定，則允許使用註冊密碼選項；如果 --build 選項已設定，則不允許使用註冊密碼選項。 此值為可選項。

--service-account, --sa

服務帳戶的名稱。 服務帳戶提供在實例中執行之程序的身分。 對於內建服務帳戶，您可以使用縮寫名稱 manager, none, reader，以及 writer。 您也可以使用以 Kubernetes Config Context 為前綴的全名，這可以使用 project current 指令來確定。 此值為可選項。

--size, --sz

建置的規模，這將決定所使用的資源量。 有效值包括：small、medium、large、xlarge 以及 xxlarge。 如需詳細資訊，請參閱 確定建立的大小。 如果 --build 選項未設定，則允許使用建立大小選項；如果 --build 選項已設定，則不允許使用建立大小選項。 此值為可選項。 預設值為 medium。

--source, --src

Git 儲存庫的 URL 或包含您原始碼的本機原始碼路徑；例如 https://github.com/IBM/CodeEngine 或 .。 如果設定了 --build 選項，如果相關建置上的 --build-type 選項是 local，則源選項是必需的；如果相關建置上的 --build-type 選項是 git，則源選項是不允許的。 如果沒有設定 --build 選項，來源選項是可選的。 此值為可選項。 預設值為 .。

--strategy, --str

用於建置映像檔的策略。 對於應用程式和職位，有效值為 dockerfile 及 buildpacks。 對於函數，有效值的格式為 codebundle-[RUNTIME-ID]。 例如，如果您要為運行時 ID 為 nodejs-24 的函數建立程式碼束，請使用 codebundle-nodejs-24 作為建立策略。 您可以透過執行 ibmcloud ce fn runtimes 指令，找出任何支援的函式執行時的 ID。 如果 --build 選項未設定，則允許使用建立策略選項；如果 --build 選項已設定，則不允許使用建立策略選項。 如果未指定，則在指定 --source 且原始碼位於本機的情況下，由 Code Engine 決定建立策略。 此值為可選項。 預設值為 dockerfile。

--timeout, --to

在建立執行成功或失敗之前所能經過的時間，以秒為單位。 此值為可選項。 預設值為 600。

--wait, -w

提交建立執行，並等待此建立執行完成。 如果指定 --wait 選項，建立執行提交會等待 --wait-timeout 選項設定的最長時間（以秒為單位）完成建立執行。 如果建立執行未在指定的 --wait-timeout 期間內完成，建立執行提交會失敗。 此值為可選項。 預設值為 false。

--wait-timeout, --wto

等待此建置執行完成所需的時間（以秒為單位）。 如果指定了 --wait 選項，則必須使用此值。 如果指定了 --no-wait 選項，此值會被忽略。 預設值為 600。

範例

以下指令會提交稱為 mybuildrun 的建立執行，並使用稱為 helloworld-build 的建立設定檔案。

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

輸出範例

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

指令選項

-n, --name

configmap 的名稱。 請使用專案內唯一的名稱。

• 名稱必須以小寫的英數字元開頭，並以小寫的英數字元結尾。
• 名稱必須為 253 個字元或以下，並可包含小寫字母、數字、句點 (.) 和連字號 (-)。

此欄位為必填項目。

--from-env-file, -e

從檔案建立 configmap，該檔案包含符合格式 KEY=VALUE 的一或多行。 您必須提供檔案的路徑作為值。 指定檔案中的每一行都會以鍵值對的方式加入。 指定檔案中的任何空行或以 # 開頭的行都會被忽略。 如果未指定 --from-literal 或 --from-file，則必須使用此值。

--from-file, -f

從檔案建立一個 ConfigMap。 您必須提供檔案的路徑作為值。 如果未指定 --from-literal 或 --from-env-file，則必須使用此值。

--from-literal, -l

從鍵值對建立 configmap。 必須採用 KEY=VALUE 格式。 如果未指定 --from-file 或 --from-env-file，則必須使用此值。 此選項可以指定多次。

--output, -o

指定指令輸出的格式。 有效值為 json, yaml, jsonpath=JSONPATH_EXPRESSION，和 jsonpath-as-json=JSONPATH_EXPRESSION。 使用 jsonpath 指定 JSON 輸出元素的路徑。 此值為可選項。

--quiet, -q

指定此選項可減少指令的輸出。 此值為可選項。 預設值為 false。

範例

以下範例建立了一個名為 configmap-fromliteral 的 configmap，其中有兩個關鍵對值：color=blue 和 size=large。

ibmcloud ce configmap create --name configmap-fromliteral --from-literal color=blue --from-literal size=large

輸出範例

Creating Configmap 'configmap-fromliteral'...
OK
Run 'ibmcloud ce configmap get -n configmap-fromliteral' to see more details.

包含來自多個檔案的值的 configmap 範例

以下範例建立了一個名為 configmap-fromfile 的 configmap，其中包含來自多個檔案的值。

ibmcloud ce configmap create --name configmap-fromfile  --from-file ./color.txt --from-file ./size.txt

Creating configmap 'configmap-fromfile'...
OK
Run 'ibmcloud ce configmap get -n configmap-fromfile' to see more details.

指令選項

--name, -n

configmap 的名稱。 此欄位為必填項目。

--force, -f

強制刪除，而不進行確認。 此值為可選項。 預設值為 false。

--ignore-not-found, --inf

如果未找到，請勿失敗。 此值為可選項。 預設值為 false。

--quiet, -q

指定此選項可減少指令的輸出。 此值為可選項。 預設值為 false。

範例

ibmcloud ce configmap delete --name configmap-fromliteral -f

輸出範例

Deleting Configmap 'configmap-fromliteral'...
OK

指令選項

--name, -n

configmap 的名稱。 此欄位為必填項目。

--output, -o

指定指令輸出的格式。 有效值為 json, yaml, jsonpath=JSONPATH_EXPRESSION，和 jsonpath-as-json=JSONPATH_EXPRESSION。 使用 jsonpath 指定 JSON 輸出元素的路徑。 此值為可選項。

--quiet, -q

指定此選項可減少指令的輸出。 此值為可選項。 預設值為 false。

範例

ibmcloud ce configmap get --name configmap-fromliteral

輸出範例

Getting configmap 'configmap-fromliteral'...
OK
Name:          configmap-fromliteral
ID:            abcdefgh-abcd-abcd-abcd-1a2b3c4d5e6f
Project Name:  myproject
Project ID:    01234567-abcd-abcd-abcd-abcdabcd1111
Age:           21s
Created:       2021-03-01T13:50:56-05:00
Data:
---
color: blue
size: large

指令選項

--output, -o

指定指令輸出的格式。 有效值為 json, yaml, jsonpath=JSONPATH_EXPRESSION，和 jsonpath-as-json=JSONPATH_EXPRESSION。 使用 jsonpath 指定 JSON 輸出元素的路徑。 此值為可選項。

--quiet, -q

指定此選項可減少指令的輸出。 此值為可選項。 預設值為 false。

--sort-by, -s

指定清單排序的直欄。 有效值為 name 和 age。 此值為可選項。 預設值為 name。

範例

ibmcloud ce configmap list

輸出範例

Listing Configmaps...
Name                    Data   Age
configmap-fromfile      2      19m13s
configmap-fromliteral   2      16m12s

指令選項

--name, -n

configmap 的名稱。 此欄位為必填項目。

--from-env-file, -e

從檔案更新 configmap，該檔案包含符合格式 KEY=VALUE 的一行或多行。 您必須提供檔案的路徑作為值。 指定檔案中的每一行都會以鍵值對的方式加入。 指定檔案中的任何空行或以 # 開頭的行都會被忽略。 如果未指定 --from-literal 或 --from-file，則必須使用此值。 此選項可以指定多次。

--from-file, -f

從檔案更新 configmap。 您必須提供檔案的路徑作為值。 如果未指定 --from-literal 或 --from-env-file，則必須使用此值。 此選項可以指定多次。

--from-literal, -l

從鍵值對更新配置表。 必須採用 KEY=VALUE 格式。 如果未指定 --from-file 或 或 --from-env-file，則必須使用此值。 此選項可以指定多次。

--output, -o

指定指令輸出的格式。 有效值為 json, yaml, jsonpath=JSONPATH_EXPRESSION，和 jsonpath-as-json=JSONPATH_EXPRESSION。 使用 jsonpath 指定 JSON 輸出元素的路徑。 此值為可選項。

--quiet, -q

指定此選項可減少指令的輸出。 此值為可選項。 預設值為 false。

--rm

透過指定鍵的名稱，移除 configmap 中的個別鍵值對。 此選項可以指定多次。 此值為可選項。

範例

以下範例以使用者名稱和密碼值對更新名為 configmap-fromliteral 的 configmap。

ibmcloud ce configmap update --name configmap-fromliteral --from-literal username=devuser --from-literal password='A!B99c$D1Def'

輸出範例

Updating configmap 'configmap-fromliteral'...
OK
Run 'ibmcloud ce configmap get -n configmap-fromliteral' to see more details.

包含檔案值的 configmap 範例

以下範例使用檔案中的值更新名為 configmap-fromfile 的 configmap。

ibmcloud ce configmap update --name configmap-fromfile  --from-file ./username.txt --from-file ./password.txt

Updating configmap 'configmap-fromfile'...
OK
Run 'ibmcloud ce configmap get -n configmap-fromfile' to see more details.

範例

ibmcloud ce connectivity outbound create --name allow-to-subnet-a --cidr 5.6.7.8/29

輸出範例

Creating allowed destination IP address range 'allow-to-subnet-a'...
OK

建立私有路徑出站連線的範例

ibmcloud ce connectivity outbound create --name my-pps-connection --format pps --pps-crn crn:v1:bluemix:public:is:eu-de:a/abcdefabcdefabcdefabcd1234567890::private-path-service-gateway:r010-2b2b2b2b-3c3c-4d4d-5e5e-6f6f6f6f6f6f

建立私有路徑出站連線的輸出範例

Creating allowed outbound destination 'my-pps-connection'...
Successfully created allowed outbound destination 'my-pps-connection'. Current status is 'deploying'
Run 'ibmcloud ce connectivity outbound get --name my-pps-connection' to see more details.
OK

範例

ibmcloud ce connectivity outbound delete --name allow-to-subnet-a

輸出範例

Are you sure you want to delete allowed outbound destination 'allow-to-subnet-a'? [y/N]> y
Deleting allowed outbound destination 'allow-to-subnet-a'...
OK

範例

ibmcloud ce connectivity outbound get --name allow-to-subnet-a

輸出範例

Getting allowed outbound destination 'allow-to-subnet-a'...
OK
Project name:  myproj
Name:          allow-to-subnet-a
Format:        cidr_block  
IP address range:  5.6.7.8/29

取得私有路徑出站連線的範例

ibmcloud ce connectivity outbound get --name my-pps-connection

取得私有路徑出站連線的輸出範例

Getting allowed outbound destination 'my-pps-connection'...
OK
Project name:  myproj
Name:          my-pps-connection
Format:        private_path_service_gateway  
Private path service:    
  CRN:        crn:v1:bluemix:public:is:eu-de:a/abcdefabcdefabcdefabcd1234567890::private-path-service-gateway:r010-2b2b2b2b-3c3c-4d4d-5e5e-6f6f6f6f6f6f
  Status:     ready  
  Name:       my-private-path--is-vpc-pps  
  Endpoints:    
    api.ce-1a2b3c4d5e6f.intra  
VPE gateway:             
  Name:          code-engine-prod-eu-de-1234ab
  IP addresses:    
    192.168.12.48
    192.168.24.60
    192.168.36.72

範例

ibmcloud ce connectivity outbound list

輸出範例

Listing allowed outbound destinations...
OK
CIDR ranges:                 
  Name               IP address range  
  allow-to-subnet-a  5.6.7.8/29
  allow-to-subnet-b  11.12.13.0/24
Private path connections:    
  Name               Status  Service endpoints  
  broken-connection  failed    
  my-pps-connection  ready   api.ce-1a2b3c4d5e6f.intra

範例

ibmcloud ce connectivity outbound update --name allow-to-subnet-a --cidr 5.6.7.0/27

輸出範例

Updating allowed destination IP address range 'allow-to-subnet-a'...
OK

範例

ibmcloud ce connectivity subnetpool create --name my-other-pool \
  --subnet-crn S1=crn:v1:bluemix:public:is:eu-de-3:a/abcdefabcdefabcdefabcd1234567890::subnet:1a1a-2b2b2b2b-3c3c-4d4d-5e5e-6f6f6f6f6f21 \
  --security-group-crn S1=crn:v1:bluemix:public:is:eu-de:a/abcdefabcdefabcdefabcd1234567890::security-group:2b2b-3c3c3c3c-4d4d-5e5e-6f6f-7g7g7g7g7g7g \
  --subnet-crn IDx=crn:v1:bluemix:public:is:eu-de-3:a/abcdefabcdefabcdefabcd1234567890::subnet:1a1a-2b2b2b2b-3c3c-4d4d-5e5e-6f6f6f6f6f22 \
  --security-group-crn IDx=crn:v1:bluemix:public:is:eu-de:a/abcdefabcdefabcdefabcd1234567890::security-group:2b2b-3c3c3c3c-4d4d-5e5e-6f6f-7g7g7g7g7g7g \
  --security-group-crn IDx=crn:v1:bluemix:public:is:eu-de:a/abcdefabcdefabcdefabcd1234567890::security-group:2b2b-3c3c3c3c-4d4d-5e5e-6f6f-7g7g7g7g7g8h

輸出範例

OK
Successfully created subnet pool with name 'my-other-pool' and ID 'a23ff1d1-b845-4629-86d1-a4126155ad02'

範例

ibmcloud ce connectivity subnetpool delete --name my-subnet-pool

輸出範例

Are you sure you want to delete subnet pool '1a1a1a1a-2b2b-3c3c-4d4d-5e5e5e5e5e5e'? [y/N]> y
Deleting subnet pool with name 'my-subnet-pool' and ID '1a1a1a1a-2b2b-3c3c-4d4d-5e5e5e5e5e5e'
OK

範例

ibmcloud ce connectivity subnetpool get --name my-subnet-pool

輸出範例

Getting subnet pool 'my-subnet-pool'...
OK
Name:          my-subnet-pool  
ID:            1a1a1a1a-2b2b-3c3c-4d4d-5e5e5e5e5e5e  
Project name:  myproject  
Project ID:    01234567-abcd-abcd-abcd-abcdabcd1111  
Age:           114d  
Network placement:    
  Number of subnets:   1  
                       
  Subnet CRN:          crn:v1:bluemix:public:is:eu-de-3:a/abcdefabcdefabcdefabcd1234567890::subnet:1a1a-2b2b2b2b-3c3c-4d4d-5e5e-6f6f6f6f6f6f  
  Security Group CRN:  crn:v1:bluemix:public:is:eu-de:a/abcdefabcdefabcdefabcd1234567890::security-group:2b2b-3c3c3c3c-4d4d-5e5e-6f6f-7g7g7g7g7g7g

範例

ibmcloud ce connectivity subnetpool list

輸出範例

Listing all subnet pools in a project...
OK
Name                          ID                                    Subnets  Region  Age  
auto-network-pool-gg55edn1xe  hgfedcba-dcba-abcd-abcd-1a2b3c4d5e6f  1        eu-de   93d  
my-other-pool                 abcdefgh-abcd-abcd-abcd-1a2b3c4d5e6f  3        eu-de   25h  
my-subnet-pool                1a1a1a1a-2b2b-3c3c-4d4d-5e5e5e5e5e5e  1        eu-de   114d

指令選項

--domain-name, --dn, -n, --name

指定網域對映的名稱。 此名稱必須是有效的完整網域名稱 (FQDN)。 例如，www.example.com。 此欄位為必填項目。

--target, -t

目標應用程式或函數的名稱。 此欄位為必填項目。

--target-type, --type

目標的類型。 有效值為 application 或 function。 此欄位為必填項目。

--tls-secret, --secret, --tls

請指定一個 TLS 密鑰，其中須包含該網域對應的憑證（含所有中間憑證）以及對應的私鑰。 憑證必須由授信公用憑證管理中心 (CA) 簽署。 不支援自簽憑證。 此欄位為必填項目。

--quiet, -q

指定此選項可減少指令的輸出。 此值為可選項。 預設值為 false。

範例

以下範例在 應用程式與自訂網域 之間建立自訂網域對應，並使用 秘書。 在 Code Engine myapp 應用程式和自訂網域 www.example.com 之間建立自訂網域對應，並使用 TLS 秘 密 mytlssecret。

ibmcloud ce domainmapping create --domain-name www.example.com --target myapp --tls-secret mytlssecret

輸出範例

OK
Domain mapping successfully created.

指令選項

--domain-name, --dn, -n, --name

網域對映的名稱。 此欄位為必填項目。

--force, -f

強制刪除，而不進行確認。 此值為可選項。 預設值為 false。

--ignore-not-found, --inf

如果未找到，請勿失敗。 此值為可選項。 預設值為 false。

--quiet, -q

指定此選項可減少指令的輸出。 此值為可選項。 預設值為 false。

範例

ibmcloud ce domainmapping delete --name www.example.com -f

輸出範例

Deleting domain mapping 'www.example.com'...
OK

指令選項

--domain-name, --dn, -n, --name

網域對應的名稱 此值為必填。

--output, -o

指定指令輸出的格式。 有效值為 json, yaml, jsonpath=JSONPATH_EXPRESSION，和 jsonpath-as-json=JSONPATH_EXPRESSION。 使用 jsonpath 指定 JSON 輸出元素的路徑。 此值為可選項。

--quiet, -q

指定此選項可減少指令的輸出。 此值為可選項。 預設值為 false。

範例

ibmcloud ce domainmapping get --name www.example.com

輸出範例

Getting domainmapping 'www.example.com'...
OK
Domain Name:  www.example.com  
CNAME:        custom.abcdabcdabc.us-south.codeengine.appdomain.cloud  
Target Name:  myapp  
Target Type:  app  
TLS Secret:   mytlssecret  
Status:       ready  

指令選項

--all, -a

顯示專案中的所有網域對映，包括自訂和系統網域對映。 此值為可選項。 預設值為 false。

--output, -o

指定指令輸出的格式。 有效值為 json, yaml, jsonpath=JSONPATH_EXPRESSION，和 jsonpath-as-json=JSONPATH_EXPRESSION。 使用 jsonpath 指定 JSON 輸出元素的路徑。 此值為可選項。

--quiet, -q

指定此選項可減少指令的輸出。 此值為可選項。 預設值為 false。

--sort-by, -s

指定清單排序的直欄。 有效值為 name 和 age。 此值為可選項。 預設值為 name。

範例

以下範例會顯示所有自訂網域對應的清單。

ibmcloud ce domainmapping list

輸出範例

Listing domain mappings...
OK
Name              CNAME                                                        Target  Target-Type  Status  Secret Name  Age  
www.example.com   custom.abcdabcdabc.us-south.codeengine.appdomain.cloud       myapp   app          ready   mytlssecret  36m    

若要檢視應用程式的所有網域映射清單，包括自訂網域映射和任何自動產生的系統網域映射，請使用 --all 選項指定 ibmcloud ce domainmapping list 指令指定 選項。

指令選項

--domain-name, --dn, -n, --name

網域對映的名稱。 此欄位為必填項目。

--quiet, -q

指定此選項可減少指令的輸出。 此值為可選項。 預設值為 false。

--target, -t

目標應用程式或函數的名稱。 此值為可選項。

--target-type, --type

目標的類型。 有效值為 application 或 function。 此值為可選項。

--tls-secret, --secret, --tls

請指定一個 TLS 密鑰，其中須包含該網域對應的憑證（含所有中間憑證）以及對應的私鑰。 憑證必須由授信公用憑證管理中心 (CA) 簽署。 不支援自簽憑證。 此值為可選項。

範例

以下範例更新 www.example.com 網域對應，使用 mytlssecret2 取代 mytlssecret。

ibmcloud ce domainmapping update --domain-name www.example.com --tls-secret mytlssecret2

輸出範例

Updating domainmapping 'www.example.com'...

範例

ibmcloud ce experimental help

輸出範例

NAME:
  ibmcloud code-engine experimental - Experimental Code Engine commands
USAGE:
  ibmcloud code-engine experimental command [arguments...] [command options]
COMMANDS:
  help, h   Show help
Enter 'ibmcloud code-engine experimental help [command]' for more information about a command.

指令選項

--id, --fid, --fleet-id

必要。 無伺服器 Fleet 的 ID。 此欄位為必填項目。

--force, -f

在未經確認的情況下進行強制取消。 此值為可選項。 預設值為 false。

--hard

立即取消包含處於「running」狀態任務的無伺服器叢集。 若未指定「hard」選項，處於「running」狀態的任務將持續處理，直至其達到最終狀態為止；唯有在此之後，任務群才會轉為「canceled」狀態。 此值為可選項。 預設值為 false。

--quiet, -q

指定此選項可減少指令的輸出。 此值為可選項。 預設值為 false。

範例

ibmcloud ce fleet cancel --force --fleet-id 1a1a1a1a-2b2b-3c3c-4d4d-5e5e5e5e5e5e

輸出範例

Canceling serverless fleet...
Run 'ibmcloud ce fleet get --fleet-id 1a1a1a1a-2b2b-3c3c-4d4d-5e5e5e5e5e5e' to check the fleet status.
OK
Name:            fleet-0123456789
ID:              1a1a1a1a-2b2b-3c3c-4d4d-5e5e5e5e5e5e
Status:          canceled  
Created:         39m  
Project region:  eu-de  
Project name:    myproj  
Tasks status:    
  Failed:      0  
  Canceled:    0  
  Successful:  0  
  Running:     0  
  Pending:     1  
  Total:       1  

指令選項

--image, -i

必要。 用於處理作業的儲存器映像檔名稱。 格式為 REGISTRY/NAMESPACE/REPOSITORY:TAG，其中 REGISTRY 和 TAG 皆為可選項目。 若未指定 REGISTRY，預設值為 docker.io。 若未指定 TAG，預設值為 latest。 此欄位為必填項目。

--tasks-state-store, --ts-state

必要。 指定用於儲存 Fleet 作業狀態的持續資料儲存庫。 此欄位為必填項目。

--argument, --arg, -a

設定作業中要執行的指令所需的指令引數。 此選項可以指定多次。 此值為可選項。

--command, --cmd, -c

在作業中設定執行指令。 此選項可以指定多次。 此值為可選項。

--cpu, --cp

為作業設定的 CPU 數量。 此值為可選項。 預設值為 1。

--env, -e

設定環境變數以傳遞到作業中。 必須是 NAME=VALUE 格式。 此選項可以指定多次。 此值為可選項。

--env-from-configmap, --env-cm

從儲存於此 configmap 的 key-value 對設定環境變數。 提供 NAME 以參照完整配置對映，或提供 PREFIX=NAME 以參照完整配置對映（其中每一個索引鍵都以 PREFIX 為字首），或提供 NAME:KEY_A,KEY_B 以參照個別索引鍵。 若要指定所參照索引鍵的新名稱，請使用格式 NAME:NEW_KEY_NAME = KEY_A。 此選項可以指定多次。 此值為可選項。

--env-from-secret, --env-sec

從儲存於此秘密的鍵值對設定環境變數。 提供 NAME 以參照完整密鑰，或提供 PREFIX=NAME 以參照完整密鑰（其中每一個索引鍵都以 PREFIX 為字首），或提供 NAME:KEY_A,KEY_B 以參照個別索引鍵。 若要指定所參照索引鍵的新名稱，請使用格式 NAME:NEW_KEY_NAME = KEY_A。 此選項可以指定多次。 此值為可選項。

--gpu, --gp

要分配給該資源的 GPU 數。 格式為 GPU_FAMILY:NUMBER_OF_GPUS。 NUMBER_OF_GPUS 的預設值為 1，且可以設定為分數。 例如，h100:0.5 此值為選項。

--max-scale, --maxscale, --max

可同時執行的作業實例最大數量。 此值為可選項。 預設值為 1。

--maxexecutiontime, --met

作業執行的最大執行時間（以秒為單位）。 此值為可選項。 預設值為 0。

--memory, -m

為作業設定的記憶體數量。 若要表示兆位元組，請使用 M ；若要表示吉位元組，請使用 G。 此值為可選項。 預設值為 2G。

--mount-data-store, --mount-ds

裝載持續資料儲存庫。 格式為 MOUNT_DIRECTORY=STORAGE_NAME: [SUBPATH]。 SUBPATH 為選用。 此選項可以指定多次。 此值為可選項。

--name, -n

Fleet 的名稱。 此值為可選項。

--quiet, -q

指定此選項可減少指令的輸出。 此值為可選項。 預設值為 false。

--registry-secret, --rs

登錄密鑰的名稱。 登錄密鑰用於與專用登錄進行鑑別，以下載儲存器映像檔。 執行 ibmcloud ce registry create 以建立登錄機密。 此值為可選項。

--retrylimit, -r

在將作業標記為失敗之前，重新執行該作業的次數。 此值為可選項。 預設值為 3。

--subnetpool-id, --spi

用於 Fleet 網路放置的子網路儲存區 ID。 此值為可選項。

--subnetpool-name, --spn

用於 Fleet 網路放置的子網路儲存區名稱。 此值為可選項。

--task-indexes, --ti

請指定要處理的任務索引，例如 0,3,6,9、1-5,7-8,10。 指定最多 1000 個索引項目。 若已指定 --tasks ，則無法指定此選項。 此值為可選項。

--tasks, --ts

指定要由 Fleet 處理的作業數量。 若未提供任何工作規格選項，則會使用此選項，其預設值為 1。

--tasks-from-cos-bucket, --ts-bucket

指定 COS 儲存區中檔案的位置。 對於每個檔案，作業將由 Fleet 處理。 此值為可選項。

--tasks-from-cos-object, --ts-cos

指定位於 COS 儲存區中的 JSONL 檔案位置。 該檔案定義了要由 Fleet 處理的作業。 此值為可選項。

--tasks-from-local-file, --ts-file

指定本端 JSONL 檔案的路徑。 該檔案定義了要由 Fleet 處理的作業。 此值為可選項。

--worker-profile, --profile, --prof

提供受支援的工作程式設定檔喜好設定。 此值為可選項。

範例

ibmcloud ce fleet create --image icr.io/codeengine/helloworld --subnetpool-name my-pool --tasks-state-store mytaskstore --tasks 1

輸出範例

Successfully created fleet with name 'fleet-0123456789' and ID '1a1a1a1a-2b2b-3c3c-4d4d-5e5e5e5e5e5e'
Run 'ibmcloud ce fleet get --fleet-id 1a1a1a1a-2b2b-3c3c-4d4d-5e5e5e5e5e5e' to check the fleet status.
Run 'ibmcloud ce fleet worker list --fleet-id 1a1a1a1a-2b2b-3c3c-4d4d-5e5e5e5e5e5e' to retrieve a list of provisioned workers.
Run 'ibmcloud ce fleet task list --fleet-id 1a1a1a1a-2b2b-3c3c-4d4d-5e5e5e5e5e5e' to retrieve a list of tasks.
OK

指令選項

--id, --fid, --fleet-id

必要。 無伺服器 Fleet 的 ID。 此欄位為必填項目。

--force, -f

強制刪除，而不進行確認。 此值為可選項。 預設值為 false。

--ignore-not-found, --inf

如果未找到，請勿失敗。 此值為可選項。 預設值為 false。

--quiet, -q

指定此選項可減少指令的輸出。 此值為可選項。 預設值為 false。

--wait, -w

刪除無伺服器 Fleet，並等待 Fleet 刪除完成。 此值為可選項。 預設值為 false。

--wait-timeout, --wto

等待無伺服器 Fleet 被刪除所需的時間（以秒為單位） 此值為可選項。 預設值為 180。

範例

ibmcloud ce fleet delete --force --fleet-id 1a1a1a1a-2b2b-3c3c-4d4d-5e5e5e5e5e5e

輸出範例

Deleting serverless fleet...
OK

指令選項

--id, --fid, --fleet-id

必要。 無伺服器 Fleet 的 ID。 此欄位為必填項目。

--output, -o

輸出格式。 有效值為 json, yaml, jsonpath=JSONPATH_EXPRESSION，和 jsonpath-as-json=JSONPATH_EXPRESSION。 此值為可選項。

--quiet, -q

指定此選項可減少指令的輸出。 此值為可選項。 預設值為 false。

範例

ibmcloud ce fleet get --fleet-id 1a1a1a1a-2b2b-3c3c-4d4d-5e5e5e5e5e5e

輸出範例

Getting fleet '1a1a1a1a-2b2b-3c3c-4d4d-5e5e5e5e5e5e'...
OK
Name:            fleet-0123456789  
ID:              1a1a1a1a-2b2b-3c3c-4d4d-5e5e5e5e5e5e  
Status:          running  
Created:         2025-09-26T10:46:02Z  
Project region:  eu-de  
Project name:    myproj  
Tasks status:             
  Pending:     893  
  Running:     12  
  Failed:      0  
  Canceled:    0  
  Successful:  96  
  Total:       1001  
Code:                     
  Container image reference:  icr.io/codeengine/helloworld  
Tasks specification:      
  Task state store:  mytaskstore  
  Indexes:           0-1000  
Resources and scaling:    
  CPU per instance:         1  
  Memory per instance:      2G  
  Max number of instances:  12  
  Max retries per task:     3  
Network placement:        
  Subnet pools:    
    Name:                my-pool-
    Number of subnets:   1  
                         
    Subnet CRN:          crn:v1:bluemix:public:is:eu-de-1:a/abcdefabcdefabcdefabcd1234567890::subnet:1a1a-2b2b2b2b-3c3c-4d4d-5e5e-6f6f6f6f6f6f   
    Security Group CRN:  crn:v1:bluemix:public:is:eu-de:a/abcdefabcdefabcdefabcd1234567890::security-group:2b2b-3c3c3c3c-4d4d-5e5e-6f6f-7g7g7g7g7g7g  
Environment Variables:    
  Type     Name   Value  
  Literal  FOO    bar

指令選項

--output, -o

輸出格式。 有效值為 json, yaml, jsonpath=JSONPATH_EXPRESSION，和 jsonpath-as-json=JSONPATH_EXPRESSION。 此值為可選項。

--quiet, -q

指定此選項可減少指令的輸出。 此值為可選項。 預設值為 false。

--sort-by, -s

指定清單排序的直欄。 有效值為 name、status 及 age。 此值為可選項。 預設值為 name。

範例

ibmcloud ce fleet list

輸出範例

Listing fleets...
OK
Name              ID                                    Status      Tasks finished  Tasks total  Instances  Created  
fleet-a123456789  0a0a0a0a-2b2b-3c3c-4d4d-5e5e5e5e5e5e  successful  300             300          0          2025-09-26T12:11:28Z  
fleet-b123456789  1a1a1a1a-2b2b-3c3c-4d4d-5e5e5e5e5e5e  running     778             1001         12         2025-09-26T12:43:11Z  
fleet-c123456789  2a2a2a2a-2b2b-3c3c-4d4d-5e5e5e5e5e5e  canceled    1               1            0          2025-09-26T10:46:02Z  

指令選項

--quiet, -q

指定此選項可減少指令的輸出。 此值為可選項。 預設值為 false。

範例

ibmcloud ce fleet task get --fleet-id 1a1a1a1a-2b2b-3c3c-4d4d-5e5e5e5e5e5e --task-id 2b2b2b2b-3c3c-4d4d-5e5e-6f6f6f6f6f6f

輸出範例

Getting serverless fleet task '2b2b2b2b-3c3c-4d4d-5e5e-6f6f6f6f6f6f'...
OK
ID:            2b2b2b2b-3c3c-4d4d-5e5e-6f6f6f6f6f6f  
Task index:    226  
Created:       2025-09-26T12:45:58Z  
Finished:      2025-09-26T12:47:03Z  
Fleet ID:      1a1a1a1a-2b2b-3c3c-4d4d-5e5e5e5e5e5e  
Project name:  myproj  
Project ID:    3c3c3c3c-4d4d-5e5e-6f6f-7g7g7g7g7g7g  
State information:    
  Status:       successful  
  Retries:      0  
  Worker name:  fleet-1a1a1a1a-2b2b-3c3c-4d4d-5e5e5e5e5e5e-1

範例

ibmcloud ce fleet task list --fleet-id 1a1a1a1a-2b2b-3c3c-4d4d-5e5e5e5e5e5e

輸出範例

Listing serverless fleet tasks...
OK
Task index  ID                                    Status   Result code  Worker name  
0           5b2b2b2b-3c3c-4d4d-5e5e-6f6f6f6f6f6f  successful  0            fleet-1a1a1a1a-2b2b-3c3c-4d4d-5e5e5e5e5e5e-0
1           4b2b2b2b-3c3c-4d4d-5e5e-6f6f6f6f6f6f  running                  fleet-1a1a1a1a-2b2b-3c3c-4d4d-5e5e5e5e5e5e-1
2           3b2b2b2b-3c3c-4d4d-5e5e-6f6f6f6f6f6f  pending
3           2b2b2b2b-3c3c-4d4d-5e5e-6f6f6f6f6f6f  running                  fleet-1a1a1a1a-2b2b-3c3c-4d4d-5e5e5e5e5e5e-1
4           1b2b2b2b-3c3c-4d4d-5e5e-6f6f6f6f6f6f  successful  0            fleet-1a1a1a1a-2b2b-3c3c-4d4d-5e5e5e5e5e5e-0

指令選項

--quiet, -q

指定此選項可減少指令的輸出。 此值為可選項。 預設值為 false。

範例

ibmcloud ce fleet worker delete --force --fleet-id 1a1a1a1a-2b2b-3c3c-4d4d-5e5e5e5e5e5e --worker-name fleet-1a1a1a1a-2b2b-3c3c-4d4d-5e5e5e5e5e5e-42

輸出範例

Deleting serverless fleet worker...
OK

範例

ibmcloud ce fleet worker get --fleet-id 1a1a1a1a-2b2b-3c3c-4d4d-5e5e5e5e5e5e --worker-name fleet-1a1a1a1a-2b2b-3c3c-4d4d-5e5e5e5e5e5e-42

輸出範例

Getting serverless fleet worker...
OK
Name:          fleet-1a1a1a1a-2b2b-3c3c-4d4d-5e5e5e5e5e5e-42  
ID:            2b2b2b2b-3c3c-4d4d-5e5e-6f6f6f6f6f6f  
Created:       2025-09-26T20:05:33Z  
Status:        running  
Version:       v1.0.15  
Fleet ID:      1a1a1a1a-2b2b-3c3c-4d4d-5e5e5e5e5e5e  
Project name:  myproj  
Project ID:    3c3c3c3c-4d4d-5e5e-6f6f-7g7g7g7g7g7g  
Network placement:      
  IP address:    10.242.0.42  
  Network zone:  eu-de-1  
  Subnet CRN:    crn:v1:bluemix:public:is:eu-de-1:a/abcdefabcdefabcdefabcd1234567890::subnet:1a1a-2b2b2b2b-3c3c-4d4d-5e5e-6f6f6f6f6f6f  
Profile information:    
  Profile:       cx2-2x4  
  vCPUs:         2  
  Memory (GiB):  4  

範例

ibmcloud ce fleet worker list --fleet-id 1a1a1a1a-2b2b-3c3c-4d4d-5e5e5e5e5e5e

輸出範例

Listing serverless fleet workers...
OK
Name                                          ID                                    Status        Profile   IP           Zone     Version  
fleet-1a1a1a1a-2b2b-3c3c-4d4d-5e5e5e5e5e5e-0  2b2b2b2b-3c3c-4d4d-5e5e-6f6f6f6f6f6f  running       cx2-2x4   10.242.0.42  eu-de-1  v1.0.15
fleet-1a1a1a1a-2b2b-3c3c-4d4d-5e5e5e5e5e5e-1  3c3c3c3c-4d4d-5e5e-6f6f-7g7g7g7g7g7g  initializing  cx2-8x16  10.242.0.43  eu-de-1  v1.0.15

範例

ibmcloud ce fleet worker profiles --profile-family --region br-sao

輸出範例

Listing fleet worker profiles...
OK
Name                 CPU  Memory  Disk  GPU family  Region  
gx2-8x64x1v100       8    64Gi    0     v100        br-sao  
gx2-32x256x2v100     32   256Gi   0     v100        br-sao  
gx3-48x240x2l40s     48   240Gi   0     l40s        br-sao  
gx3-64x320x4l4       64   320Gi   0     l4          br-sao  
gx3d-160x1792x8h100  160  1792Gi  60Ti  h100        br-sao  

指令選項

--name, -n

要連結的函數名稱。 此欄位為必填項目。

--no-wait, --nw

綁定服務實例，且不等待服務綁定就緒。 如果指定 no-wait 選項，則會啟動服務綁定的建立，並且不等待服務綁定完成就退出命令。 使用 function get 指令檢查功能綁定狀態。 此值為可選項。 預設值為 false。

--prefix, -p

針對此服務連結建立之環境變數的字首。 必須只包含大寫字母、數字和底線 (_)，並且不能以數字開頭。 此值為可選項。

--quiet, -q

指定此選項可減少指令的輸出。 此值為可選項。 預設值為 false。

--role, -r

為此服務綁定所建立之新服務憑證的服務角色名稱。 有效值包括 Reader、Writer、Manager，或特定服務的角色。 此選項預設為「Manager」；若不支援「Manager」，則預設為該服務所提供的第一個角色。 如果指定 --service-credential，則忽略此選項。 此值為可選項。

--service-credential, --sc

用於此服務綁定之現有服務憑證的名稱。 如果未指定服務實例憑證，則會在綁定動作期間產生新憑證。 此值為可選項。

--service-instance, --si

要與函式綁定的現有 IBM Cloud 服務實體的名稱。 此值為可選項。

--service-instance-id, --siid

要與函式綁定的現有 IBM Cloud 服務實體的 GUID。 此值為可選項。

--wait, -w

綁定服務實例，並等待服務綁定就緒。 如果指定 --wait 選項，函式綁定會等待 --wait-timeout 選項設定的最長時間（以秒為單位），直到函式綁定成功完成。 如果在指定的 --wait-timeout 期間內，功能綁定未成功完成或失敗，則命令失敗。 此值為可選項。 預設值為 true。

--wait-timeout, --wto

等待服務綁定就緒所需的時間（以秒為單位）。 如果指定了 --wait 選項，則必須使用此值。 如果指定了 --no-wait 選項，此值會被忽略。 預設值為 300。

範例

ibmcloud ce fn bind --name myfunction --service-instance my-object-storage

輸出範例

Binding service instance...
Status: Done
OK

指令選項

-n, --name

功能的名稱。 請使用專案內唯一的名稱。

• 名稱必須以小寫字母開頭。
• 名稱必須以小寫英數字元結尾。
• 名稱必須為 63 個字元或以下，並可包含小寫字母、數字和連字符號 (-)。

此欄位為必填項目。

--runtime, -r

函式要使用的執行時間。 若要尋找此區域的支援執行時間，請執行 ibmcloud ce function runtimes。 請參閱 Runtimes。 此欄位為必填項目。

--build-commit, --commit, --bcm, --cm, --revision

來源儲存庫中要取回的確定、標籤或分支。 此值為可選項。

--build-context-dir, --context-dir, --bcdr, --cdr

儲存庫中包含函數原始碼的目錄。 此值為可選項。

--build-git-repo-secret, --git-repo-secret, --bgrs, --grs, --repo

SSH 密鑰的名稱，其中包含用來存取專用儲存庫的認證，而該專用儲存庫包含用來建置程式碼組合映像檔的原始碼。 若要建立此 SSH 秘密，請使用 secret create --format SSH 指令。 SSH 秘密也可用作 Git 儲存庫存取秘 密。 只有在 --build-source 選項設定為 Git 儲存庫的 URL 時，才允許使用此選項。 此值為可選項。

--build-source, --source, --bsrc, --src

Git 儲存庫的 URL 或包含您原始碼的本機原始碼路徑；例如 https://github.com/IBM/CodeEngine 或 .。 此值為可選項。

--build-timeout, --bto

在建立成功或失敗之前所能經過的時間，以秒為單位。 此值為可選項。 預設值為 600。

--code-bundle, --cb

此功能要使用的 code-bundle 影像名稱。 當指定 build-source 時，此值即為建置推送所產生之輸出影像的路徑。 若未指定 build-source ，此值即為現有程式碼封裝映像檔的路徑。 格式為 REGISTRY/NAMESPACE/REPOSITORY:TAG，其中 TAG 為可選項目。 若未指定 TAG，預設值為 latest。 此值為可選項。

--code-bundle-secret, --cs, --cbs

用來向專用登錄進行鑑別的登錄密鑰名稱。 您可以透過執行 registry create 指令來新增註冊密碼。 此值為可選項。

--cpu

為函數實例設定的 CPU 數量。 有關有效值，請參閱 支援的記憶體和 CPU 組合。 此值為可選項。 預設值為 1。

--env, -e

在函數中設定環境變數。 必須採用 NAME=VALUE 格式。 此動作可新增環境變數或覆寫現有的環境變數。 每個 --env 選項指定一個環境變數；例如，--env envA=A --env envB=B。 此值為可選項。

--env-cm, --env-from-configmap

使用下列其中一種方式，從儲存於此 configmap 的 key-value 對中設定環境變數。

• 若要為名為 configmapName 的 configmap 中的所有按鍵新增環境變數，請使用值 configmapName。 您可以在引用 configmap 時指定前綴來修改環境變數名稱。 若要指定前綴，請使用 PREFIX=CONFIGMAP_NAME。 每個結果環境變數的格式為 <PREFIX><NAME_OF_KEY_IN_CONFIGMAP>. 例如，要將配置表 configmapName 中所有變量名稱的鍵的前綴設為 CUSTOM_，請使用值 CUSTOM_=configmapName。 如果配置映射 configmapName 包含 KEY_A，環境變數名稱就是 CUSTOM_KEY_A。
• 若要為個別金鑰新增環境變數，請使用格式 NAME:KEY_A,KEY_B. 例如，若要在名為 configmapName 的 configmap 中為單一關鍵 key1 新增環境變數，請使用 configmapName:key1。 若要為引用的按鍵指定不同的名稱，請使用格式 NAME:NEW_NAME=KEY_A。 例如，若要為名為 configmapName 的 configmap 中的單一鍵 key1 新增名為 myKey 的環境變數，請使用值 configmapName:myKey=key1。

此值為可選項。

--env-sec, --env-from-secret

使用下列其中一種方式，從儲存於秘密中的鍵值對設定環境變數。

• 若要為命名為 secretName 的秘密中的所有金鑰新增環境變數，請使用 secretName。 您可以在引用秘密時指定前綴來修改環境變數名稱。 若要指定前綴，請使用 PREFIX=SECRET_NAME。 每個結果環境變數的格式為 <PREFIX><NAME_OF_KEY_IN_SECRET>. 例如，若要將密碼 secretName 中所有變數名稱的前綴設定為 CUSTOM_，請使用值 CUSTOM_=secretName。 如果密文 secretName 包含 KEY_A，環境變數名稱就是 CUSTOM_KEY_A。
• 若要為個別金鑰新增環境變數，請使用格式 NAME:KEY_A,KEY_B. 例如，若要在名稱為 secretName 的秘密中為單一金鑰 key1 新增環境變數，請使用 secretName:key1。 若要為引用的按鍵指定不同的名稱，請使用格式 NAME:NEW_NAME=KEY_A。 例如，要在一個名為 secretName 的秘密中為單一金鑰 key1 新增一個名為 myKey 的環境變數，請使用 secretName:myKey=key1 的值。

此值為可選項。

--force, -f

不驗證指定的 configmap 和 secret 參照是否存在。 此值為可選項。 預設值為 false。

--inline-code

請指定包含該函式原始碼之檔案的路徑。 程式碼是與函式內嵌在一起的。 此值為可選項。

--main, --fn-main

在提供的原始碼中指定 main 函數的名稱。 當名稱不是 main 時，需要使用此選項。 此值為可選項。 預設值為 main。

--maxexecutiontime, --met

此函數完成其執行的最長時間（以秒為單位）。 此值為可選項。 預設值為 60。

--memory, -m

為該函式設定的記憶體容量。 若要表示兆位元組，請使用 M ；若要表示吉位元組，請使用 G。 有關有效值，請參閱 支援的記憶體和 CPU 組合。 此值為可選項。 預設值為 4G。

--no-wait, --nw

請不必等待建置執行完成。 此值為可選項。 預設值為 false。

--output, -o

指定指令輸出的格式。 有效值為 json, yaml, jsonpath=JSONPATH_EXPRESSION，和 jsonpath-as-json=JSONPATH_EXPRESSION。 使用 jsonpath 指定 JSON 輸出元素的路徑。 此值為可選項。

--quiet, -q

指定此選項可減少指令的輸出。 此值為可選項。 預設值為 false。

--scale-down-delay, --sdd

在呼叫完成之後，實例處於作用中狀態的時間量（以秒為單位）。 此選項可以減少冷啟動時間。 如需詳細資訊，請參閱 Can I keep my function instance alive longer?。 此值為可選項。 預設值為 1。

--trusted-profiles-enabled, --trusted, --tpe

啟用函數執行時裝載計算資源記號。 此值為可選項。 預設值為 false。

--visibility, -v

函數的可見性。 有效值為 public、private 以及 project。 只有當專案支援函式私有可見性時，可見性才可能為 private。 此值為可選項。 預設值為 public。

--wait, -w

等待建置執行完成。 此值為可選項。 預設值為 true。

--wait-timeout, --wto

等待該函式就緒所需的時間（以秒為單位）。 如果指定了 --wait 選項，則必須使用此值。 如果指定了 --no-wait 選項，此值會被忽略。 預設值為 600。

範例

ibmcloud ce fn create --name myfunction --build-source main.js --runtime nodejs

輸出範例

Preparing function 'myfunction' for build push...
Creating function 'myfunction'...
Packaging files to upload from source path 'main.js'...
Submitting build run 'myfunction-run-111111-12345678'...
Creating image 'private.stg.icr.io/ce--1a1a1-11c22def3rhz/function-myfunction:12345678-1111-dexla'...
Waiting for build run to complete...
Build run status: 'Running'
Build run completed successfully.
Run 'ibmcloud ce buildrun get -n myfunction-run-111111-12345678' to check the build run status.
Waiting for function 'myfunction' to become ready...
Function 'myfunction' is ready.
OK                                                
Run 'ibmcloud ce function get -n myfunction' to see more details.
https://myfunction.11c22def3rhz.us-south.codeengine.appdomain.cloud

當您執行 ibmcloud ce fn get -n 'myfunction' 來檢查函式狀態時，系統會顯示該函式的 URL。

指令選項

--name, -n

功能的名稱。 此欄位為必填項目。

--force, -f

強制刪除，而不進行確認。 此值為可選項。 預設值為 false。

--ignore-not-found, --inf

如果未找到，請勿失敗。 此值為可選項。 預設值為 false。

--quiet, -q

指定此選項可減少指令的輸出。 此值為可選項。 預設值為 false。

範例

ibmcloud ce fn delete --name myfunction

輸出範例

Are you sure you want to delete function 'myfunction'? [y/N]> y
Deleting function 'myfunction'...
OK

指令選項

--name, -n

功能的名稱。 此欄位為必填項目。

--output, -o

指定指令輸出的格式。 有效值為 json, yaml, jsonpath=JSONPATH_EXPRESSION，和 jsonpath-as-json=JSONPATH_EXPRESSION。 使用 jsonpath 指定 JSON 輸出元素的路徑。 此值為可選項。

--quiet, -q

指定此選項可減少指令的輸出。 此值為可選項。 預設值為 false。

--save, -s

將該函式的原始程式碼儲存至本機檔案系統中。 只有使用內嵌程式碼建立的函數才支援此選項。 此值為可選項。

範例

ibmcloud ce fn get --name myfunction

輸出範例

Getting function 'myfunction'...
OK
Name:          myfunction  
Project Name:  myproject
Project ID:    01234567-abcd-abcd-abcd-abcdabcd1111
Age:           6m8s  
Created:       2023-06-22T19:59:51Z
URL:           https://myfunction.11c22def3rhz.us-south.codeengine.appdomain.cloud  
Status:        Ready  
Resources:    
  CPU:                 0.25  
  Memory:              500M  
  Max Execution Time:  60 seconds  
Build Information:    
  Build Run Name:     myfunction-run-111111-12345678
  Build Type:         local  
  Build Strategy:     codebundle-nodejs-22
  Timeout:            600  
  Source:             main.js  
                      
  Build Run Summary:  Succeeded  
  Build Run Status:   Succeeded  
  Build Run Reason:   All Steps have completed executing  
  Run 'ibmcloud ce buildrun get -n myfunction-run-111111-12345678' for details.  
Function Code:    
  Runtime:        nodejs-22 (managed)
  Bundle Secret:  ce-auto-icr-private-us-south  
  Code Bundle:    cr://icr.io/ce--1a1a1-11c22def3rhz/function-myfunction:12345678-1111-dexla
  Main:           main()

指令選項

--output, -o

指定指令輸出的格式。 有效值為 json, yaml, jsonpath=JSONPATH_EXPRESSION，和 jsonpath-as-json=JSONPATH_EXPRESSION。 使用 jsonpath 指定 JSON 輸出元素的路徑。 此值為可選項。

--quiet, -q

指定此選項可減少指令的輸出。 此值為可選項。 預設值為 false。

--sort-by, -s

指定清單排序的直欄。 有效值為 name 和 age。 此值為可選項。 預設值為 name。

範例

ibmcloud ce fn delete --name myfunction

輸出範例

Name           Status     URL                                                                    CPU   Memory  Age  
hellofunction  Ready      https://hellofunction.4svg40kna19.us-south.codeengine.appdomain.cloud  0.25  500M    25h  
myfunction     Ready      https://myfun1.4svg40kna19.us-south.codeengine.appdomain.cloud         0.25  1G      8d   
helloworld     Ready      https://myfunction1.4svg40kna19.us-south.codeengine.appdomain.cloud    0.25  1G      16d  
myfunction1    Ready      https://myfunction111.4svg40kna19.us-south.codeengine.appdomain.cloud  0.25  500M    25h  
myfunction3    Ready      https://myfunction41.4svg40kna19.us-south.codeengine.appdomain.cloud   0.25  500M    25h  

指令選項

--all, -A

顯示所有執行時期，包括已淘汰的執行時期。 此值為可選項。 預設值為 false。

--output, -o

指定指令輸出的格式。 有效值為 json, yaml, jsonpath=JSONPATH_EXPRESSION，和 jsonpath-as-json=JSONPATH_EXPRESSION。 使用 jsonpath 指定 JSON 輸出元素的路徑。 此值為可選項。

--quiet, -q

指定此選項可減少指令的輸出。 此值為可選項。 預設值為 false。

範例

ibmcloud ce fn runtimes

輸出範例

Name         ID           Family  Default
Python 3.11  python-3.11  python  true
Node.js 22   nodejs-22    nodejs  true
Node.js 24   nodejs-24    nodejs  false
Python 3.13  python-3.13  python  false

指令選項

--name, -n

要取消連結的函數名稱。 此欄位為必填項目。

--all, -A

取消連結此函數的所有服務實例。 如果未指定 --binding，則必須使用此值。 預設值為 false。

--binding, -b

要解除綁定的綁定名稱。 執行 ibmcloud ce function get -n FUNCTION_NAME 以檢視綁定名稱。 如果未指定 --all，則必須使用此值。

--quiet, -q

指定此選項可減少指令的輸出。 此值為可選項。 預設值為 false。

範例

ibmcloud ce fn unbind --name myfunction --all

輸出範例

Removing bindings from 'myfunction'...
OK

指令選項

--name, -n

必要。 功能的名稱。 此欄位為必填項目。

--build-clear, --bc

從此函數中移除建置的關聯。 只有當您的函式目前有關聯的建立時，才允許使用建立清除選項。 此值為可選項。 預設值為 false。

--build-commit, --commit, --bcm, --cm, --revision

來源儲存庫中要取回的確定、標籤或分支。 此值為可選項。

--build-commit-clear, --commit-clear, --bcmc, --cmc

清除來源儲存庫中要取回的確定、標籤或分支。 只有當您的函式目前有關聯的建立時，才允許使用 commit clear 選項。 此值為可選項。 預設值為 false。

--build-context-dir, --context-dir, --bcdr, --cdr

儲存庫中包含函數原始碼的目錄。 只有設定 --build-source 選項時，才允許使用此選項。 此值為可選項。

--build-git-repo-secret, --git-repo-secret, --bgrs, --grs, --repo

包含用於存取私有儲存庫之憑證的 SSH 密鑰名稱，該儲存庫內含用於建置您的映像檔的原始碼。 此值為可選項。

--build-git-repo-secret-clear, --git-repo-secret-clear, --bgrsc, --grsc

清除 SSH 密鑰。 只有當您的函式目前有關聯的建立時，才允許使用此選項。 此值為可選項。 預設值為 false。

--build-source, --source, --bsrc, --src

Git 儲存庫的 URL 或包含您原始碼的本機原始碼路徑；例如 https://github.com/IBM/CodeEngine 或 .。 此值為可選項。

--build-timeout, --bto

在建立成功或失敗之前所能經過的時間，以秒為單位。 此值為可選項。 預設值為 600。

--code-bundle, --cb

此功能要使用的 code-bundle 影像名稱。 當指定 build-source 時，此值即為建置推送所產生之輸出影像的路徑。 若未指定 build-source ，此值即為現有程式碼封裝映像檔的路徑。 格式為 REGISTRY/NAMESPACE/REPOSITORY:TAG，其中 TAG 為可選項目。 若未指定 TAG，預設值為 latest。 此值為可選項。

--code-bundle-secret, --cs, --cbs

用來向專用登錄進行鑑別的登錄密鑰名稱。 您可以透過執行 registry create 指令來新增註冊密碼。 此值為可選項。

--cpu

為函數實例設定的 CPU 數量。 有關有效值，請參閱 支援的記憶體和 CPU 組合。 此值為可選項。 預設值為 1。

--env, -e

在函數中設定環境變數。 必須採用 NAME=VALUE 格式。 此動作可新增環境變數或覆寫現有的環境變數。 每個 --env 選項指定一個環境變數；例如，--env envA=A --env envB=B。 此值為可選項。

--env-cm, --env-from-configmap

使用下列其中一種方式，從儲存於此 configmap 的 key-value 對中設定環境變數：

• 若要為名為 configmapName 的 configmap 中的所有按鍵新增環境變數，請使用值 configmapName。 您可以在引用 configmap 時指定前綴來修改環境變數名稱。 若要指定前綴，請使用 PREFIX=CONFIGMAP_NAME。 每個結果環境變數的格式為 <PREFIX><NAME_OF_KEY_IN_CONFIGMAP>. 例如，要將配置表 configmapName 中所有變量名稱的鍵的前綴設為 CUSTOM_，請使用值 CUSTOM_=configmapName。 如果配置映射 configmapName 包含 KEY_A，環境變數名稱就是 CUSTOM_KEY_A。
• 若要為個別金鑰新增環境變數，請使用格式 NAME:KEY_A,KEY_B. 例如，若要在名為 configmapName 的 configmap 中為單一關鍵 key1 新增環境變數，請使用 configmapName:key1。 若要為引用的按鍵指定不同的名稱，請使用格式 NAME:NEW_NAME=KEY_A。 例如，若要為名為 configmapName 的 configmap 中的單一鍵 key1 新增名為 myKey 的環境變數，請使用值 configmapName:myKey=key1。

此值為可選項。

--env-from-configmap-rm, --env-cm-rm

使用 configmap 名稱，移除對完整 configmap 的環境變數參照。 若要移除對 configmaps 的個別關鍵參照，請使用 --env-rm 選項。 此選項可以指定多次。 此值為可選項。

--env-sec, --env-from-secret

使用下列其中一種方式，從儲存於秘密中的鍵值對設定環境變數：

• 若要為命名為 secretName 的秘密中的所有金鑰新增環境變數，請使用 secretName。 您可以在引用秘密時指定前綴來修改環境變數名稱。 若要指定前綴，請使用 PREFIX=SECRET_NAME。 每個結果環境變數的格式為 <PREFIX><NAME_OF_KEY_IN_SECRET>. 例如，若要將密碼 secretName 中所有變數名稱的前綴設定為 CUSTOM_，請使用值 CUSTOM_=secretName。 如果密文 secretName 包含 KEY_A，環境變數名稱就是 CUSTOM_KEY_A。
• 若要為個別金鑰新增環境變數，請使用格式 NAME:KEY_A,KEY_B. 例如，若要在名稱為 secretName 的秘密中為單一金鑰 key1 新增環境變數，請使用 secretName:key1。 若要為引用的按鍵指定不同的名稱，請使用格式 NAME:NEW_NAME=KEY_A。 例如，要在一個名為 secretName 的秘密中為單一金鑰 key1 新增一個名為 myKey 的環境變數，請使用 secretName:myKey=key1 的值。

此值為可選項。

--env-from-secret-rm, --env-sec-rm

使用秘密名稱，移除對完整秘密的環境變數參照。 若要移除秘密的個別金鑰參照，請使用 --env-rm 選項。 此選項可以指定多次。 此值為可選項。

--env-rm

移除對 configmap 或 secret 中鍵值對的 key 的環境變數參照。 若要移除個別的關鍵參照和字面值，請指定關鍵的名稱。 此選項可以指定多次。 此值為可選項。

--force, -f

不驗證指定的 configmap 和 secret 參照是否存在。 Configmap 引用是使用 --env-from-configmap 或 --mount-configmap 選項指定的。 秘密參照使用 --env-from-secret、--mount-secret 或 --registry-secret 選項指定。 此值為可選項。 預設值為 false。

--inline-code

指定包含函數之原始碼的檔案路徑。 程式碼是與函式內嵌在一起的。 此值為可選項。

--main, --fn-main

在提供的原始碼中指定 main 函數的名稱。 當名稱不是 main 時，需要使用此選項。 此值為可選項。 預設值為 main。

--maxexecutiontime, --met

此函式完成執行所需的最大執行時間（以秒為單位）。 此值為可選項。 預設值為 60。

--memory, -m

為該函式設定的記憶體容量。 若要表示兆位元組，請使用 M ；若要表示吉位元組，請使用 G。 有關有效值，請參閱 支援的記憶體和 CPU 組合。 此值為可選項。 預設值為 4G。

--no-wait, --nw

提交建立執行，不要等待此建立執行完成。 如果指定 --no-wait 選項，則會開始提交建立執行，而不會等待。 使用 buildrun get 指令檢查建立執行狀態。 此值為可選項。 預設值為 false。

--output, -o

指定指令輸出的格式。 有效值為 json, yaml, jsonpath=JSONPATH_EXPRESSION，和 jsonpath-as-json=JSONPATH_EXPRESSION。 使用 jsonpath 指定 JSON 輸出元素的路徑。 此值為可選項。

--quiet, -q

指定此選項可減少指令的輸出。 此值為可選項。 預設值為 false。

--rebuild

從原始檔重新建立映像檔。 只有當您的函式目前有關聯的建立時，才允許使用重建選項。 此值為可選項。 預設值為 false。

--runtime, -r

函式要使用的執行時間。 若要尋找此區域的支援執行時間，請執行 ibmcloud ce function runtimes。 請參閱 Runtimes。 此值為可選項。

--scale-down-delay, --sdd

在呼叫完成之後，實例處於作用中狀態的時間量（以秒為單位）。 此選項可以減少冷啟動時間。 如需詳細資訊，請參閱 Can I keep my function instance alive longer?。 此值為可選項。 預設值為 1。

--trusted-profiles-enabled, --trusted, --tpe

啟用函數執行時裝載計算資源記號。 此值為可選項。 預設值為 false。

--visibility, -v

函數的可見性。 有效值為 public、private 以及 project。 只有當專案支援函式私有可見性時，可見性才可能為 private。 此值為可選項。

--wait, -w

等待建置執行完成。 此值為可選項。 預設值為 true。

--wait-timeout, --wto

等待該函式就緒所需的時間（以秒為單位）。 如果指定了 --wait 選項，則必須使用此值。 如果指定了 --no-wait 選項，此值會被忽略。 預設值為 600。

範例

ibmcloud ce fn update --name myfunction --runtime nodejs-22 --build-source main.js

輸出範例

Preparing function 'myfunction' for build push...
Updating function 'myfunction'...
Packaging files to upload from source path 'main.js'...
Submitting build run 'myfunction-run-111111-12345678'...
Creating image 'icr.io/ce--1a1a1-11c22def3rhz/function-myfunction:12345678-1111-dexla'...
Waiting for build run to complete...
Build run status: 'Running'
Build run completed successfully.
Run 'ibmcloud ce buildrun get -n myfunction-run-111111-12345678' to check the build run status.
Waiting for function 'myfunction' to become ready...
Function 'myfunction' is ready.
OK                                                
Run 'ibmcloud ce function get -n myfunction' to see more details.
https://myfunction.11c22def3rhz.us-south.codeengine.appdomain.cloud

當您執行 ibmcloud ce fn get -n 'myfunction' 來檢查函式狀態時，系統會顯示該函式的 URL。

範例

ibmcloud ce help

輸出範例

NAME:
  code-engine, ce - Manage Code Engine components
USAGE:
  ibmcloud ce command [arguments...] [options...]
COMMANDS:
  application, app     Manage applications.
  binding              Manage bindings.
  build, bd, b         Manage configurations for generating images from source code.
  buildrun, br         Generate images from a build.
  configmap, cm        Manage configmaps.
  domainmapping, dm    Manage domain mappings.
  experimental, exp    Experimental Code Engine commands
  function, fn         Manage functions.
  help, h              Show help.
  job                  Manage jobs to configure tasks.
  jobrun, jr           Manage instances of a job.
  connectivity, conn   Manage connectivity commands
  project, proj        Manage Code Engine projects.
  reclamation, recl    Manage Code Engine project reclamations.
  registry             Manage image registry access secrets.
  repo                 Manage Git repository access secrets.
  revision, rev        Manage application revisions.
  secret               Manage secrets.
  serviceaccess        Manage service access secrets.
  subscription, sub    Manage event subscriptions.
  version, v           Display the 'code-engine' command-line interface version.
Enter 'ibmcloud ce help command' for more information about a command.

指令選項

--name, -n

要綁定的工作名稱。 此欄位為必填項目。

--no-wait, --nw

綁定服務實例，且不等待服務綁定就緒。 如果指定 --no-wait 選項，則會啟動服務綁定的建立，並且不等待服務綁定完成就退出命令。 使用 job get 指令檢查工作綁定狀態。 此值為可選項。 預設值為 false。

--prefix, -p

針對此服務連結建立之環境變數的字首。 必須只包含大寫字母、數字和底線 (_)，並且不能以數字開頭。 此值為可選項。

--quiet, -q

指定此選項可減少指令的輸出。 此值為可選項。 預設值為 false。

--role, -r

為此服務綁定所建立之新服務憑證的服務角色名稱。 有效值包括 Reader、Writer、Manager，或特定服務的角色。 此選項預設為「Manager」；若不支援「Manager」，則預設為該服務所提供的第一個角色。 如果指定 --service-credential，則忽略此選項。 此值為可選項。

--service-credential, --sc

用於此服務綁定之現有服務憑證的名稱。 如果未指定服務實例憑證，則會在綁定動作期間產生新憑證。 此值為可選項。

--service-instance, --si

要與工作綁定的現有 IBM Cloud 服務實例的名稱。 此值為可選項。

--service-instance-id, --siid

要與工作綁定的現有 IBM Cloud 服務實例的 GUID。 此值為可選項。

--wait, -w

綁定服務實例，並等待服務綁定就緒。 如果指定 --wait 選項，工作綁定會等待 --wait-timeout 選項設定的最長時間（以秒為單位），以便工作綁定成功完成。 如果在指定的 --wait-timeout 期間內，工作綁定未成功完成或失敗，則命令失敗。 此值為可選項。 預設值為 true。

--wait-timeout, --wto

等待服務綁定就緒所需的時間（以秒為單位）。 如果指定了 --wait 選項，則必須使用此值。 如果指定了 --no-wait 選項，此值會被忽略。 預設值為 300。

範例

在此範例中，將名為 my-object-storage 的服務實例綁定到名為 hello 的工作。

ibmcloud ce job bind --name hello --service-instance my-object-storage

輸出範例

Binding service instance...
Waiting for service binding to become ready...
Status: Pending (Processing Resource)
Status: Pending (Processing Resource)
Status: Creating service binding
Status: Creating service binding
Status: Ready
OK

指令選項

-n, --name

工作名稱。 請使用專案內唯一的名稱。

• 名稱必須以小寫的英數字元開頭，並以小寫的英數字元結尾。
• 名稱必須為 63 個字元或以下，並可包含小寫字母、數字和連字符號 (-)。

此欄位為必填項目。

--argument, --arg, -a

設定執行工作的參數。 每個 --argument 選項指定一個參數；例如，-a argA -a argB。 此值為可選項。

--array-indexes, --array-indices, --ai

指定用於執行該工作時所使用的陣列索引，例如 0,3,6,9、1-5,7-8,10。 索引的結果集限制為 1000 個項目。 只有在未指定 array-size 的情況下，才可指定此選項。 此值為可選項。 預設值為 0。

--array-size, --as, --instances, --is

指定用於執行工作的實例數。 當您使用此選項時，系統會將其轉換為陣列索引。 舉例來說，若您指定 instances （網址為 5 ），系統會將其轉換為 array-indexes （網址為 0 - 4 ）。 只有在未指定 --array-indexes 選項的情況下，才可指定此選項。 此值為可選項。 預設值為 1。

--build-commit, --commit, --bcm, --cm, --revision

來源儲存庫中要取回的確定、標籤或分支。 只有在 --build-source 選項設定為 Git 倉庫的 URL 時，才允許使用 build commit 選項。 此值為可選項。

--build-context-dir, --context-dir, --bcdr, --cdr

套件庫中包含 buildpacks 檔案或 Dockerfile 的目錄。 只有設定 --build-source 選項時，才允許使用建立上下文目錄選項。 此值為可選項。

--build-dockerfile, --dockerfile, --bdf, --df

Dockerfile 的路徑。 僅在名稱不是 Dockerfile 時指定此選項。 只有當 --build-source 選項被設定時，才允許使用 build dockerfile 選項。 此值為可選項。 預設值為 Dockerfile。

--build-git-repo-secret, --git-repo-secret, --bgrs, --grs, --repo

SSH 密鑰的名稱，其中包含用來存取專用儲存庫的認證，該專用儲存庫包含用來建置容器映像檔的原始碼。 若要建立此 SSH 秘密，請使用 secret create --format SSH 指令。 SSH 秘密也可用作 Git 儲存庫存取秘 密。 只有在 --build-source 選項設定為 Git 儲存庫的 URL 時，才允許使用此選項。 此值為可選項。

--build-size, --size, --bsz, --sz

建置的規模，這將決定所使用的資源量。 有效值包括：small、medium、large、xlarge 以及 xxlarge。 如需詳細資訊，請參閱 確定建立的大小。 只有設定 --build-source 選項時，才允許使用建立大小選項。 此值為可選項。 預設值為 medium。

--build-source, --source, --bsrc, --src

Git 儲存庫的 URL 或包含您原始碼的本機原始碼路徑；例如 https://github.com/IBM/CodeEngine 或 .。 此值為可選項。

--build-strategy, --strategy, --bstr, --str

用於建置映像檔的策略。 有效值為 dockerfile 和 buildpacks。 只有設定 --build-source 選項時，才允許使用建立策略選項。 如果未指定，則在指定 --build-source 且原始碼位於本機的情況下，由 Code Engine 決定建立策略。 此值為可選項。 預設值為 dockerfile。

--build-timeout, --bto

在建立成功或失敗之前所能經過的時間，以秒為單位。 只有設定 --build-source 選項時，才允許使用建立逾時選項。 此值為可選項。 預設值為 600。

--command, --cmd, -c

設定執行工作的指令。 每個 --command 選項指定一個指令；例如，--cmd cmdA --cmd cmdB。 此值會覆寫在容器影像中指定的預設命令。 此值為可選項。

--cpu

為執行工作設定的 CPU 數量。 有關有效值，請參閱 支援的記憶體和 CPU 組合。 此值為可選項。 預設值為 1。

--env, -e

設定執行工作的環境變數。 必須採用 NAME=VALUE 格式。 此動作可新增環境變數或覆寫現有的環境變數。 每個 --env 選項指定一個環境變數；例如，--env envA=A --env envB=B。 此值為可選項。

--env-cm, --env-from-configmap

使用下列其中一種方式，從儲存於此 configmap 的 key-value 對中設定環境變數：

• 若要為名為 configmapName 的 configmap 中的所有按鍵新增環境變數，請使用值 configmapName。 您可以在引用 configmap 時指定前綴來修改環境變數名稱。 若要指定前綴，請使用 PREFIX=CONFIGMAP_NAME。 每個結果環境變數的格式為 <PREFIX><NAME_OF_KEY_IN_CONFIGMAP>. 例如，要將配置表 configmapName 中所有變量名稱的鍵的前綴設為 CUSTOM_，請使用值 CUSTOM_=configmapName。 如果配置映射 configmapName 包含 KEY_A，環境變數名稱就是 CUSTOM_KEY_A。
• 若要為個別金鑰新增環境變數，請使用格式 NAME:KEY_A,KEY_B. 例如，若要在名為 configmapName 的 configmap 中為單一關鍵 key1 新增環境變數，請使用 configmapName:key1。 若要為引用的按鍵指定不同的名稱，請使用格式 NAME:NEW_NAME=KEY_A。 例如，若要為名為 configmapName 的 configmap 中的單一鍵 key1 新增名為 myKey 的環境變數，請使用值 configmapName:myKey=key1。

此值為可選項。

--env-sec, --env-from-secret

使用下列其中一種方式，從儲存於秘密中的鍵值對設定環境變數：

• 若要為命名為 secretName 的秘密中的所有金鑰新增環境變數，請使用 secretName。 您可以在引用秘密時指定前綴來修改環境變數名稱。 若要指定前綴，請使用 PREFIX=SECRET_NAME。 每個結果環境變數的格式為 <PREFIX><NAME_OF_KEY_IN_SECRET>. 例如，若要將密碼 secretName 中所有變數名稱的前綴設定為 CUSTOM_，請使用值 CUSTOM_=secretName。 如果密文 secretName 包含 KEY_A，環境變數名稱就是 CUSTOM_KEY_A。
• 若要為個別金鑰新增環境變數，請使用格式 NAME:KEY_A,KEY_B. 例如，若要在名稱為 secretName 的秘密中為單一金鑰 key1 新增環境變數，請使用 secretName:key1。 若要為引用的按鍵指定不同的名稱，請使用格式 NAME:NEW_NAME=KEY_A。 例如，要在一個名為 secretName 的秘密中為單一金鑰 key1 新增一個名為 myKey 的環境變數，請使用 secretName:myKey=key1 的值。

此值為可選項。

--ephemeral-storage, --es

應為該工作執行程序設定的暫存儲存空間大小。 若要表示兆位元組，請使用 M ；若要表示吉位元組，請使用 G。 此值為可選項。 預設值為 400M。

--force, -f

不驗證指定的 configmap 和 secret 參照是否存在。 Configmap 引用是使用 --env-from-configmap 選項指定的。 秘密參照使用 --env-from-secret 或 --registry-secret 選項指定。 此值為可選項。 預設值為 false。

--image, -i

用於執行工作的影像名稱。 格式為 REGISTRY/NAMESPACE/REPOSITORY:TAG，其中 REGISTRY 和 TAG 皆為可選項目。 若未指定 REGISTRY，預設值為 docker.io。 若未指定 TAG，預設值為 latest。 若未指定 --build-source 選項，則必須指定 image 選項。 此值為可選項。

--maxexecutiontime, --met

工作執行的執行時間上限（以秒為單位）。 只有當 mode 的值為 task`` 時，才可指定此選項。 此值為可選項。 預設值為 7200。

--memory, -m

為執行工作設定的記憶體數量。 若要表示兆位元組，請使用 M ；若要表示吉位元組，請使用 G。 有關有效值，請參閱 支援的記憶體和 CPU 組合。 此值為可選項。 預設值為 4G。

--mode

工作執行的模式。 有效值為 task 和 daemon。 在 task 模式下，maxexecutiontime 和 retrylimit 選項將生效。 在 daemon 模式下，由於沒有超時設定，且失敗的執行個體會無限期地重新啟動，因此不允許使用 --maxexecutiontime 和 --retrylimit 選項。 此值為可選項。 預設值為 task。

--mount-configmap, --mount-cm

透過提供掛載目錄和 configmap 的名稱，將 configmap 的內容新增至執行工作的檔案系統，格式為 MOUNT_DIRECTORY=CONFIGMAP_NAME. 每個掛載的 configmap 必須使用唯一的掛載目錄。 對於 configmap 中的每個 key-value 對，都會新增一個檔案到指定的 mount 目錄，其中檔案名稱是 key，檔案內容是 key-value 對的值。 每個 --mount-configmap 選項指定一個掛載設定；例如，--mount-configmap /etc/config-a=config-a --mount-configmap /etc/config-b=config-b。 此值為可選項。

--mount-data-store, --mount-ds

裝載持續資料儲存庫。 格式為 MOUNT_DIRECTORY=STORAGE_NAME [:SUBPATH]。 SUBPATH 為選用。 此選項可以指定多次。 此值為可選項。

--mount-secret, --mount-sec

透過提供掛載目錄和秘密名稱，將秘密內容加入執行工作的檔案系統，格式為 MOUNT_DIRECTORY=SECRET_NAME. 每個掛載的秘密必須使用唯一的掛載目錄。 對於秘密中的每個鍵值對，都會在指定的掛載目錄中加入一個檔案，其中檔案名稱是鍵，檔案內容是鍵值對的值。 每個 --mount-secret 選項指定一個掛載設定；例如，--mount-secret /etc/secret-a=secret--a --mount-secret /etc/secret-b=secret-b。 此值為可選項。

--no-wait, --nw

請不必等待建置執行完成。 如果指定 --no-wait 選項，則會開始執行建立，而不會等待。 使用 buildrun get 指令檢查建立執行狀態。 只有設定 --build-source 選項時，才允許使用 no-wait 選項。 此值為可選項。 預設值為 false。

--output, -o

指定指令輸出的格式。 有效值為 json, yaml, jsonpath=JSONPATH_EXPRESSION，和 jsonpath-as-json=JSONPATH_EXPRESSION。 使用 jsonpath 指定 JSON 輸出元素的路徑。 此值為可選項。

--quiet, -q

指定此選項可減少指令的輸出。 此值為可選項。 預設值為 false。

--registry-secret, --rs

登錄密鑰的名稱。 當您下載容器映像檔時，會使用登錄密鑰向專用登錄進行鑑別。 此值為可選項。

--retrylimit, -r

在工作標示為失敗之前，重新執行工作實例的次數。 當作業的陣列索引出現非零的退出代碼時，該作業就會重新執行。 只有當 mode 的值為 task`` 時，才可指定此選項。 此值為可選項。 預設值為 3。

--service-account, --sa

服務帳戶的名稱。 服務帳戶提供在實例中執行之程序的身分。 對於內建服務帳戶，您可以使用縮寫名稱 manager, none, reader，以及 writer。 您也可以使用以 Kubernetes Config Context 為前綴的全名，這可以使用 project current 指令來確定。 此值為可選項。

--trusted-profiles-enabled, --trusted, --tpe

啟用工作執行時裝載計算資源記號。 此值為可選項。 預設值為 false。

--wait, -w

等待建置執行完成。 如果指定 --wait 選項，建立執行會等待 --wait-timeout 選項設定的最長時間（以秒為單位）完成建立執行。 如果建立執行未在指定的 --wait-timeout 期間內完成，建立執行會失敗。 只有設定了 --build-source 選項，才允許使用 wait 選項。 此值為可選項。 預設值為 true。

--wait-timeout, --wto

等待建置執行完成的時間長度（以秒為單位）。 如果指定了 --wait 選項，則必須使用此值。 如果指定了 --no-wait 選項，此值會被忽略。 只有設定了 --build-source 選項，才允許使用 wait-timeout 選項。 預設值為 600。

範例

下面的示例使用容器映像 icr.io/codeengine/firstjob，並將 2G MB 作為記憶體和 1 個 CPU 指派給容器。 有關選擇有效記憶體和 CPU 值的詳細資訊，請參閱 支援的記憶體和 CPU 組合。

ibmcloud ce job create --image icr.io/codeengine/firstjob --name hellojob --memory 2G --cpu 1

輸出範例

Creating job 'hellojob'...
OK

指令選項

--name, -n

工作名稱。 此欄位為必填項目。

--force, -f

強制刪除，而不進行確認。 此值為可選項。 預設值為 false。

--ignore-not-found, --inf

如果未找到，請勿失敗。 此值為可選項。 預設值為 false。

--orphan-job-runs, -o

指定保留與此工作組態相關的任何工作執行。 然後，必須分別刪除這些無主工作執行。 此值為可選項。 預設值為 false。

--quiet, -q

指定此選項可減少指令的輸出。 此值為可選項。 預設值為 false。

範例

ibmcloud ce job delete --name hello

輸出範例

Are you sure you want to delete job hello? [y/N]> y
Deleting job 'hello'...
OK

當您執行 ibmcloud ce job delete 刪除工作的命令時，所有引用此工作的已提交工作執行例也會一併刪除。

指令選項

--name, -n

工作名稱。 此欄位為必填項目。

--output, -o

指定指令輸出的格式。 有效值為 json, yaml, jsonpath=JSONPATH_EXPRESSION，和 jsonpath-as-json=JSONPATH_EXPRESSION。 使用 jsonpath 指定 JSON 輸出元素的路徑。 此值為可選項。

--quiet, -q

指定此選項可減少指令的輸出。 此值為可選項。 預設值為 false。

範例

ibmcloud ce job get --name hellojob

輸出範例

Getting job 'hellojob'...
OK
Name:          hellojob
ID:            abcdabcd-abcd-abcd-abcd-abcdabcd1111
Project Name:  myproj
Project ID:    01234567-abcd-abcd-abcd-abcdabcd2222
Age:           59s
Created:       2021-03-01T15:33:30-05:00
Last Job Run:
  Name:     hellojob-jobrun-abcde
  Age:      32d
  Created:  2021-06-06T13:52:42-04:00
Image:                icr.io/codeengine/firstjob
Resource Allocation:
    CPU:     1
    Memory:  4G
Runtime:
    Mode:                  task
    Array Indices:         0
    Array Size:            1
    Max Execution Time:    7200
    Retry Limit:           3

指令選項

--output, -o

指定指令輸出的格式。 有效值為 json, yaml, jsonpath=JSONPATH_EXPRESSION，和 jsonpath-as-json=JSONPATH_EXPRESSION。 使用 jsonpath 指定 JSON 輸出元素的路徑。 此值為可選項。

--quiet, -q

指定此選項可減少指令的輸出。 此值為可選項。 預設值為 false。

--sort-by, -s

指定清單排序的直欄。 有效值為 name 和 age。 此值為可選項。 預設值為 name。

範例

ibmcloud ce job list

輸出範例

Name           Age   Last Job Run Name      Last Job Run Age
demo           110d  demo-jobrun-hkkmx      108d
myjob-envvar   107d
hellojob       7s
myjob          60d   myjob-977v7            58d
testjob        88d   testjob-jobrun-kzxlp   72d

指令選項

--name, -n

要解除綁定的工作名稱。 此欄位為必填項目。

--all, -A

解除此工作所有服務實例的綁定。 如果未指定 --binding，則必須使用此值。 預設值為 false。

--binding, -b

要解除綁定的綁定名稱。 執行 ibmcloud ce job get -n JOB_NAME 以檢視綁定名稱。 如果未指定 --all，則必須使用此值。

--quiet, -q

指定此選項可減少指令的輸出。 此值為可選項。 預設值為 false。

範例

在這個範例中，移除您名為 hello 的工作中的所有綁定。

ibmcloud ce job unbind --name hello --all

輸出範例

Removing service bindings...
OK

指令選項

--name, -n

工作名稱。 此欄位為必填項目。

--argument, --arg, -a

設定執行工作的參數。 每個 --argument 選項指定一個參數；例如，-a argA -a argB。 此值為可選項。

--arguments-clear, --ac

清除工作論點。 此值為可選項。 預設值為 false。

--array-indexes, --array-indices, --ai

指定用於執行該工作時所使用的陣列索引，例如 0,3,6,9、1-5,7-8,10。 索引的結果集限制為 1000 個項目。 只有在未指定 array-size 的情況下，才可指定此選項。 此值為可選項。

--array-size, --as, --instances, --is

指定用於執行工作的實例數。 當您使用此選項時，系統會將其轉換為陣列索引。 舉例來說，若您指定 instances （網址為 5 ），系統會將其轉換為 array-indexes （網址為 0 - 4 ）。 只有在未指定 --array-indexes 選項的情況下，才可指定此選項。 此值為可選項。 預設值為 0。

--build-clear, --bc

從此工作中移除建置的關聯。 只有當您的作業目前有關聯的建立時，才允許使用建立清除選項。 此值為可選項。 預設值為 false。

--build-commit, --commit, --bcm, --cm, --revision

來源儲存庫中要取回的確定、標籤或分支。 只有當 --build-source 選項在此 job update 指令上設定為 Git 儲存庫的 URL，或您的工作目前有來自 Git 儲存庫來源的關聯建立，才允許使用 build commit 選項。 此值為可選項。

--build-commit-clear, --commit-clear, --bcmc, --cmc

清除來源儲存庫中要取回的確定、標籤或分支。 只有當您的工作目前有關聯的建立時，才允許使用 commit clear 選項。 此值為可選項。 預設值為 false。

--build-context-dir, --context-dir, --bcdr, --cdr

套件庫中包含 buildpacks 檔案或 Dockerfile 的目錄。 只有在 job update 指令上設定了 --build-source 選項，或您的工作目前有相關的建立，才允許使用建立上下文目錄選項。 此值為可選項。

--build-dockerfile, --dockerfile, --bdf, --df

Dockerfile 的路徑。 僅在名稱不是 Dockerfile 時指定此選項。 如果 --build-source 選項是在這個 job update 指令上設定的，或是你的工作目前有一個相關的 build，那麼 build dockerfile 選項是允許的。 此值為可選項。 預設值為 Dockerfile。

--build-git-repo-secret, --git-repo-secret, --bgrs, --grs, --repo

SSH 密鑰的名稱，其中包含用來存取專用儲存庫的認證，該專用儲存庫包含用來建置容器映像檔的原始碼。 若要建立此 SSH 秘密，請使用 secret create --format SSH 指令。 SSH 秘密也可用作 Git 儲存庫存取秘 密。 只有當 --build-source 選項在此 job update 指令上設定為 Git 儲存庫的 URL，或您的工作目前有來自 Git 儲存庫來源的關聯建立時，才允許使用此選項。 此值為可選項。

--build-git-repo-secret-clear, --git-repo-secret-clear, --bgrsc, --grsc

清除 SSH 密鑰。 如果您的工作目前有相關的建立，則允許使用此選項。 此值為可選項。 預設值為 false。

--build-size, --size, --bsz, --sz

建置的規模，這將決定所使用的資源量。 有效值包括：small、medium、large、xlarge 以及 xxlarge。 如需詳細資訊，請參閱 確定建立的大小。 只有在 job update 指令上設定了 --build-source 選項，或您的工作目前有相關的建立，才允許使用建立大小選項。 此值為可選項。 預設值為 medium。

--build-source, --source, --bsrc, --src

Git 儲存庫的 URL 或包含您原始碼的本機原始碼路徑；例如 https://github.com/IBM/CodeEngine 或 .。 此值為可選項。

--build-strategy, --strategy, --bstr, --str

用於建置映像檔的策略。 有效值為 dockerfile 和 buildpacks。 只有在 job update 指令上設定了 --build-source 選項，或您的工作目前有相關的建立，才允許使用建立策略選項。 如果未指定，則在指定 --build-source 且原始碼位於本機的情況下，由 Code Engine 決定建立策略。 此值為可選項。 預設值為 dockerfile。

--build-timeout, --bto

在建立成功或失敗之前所能經過的時間，以秒為單位。 只有在 job update 指令上設定了 --build-source 選項，或您的工作目前有相關的建立，才允許使用建立逾時選項。 此值為可選項。 預設值為 600。

--command, --cmd, -c

設定執行工作的指令。 每個 --command 選項指定一個指令；例如，--cmd cmdA --cmd cmdB。 此值會覆寫在容器影像中指定的預設命令。 此值為可選項。

--commands-clear, --cc

清除工作指令。 此值為可選項。 預設值為 false。

--cpu

為執行工作設定的 CPU 數量。 此值會更新工作中指定的任何 --cpu 值。 有關有效值，請參閱 支援的記憶體和 CPU 組合。 此值為可選項。 預設值為 0。

--env, -e

設定執行工作的環境變數。 必須採用 NAME=VALUE 格式。 此動作可新增環境變數或覆寫現有的環境變數。 每個 --env 選項指定一個環境變數；例如，--env envA=A --env envB=B。 此值為可選項。

--env-cm, --env-from-configmap

使用下列其中一種方式，從儲存於此 configmap 的 key-value 對中設定環境變數：

• 若要為名為 configmapName 的 configmap 中的所有按鍵新增環境變數，請使用值 configmapName。 您可以在引用 configmap 時指定前綴來修改環境變數名稱。 若要指定前綴，請使用 PREFIX=CONFIGMAP_NAME。 每個結果環境變數的格式為 <PREFIX><NAME_OF_KEY_IN_CONFIGMAP>. 例如，要將配置表 configmapName 中所有變量名稱的鍵的前綴設為 CUSTOM_，請使用值 CUSTOM_=configmapName。 如果配置映射 configmapName 包含 KEY_A，環境變數名稱就是 CUSTOM_KEY_A。
• 若要為個別金鑰新增環境變數，請使用格式 NAME:KEY_A,KEY_B. 例如，若要在名為 configmapName 的 configmap 中為單一關鍵 key1 新增環境變數，請使用 configmapName:key1。 若要為引用的按鍵指定不同的名稱，請使用格式 NAME:NEW_NAME=KEY_A。 例如，若要為名為 configmapName 的 configmap 中的單一鍵 key1 新增名為 myKey 的環境變數，請使用值 configmapName:myKey=key1。

此值為可選項。

--env-from-configmap-rm, --env-cm-rm

使用 configmap 名稱，移除對完整 configmap 的環境變數參照。 若要移除對 configmaps 的個別關鍵參照，請使用 --env-rm 選項。 此選項可以指定多次。 此值為可選項。

--env-sec, --env-from-secret

使用下列其中一種方式，從儲存於秘密中的鍵值對設定環境變數：

• 若要為命名為 secretName 的秘密中的所有金鑰新增環境變數，請使用 secretName。 您可以在引用秘密時指定前綴來修改環境變數名稱。 若要指定前綴，請使用 PREFIX=SECRET_NAME。 每個結果環境變數的格式為 <PREFIX><NAME_OF_KEY_IN_SECRET>. 例如，若要將密碼 secretName 中所有變數名稱的前綴設定為 CUSTOM_，請使用值 CUSTOM_=secretName。 如果密文 secretName 包含 KEY_A，環境變數名稱就是 CUSTOM_KEY_A。
• 若要為個別金鑰新增環境變數，請使用格式 NAME:KEY_A,KEY_B. 例如，若要在名稱為 secretName 的秘密中為單一金鑰 key1 新增環境變數，請使用 secretName:key1。 若要為引用的按鍵指定不同的名稱，請使用格式 NAME:NEW_NAME=KEY_A。 例如，要在一個名為 secretName 的秘密中為單一金鑰 key1 新增一個名為 myKey 的環境變數，請使用 secretName:myKey=key1 的值。

此值為可選項。

--env-from-secret-rm, --env-sec-rm

使用秘密名稱，移除對完整秘密的環境變數參照。 若要移除秘密的個別金鑰參照，請使用 --env-rm 選項。 此選項可以指定多次。 此值為可選項。

--env-rm

移除對 configmap 或 secret 中鍵值對的 key 的環境變數參照。 若要移除個別的關鍵參照和字面值，請指定關鍵的名稱。 此選項可以指定多次。 此值為可選項。

--ephemeral-storage, --es

應為該工作執行程序設定的暫存儲存空間大小。 若要表示兆位元組，請使用 M ；若要表示吉位元組，請使用 G。 此值為可選項。

--force, -f

不驗證指定的 configmap 和 secret 參照是否存在。 Configmap 引用是使用 --env-from-configmap 選項指定的。 秘密參照使用 --env-from-secret 或 --registry-secret 選項指定。 此值為可選項。 預設值為 false。

--image, -i

用於執行工作的影像名稱。 格式為 REGISTRY/NAMESPACE/REPOSITORY:TAG，其中 REGISTRY 和 TAG 皆為可選項目。 若未指定 REGISTRY，預設值為 docker.io。 若未指定 TAG，預設值為 latest。 此值為可選項。

--maxexecutiontime, --met

工作執行的執行時間上限（以秒為單位）。 只有當 mode 的值為 task`` 時，才可指定此選項。 此值為可選項。 預設值為 7200。

--memory, -m

為執行工作設定的記憶體數量。 若要表示兆位元組，請使用 M ；若要表示吉位元組，請使用 G。 有關有效值，請參閱 支援的記憶體和 CPU 組合。 此值為可選項。

--mode

工作執行的模式。 有效值為 task 和 daemon。 在 task 模式下，maxexecutiontime 和 retrylimit 選項將生效。 在 daemon 模式下，由於沒有超時設定，且失敗的執行個體會無限期地重新啟動，因此不允許使用 --maxexecutiontime 和 --retrylimit 選項。 此值為可選項。

--mount-configmap, --mount-cm

透過提供掛載目錄和 configmap 的名稱，將 configmap 的內容新增至執行工作的檔案系統，格式為 MOUNT_DIRECTORY=CONFIGMAP_NAME. 每個掛載的 configmap 必須使用唯一的掛載目錄。 對於 configmap 中的每個 key-value 對，都會新增一個檔案到指定的 mount 目錄，其中檔案名稱是 key，檔案內容是 key-value 對的值。 每個 --mount-configmap 選項指定一個掛載設定；例如，--mount-configmap /etc/config-a=config-a --mount-configmap /etc/config-b=config-b。 此值為可選項。

--mount-data-store, --mount-ds

裝載持續資料儲存庫。 格式為 MOUNT_DIRECTORY=STORAGE_NAME [:SUBPATH]。 SUBPATH 為選用。 此選項可以指定多次。 此值為可選項。

--mount-rm

從執行工作的檔案系統中移除 configmap 或 secret 的內容，方法是指定掛載 configmap 或 secret 的目錄。 每個 --mount-rm 選項指定一個掛載目錄；例如，--mount-rm /etc/configmap-a --mount-rm /etc/secret-b。 此值為可選項。

--mount-secret, --mount-sec

透過提供掛載目錄和秘密名稱，將秘密內容加入執行工作的檔案系統，格式為 MOUNT_DIRECTORY=SECRET_NAME. 每個掛載的秘密必須使用唯一的掛載目錄。 對於秘密中的每個鍵值對，都會在指定的掛載目錄中加入一個檔案，其中檔案名稱是鍵，檔案內容是鍵值對的值。 每個 --mount-secret 選項指定一個掛載設定；例如，--mount-secret /etc/secret-a=secret--a --mount-secret /etc/secret-b=secret-b。 此值為可選項。

--no-wait, --nw

請不必等待建置執行完成。 如果指定 --no-wait 選項，則會開始執行建立，而不會等待。 使用 buildrun get 指令檢查建立執行狀態。 只有在此 job update 指令上設定了 --build-source 選項，或您的工作目前有相關的建立時，才允許使用 no-wait 選項。 此值為可選項。 預設值為 false。

--output, -o

指定指令輸出的格式。 有效值為 json, yaml, jsonpath=JSONPATH_EXPRESSION，和 jsonpath-as-json=JSONPATH_EXPRESSION。 使用 jsonpath 指定 JSON 輸出元素的路徑。 此值為可選項。

--quiet, -q

指定此選項可減少指令的輸出。 此值為可選項。 預設值為 false。

--rebuild

從來源重建映像檔。 如果您的作業目前有相關的建立，則允許使用重建選項。 此值為可選項。 預設值為 false。

--registry-secret, --rs

登錄密鑰的名稱。 當您下載容器映像檔時，會使用登錄密鑰向專用登錄進行鑑別。 此值為可選項。

--registry-secret-clear, --rsc

清除登錄密鑰。 此值為可選項。 預設值為 false。

--retrylimit, -r

在工作標示為失敗之前，重新執行工作實例的次數。 當作業的陣列索引出現非零的退出代碼時，該作業就會重新執行。 只有當 mode 的值為 task`` 時，才可指定此選項。 此值為可選項。 預設值為 3。

--service-account, --sa

服務帳戶的名稱。 服務帳戶提供在實例中執行之程序的身分。 對於內建服務帳戶，您可以使用縮寫名稱 manager, none, reader，以及 writer。 您也可以使用以 Kubernetes Config Context 為前綴的全名，這可以使用 project current 指令來確定。 此值為可選項。

--service-account-clear, --sac

清除服務帳戶。 此值為可選項。 預設值為 false。

--trusted-profiles-enabled, --trusted, --tpe

啟用工作執行時裝載計算資源記號。 此值為可選項。 預設值為 false。

--wait, -w

等待建置執行完成。 如果指定 --wait 選項，建立執行會等待 --wait-timeout 選項設定的最長時間（以秒為單位）完成建立執行。 如果建立執行未在指定的 --wait-timeout 期間內完成，建立執行會失敗。 只有在此 job update 指令上設定了 --build-source 選項，或您的工作目前有相關的建立時，才允許使用 wait 選項。 此值為可選項。 預設值為 true。

--wait-timeout, --wto

等待建置執行完成的時間長度（以秒為單位）。 如果指定了 --wait 選項，則必須使用此值。 如果指定了 --no-wait 選項，此值會被忽略。 如果在此 job update 指令上設定了 --build-source 選項，或您的工作目前有相關的建立，則允許使用 wait-timeout 選項。 預設值為 600。

範例

ibmcloud ce job update --name hellojob --cpu 2

輸出範例

Updating job 'hellojob'...
OK

指令選項

--force, -f

強制刪除，而不進行確認。 此值為可選項。 預設值為 false。

--ignore-not-found, --inf

如果未找到，請勿失敗。 此值為可選項。 預設值為 false。

--job, -j

使用此選項可刪除指定作業的所有作業執行。 如果未指定 --name 值，則 --job 選項為必填選項。 此值為可選項。

--name, -n

要刪除的作業執行名稱。 如果未指定 --job 值，則 --name 選項為必填選項。 此值為可選項。

--quiet, -q

指定此選項可減少指令的輸出。 此值為可選項。 預設值為 false。

範例

ibmcloud ce jobrun delete --name myjobrun -f

輸出範例

Deleting job run 'myjobrun'...
OK

指令選項

--instance, -i

特定作業執行實例的名稱。 使用 jobrun get 指令找出實體名稱。 如果未指定 --jobrun，則必須使用此值。

--jobrun, -j, --name, -n

顯示指定工作執行的所有實體的事件。 如果未指定 --instance，則必須使用此值。

--output, -o

指定指令輸出的格式。 有效值為 json, yaml, jsonpath=JSONPATH_EXPRESSION，和 jsonpath-as-json=JSONPATH_EXPRESSION。 使用 jsonpath 指定 JSON 輸出元素的路徑。 此值為可選項。

--quiet, -q

指定此選項可減少指令的輸出。 此值為可選項。 預設值為 false。

範例

以下範例會顯示指定工作執行的所有實體的系統事件資訊。

ibmcloud ce jobrun events --jobrun myjobrun

輸出範例

Getting jobrun 'myjobrun'...
Getting instances of jobrun 'myjobrun'...
Getting events for all instances of job run 'myjobrun'...
OK
myjobrun-1-0:
    Type     Reason                  Age  Source                  Messages
    Normal   Scheduled               49s  default-scheduler       Successfully assigned 4svg40kna19/myjobrun-1-0 to 10.240.64.136
    [...]
    Normal   Pulling                 34s  kubelet, 10.240.64.136  Pulling image "icr.io/codeengine/testjob"
myjobrun-2-0:
    Type    Reason     Age  Source                  Messages
    Normal  Scheduled  50s  default-scheduler       Successfully assigned 4svg40kna19/myjobrun-2-0 to 10.240.64.131
    Normal  Pulling    48s  kubelet, 10.240.64.131  Pulling image "icr.io/codeengine/testjob"

工作執行指定實例的系統事件資訊範例

您也可以使用 --instance 選項與 ibmcloud ce jobrun events 指令使用該選項。 使用 jobrun get 命令顯示作業執行的詳細資訊，包括作業執行的執行實體。

ibmcloud ce jobrun events --instance myjobrun-2-0

Getting events for job run instance 'myjobrun-2-0'...
OK
myjobrun-2-0:
    Type    Reason     Age    Source                  Messages
    Normal  Scheduled  3m39s  default-scheduler       Successfully assigned 4svg40kna19/myjobrun-2-0 to 10.240.64.131
    Normal  Pulling    3m37s  kubelet, 10.240.64.131  Pulling image "icr.io/codeengine/testjob"
    Normal  Pulled     2m42s  kubelet, 10.240.64.131  Successfully pulled image "icr.io/codeengine/testjob"
    Normal  Created    2m42s  kubelet, 10.240.64.131  Created container myjobrun
    Normal  Started    2m41s  kubelet, 10.240.64.131  Started container myjobrun

指令選項

--name, -n

工作執行的名稱。 此欄位為必填項目。

--output, -o

指定指令輸出的格式。 有效值為 json, yaml, jsonpath=JSONPATH_EXPRESSION，和 jsonpath-as-json=JSONPATH_EXPRESSION。 使用 jsonpath 指定 JSON 輸出元素的路徑。 此值為可選項。

--quiet, -q

指定此選項可減少指令的輸出。 此值為可選項。 預設值為 false。

範例

ibmcloud ce jobrun get --name myjobrun  

輸出範例

Getting jobrun 'myjobrun'...
Getting instances of jobrun 'myjobrun'...
Getting events of jobrun 'myjobrun'...
Run 'ibmcloud ce jobrun events -n myjobrun' to get the system events of the job run instances.
Run 'ibmcloud ce jobrun logs -f -n myjobrun' to follow the logs of the job run instances.
OK
Name:          myjobrun
[...]
Created:       2021-03-02T10:31:13-05:00
Image:                icr.io/codeengine/firstjob
Resource Allocation:
    CPU:                1
    Ephemeral Storage:  400M
    Memory:             4G
Runtime:
    Mode:                  task
    Array Indices:         1-5
    Array Size:            5
    JOP_ARRAY_SIZE Value:  5
    Max Execution Time:    7200
    Retry Limit:           3
Status:
    Completed:          2m58s
    Instance Statuses:
        Succeeded:  5
    Conditions:
        Type      Status  Last Probe  Last Transition
    Pending   True    3m55s       3m55s
    Running   True    3m51s       3m51s
    Complete  True    2m58s       2m58s
Events:
    Type     Reason         Age                     Source                Messages
    [...]
    Normal   Updated        3m38s (x23 over 3m56s)  batch-job-controller  Updated JobRun "myjobrun"
    Normal   Updated        3m38s (x22 over 3m56s)  batch-job-controller  Updated JobRun "myjobrun"
Instances:
    Name           Running  Status     Restarts  Age
    myjobrun-1-0  0/1      Succeeded  0         3m58s
    myjobrun-2-0  0/1      Succeeded  0         3m58s
    myjobrun-3-0  0/1      Succeeded  0         3m57s
    myjobrun-4-0  0/1      Succeeded  0         3m58s
    myjobrun-5-0  0/1      Succeeded  0         3m58s

指令選項

--job, -j

使用此選項可僅顯示指定作業的作業執行。 此值為可選項。

--output, -o

指定指令輸出的格式。 有效值為 json, yaml, jsonpath=JSONPATH_EXPRESSION，和 jsonpath-as-json=JSONPATH_EXPRESSION。 使用 jsonpath 指定 JSON 輸出元素的路徑。 此值為可選項。

--quiet, -q

指定此選項可減少指令的輸出。 此值為可選項。 預設值為 false。

--sort-by, -s

指定清單排序的直欄。 有效值為 name 和 age。 此值為可選項。 預設值為 name。

範例

ibmcloud ce jobrun list

輸出範例

Listing job runs...
OK
Name                         Failed  Pending  Requested  Running  Succeeded  Unknown  Age
firstjob-jobrun-shnj5        0       0        0          0        1          0        11d
myjob-jobrun-fji48           0       0        0          0        5          0        11d
myjob-jobrun-xeqc8           0       0        0          0        5          0        12d
myjobrun                     0       0        0          0        5          0        7m47s
mytestjob-jobrun-el0o8       0       0        0          0        1          0        11d
testjobrun                   0       0        0          0        5          0        11d

所列出的工作執行名稱，表示該工作執行的名稱及其當前修訂版本。

指令選項

--follow, -f

跟蹤作業執行實例的日誌。 使用此選項可串流工作執行實體的記錄。 如果指定 --follow 選項，則必須輸入 Ctrl+C 才能終止此記錄指令。 此值為可選項。 預設值為 false。

--instance, -i

特定作業執行實例的名稱。 使用 jobrun get 指令找出實體名稱。 如果未指定 --jobrun，則必須使用此值。

--jobrun, -j, --name, -n

顯示指定工作執行的所有實體的日誌。 如果未指定 --instance，則必須使用此值。

--output, -o

指定指令輸出的格式。 有效值為 json, yaml, jsonpath=JSONPATH_EXPRESSION，和 jsonpath-as-json=JSONPATH_EXPRESSION。 使用 jsonpath 指定 JSON 輸出元素的路徑。 此值為可選項。

--quiet, -q

指定此選項可減少指令的輸出。 此值為可選項。 預設值為 false。

--raw, -r

顯示沒有實體和容器標籤的記錄。 此值為可選項。 預設值為 false。

--tail, -t

將指定工作執行實例的日誌顯示限制為最近行數的上限。 例如，要顯示指定工作執行實例的最後 3 行日誌，請指定 --tail 3。 如果未指定此選項，則會顯示指定工作執行實例的所有日誌行。 此值為可選項。 預設值為 -1。

--timestamps, --ts

請在日誌輸出的每一行中加入時間戳記。 此值為可選項。 預設值為 false。

範例

以下範例顯示工作執行的特定實例的記錄。 使用 jobrun get 命令獲取工作執行實體的名稱。

ibmcloud ce jobrun logs --instance myjobrun-3-0

輸出範例

Getting logs for job run instance 'myjobrun-3-0'...
OK
myjobrun-3-0/myjobrun:
Hi from a batch job! My index is: 3

工作執行的所有實例的日誌範例

以下範例會顯示執行工作的所有實體的日誌。

ibmcloud ce jobrun logs --jobrun myjobrun

Getting logs for all instances of job run 'myjobrun'...
Getting jobrun 'myjobrun'...
Getting instances of jobrun 'myjobrun'...
OK
myjobrun-1-0/myjobrun:
Hi from a batch job! My index is: 1
myjobrun-2-0/myjobrun:
Hi from a batch job! My index is: 2
myjobrun-3-0/myjobrun:
Hi from a batch job! My index is: 3
myjobrun-4-0/myjobrun:
Hi from a batch job! My index is: 4
myjobrun-5-0/myjobrun:
Hi from a batch job! My index is: 5

指令選項

--instance, -i

特定作業執行實例的名稱。 使用 jobrun get 指令找出實體名稱。 如果未指定 --jobrun，則必須使用此值。

--jobrun, -j, --name, -n

重新啟動所指定工作執行的所有執行中實例。 如果未指定 --instance，則必須使用此值。

--quiet, -q

指定此選項可減少指令的輸出。 此值為可選項。 預設值為 false。

範例

ibmcloud ce jobrun restart --name myjobrun   

輸出範例

Getting jobrun 'myjobrun'...
Getting instances of jobrun 'myjobrun'...
Restarting all running instances of job run 'myjobrun'...
OK

指令選項

--jobrun, -j

此作業執行所依據的前一個作業執行的名稱。 此欄位為必填項目。

--argument, --arg, -a

設定此工作執行的參數。 每個 --argument 選項指定一個參數；例如，-a argA -a argB。 此值為可選項。

--arguments-clear, --ac

清除工作執行參數。 此值為可選項。 預設值為 false。

--array-indexes, --array-indices, --ai

指定用於此工作執行的實例索引，例如 0,3,6,9、1-5,7-8,10。 索引的結果集限制為 1000 個項目。 只有在未指定 array-size 的情況下，才可指定此選項。 此值為可選項。

--array-size, --as, --instances, --is

指定用於此工作執行的實例數。 當您使用此選項時，系統會將其轉換為陣列索引。 舉例來說，若您指定 instances （網址為 5 ），系統會將其轉換為 array-indexes （網址為 0 - 4 ）。 只有在未指定 --array-indexes 選項的情況下，才可指定此選項。 此值為可選項。 預設值為 0。

--array-size-var-override, --array-size-variable-override, --asvo

為 JOB_ARRAY_SIZE 環境變數指定自訂值。 預設情況下，JOB_ARRAY_SIZE 環境變數的值會設定為 array-size 中的數值，或是由 array-indexes 所指定的索引數量。 JOB_ARRAY_SIZE 環境變數的值不會影響設定的陣列大小。 使用此選項可針對工作重新執行的情況強制執行常數陣列大小值，在這種情況下，只有某些工作實例會被提交或重新提交。 此值為可選項。

--command, --cmd, -c

設定此工作執行的指令。 每個 --command 選項指定一個指令；例如，--cmd cmdA --cmd cmdB。 此值會覆寫在容器影像中指定的預設命令。 此值為可選項。

--commands-clear, --cc

清除工作執行指令。 此值為可選項。 預設值為 false。

--cpu

此工作執行時，每個陣列索引所設定的 CPU 數量。 有關有效值，請參閱 支援的記憶體和 CPU 組合。 此值為可選項。 預設值為 0。

--env, -e

設定此工作執行的環境變數。 必須採用 NAME=VALUE 格式。 此動作可新增環境變數或覆寫現有的環境變數。 每個 --env 選項指定一個環境變數；例如，-e envA -e envB。 此值為可選項。

--env-cm, --env-from-configmap

使用下列其中一種方式，從儲存於此 configmap 的 key-value 對中設定環境變數：

• 若要為名為 configmapName 的 configmap 中的所有按鍵新增環境變數，請使用值 configmapName。 您可以在引用 configmap 時指定前綴來修改環境變數名稱。 若要指定前綴，請使用 PREFIX=CONFIGMAP_NAME。 每個結果環境變數的格式為 <PREFIX><NAME_OF_KEY_IN_CONFIGMAP>. 例如，要將配置表 configmapName 中所有變量名稱的鍵的前綴設為 CUSTOM_，請使用值 CUSTOM_=configmapName。 如果配置映射 configmapName 包含 KEY_A，環境變數名稱就是 CUSTOM_KEY_A。
• 若要為個別金鑰新增環境變數，請使用格式 NAME:KEY_A,KEY_B. 例如，若要在名為 configmapName 的 configmap 中為單一關鍵 key1 新增環境變數，請使用 configmapName:key1。 若要為引用的按鍵指定不同的名稱，請使用格式 NAME:NEW_NAME=KEY_A。 例如，若要為名為 configmapName 的 configmap 中的單一鍵 key1 新增名為 myKey 的環境變數，請使用值 configmapName:myKey=key1。

此值為可選項。

--env-from-configmap-rm, --env-cm-rm

使用 configmap 名稱，移除對完整 configmap 的環境變數參照。 若要移除對 configmaps 的個別關鍵參照，請使用 --env-rm 選項。 此值為可選項。

--env-sec, --env-from-secret

使用下列其中一種方式，從儲存於秘密中的鍵值對設定環境變數：

• 若要為命名為 secretName 的秘密中的所有金鑰新增環境變數，請使用 secretName。 您可以在引用秘密時指定前綴來修改環境變數名稱。 若要指定前綴，請使用 PREFIX=SECRET_NAME。 每個結果環境變數的格式為 <PREFIX><NAME_OF_KEY_IN_SECRET>. 例如，若要將密碼 secretName 中所有變數名稱的前綴設定為 CUSTOM_，請使用值 CUSTOM_=secretName。 如果密文 secretName 包含 KEY_A，環境變數名稱就是 CUSTOM_KEY_A。
• 若要為個別金鑰新增環境變數，請使用格式 NAME:KEY_A,KEY_B. 例如，若要在名稱為 secretName 的秘密中為單一金鑰 key1 新增環境變數，請使用 secretName:key1。 若要為引用的按鍵指定不同的名稱，請使用格式 NAME:NEW_NAME=KEY_A。 例如，要在一個名為 secretName 的秘密中為單一金鑰 key1 新增一個名為 myKey 的環境變數，請使用 secretName:myKey=key1 的值。

此值為可選項。

--env-from-secret-rm, --env-sec-rm

使用秘密名稱，移除對完整秘密的環境變數參照。 若要移除秘密的個別金鑰參照，請使用 --env-rm 選項。 此選項可以指定多次。 此值為可選項。

--env-rm

移除對 configmap 或 secret 中鍵值對的 key 的環境變數參照。 若要移除個別的關鍵參照和字面值，請指定關鍵的名稱。 此選項可以指定多次。 此值為可選項。

--ephemeral-storage, --es

本次作業執行的暫存空間數量。 若要表示兆位元組，請使用 M ；若要表示吉位元組，請使用 G。 此值為可選項。

--force, -f

不驗證指定的 configmap 和 secret 參照是否存在。 Configmap 引用是使用 --env-from-configmap 選項指定的。 秘密參照使用 --env-from-secret 選項指定。 此值為可選項。 預設值為 false。

--maxexecutiontime, --met

此工作執行的執行時間上限（以秒為單位）。 只有當 mode 的值為 task`` 時，才可指定此選項。 此值為可選項。 預設值為 7200。

--memory, -m

分配給此工作執行的記憶體數量。 若要表示兆位元組，請使用 M ；若要表示吉位元組，請使用 G。 有關有效值，請參閱 支援的記憶體和 CPU 組合。 此值為可選項。

--mode

工作執行的模式。 有效值為 task 和 daemon。 在 task 模式下，maxexecutiontime 和 retrylimit 選項將生效。 在 daemon 模式下，由於沒有超時設定，且失敗的執行個體會無限期地重新啟動，因此不允許使用 maxexecutiontime 和 retrylimit 選項。 此值為可選項。

--mount-configmap, --mount-cm

透過提供掛載目錄和 configmap 的名稱，將 configmap 的內容新增至此工作執行的檔案系統，格式為 MOUNT_DIRECTORY=CONFIGMAP_NAME. 每個掛載的 configmap 必須使用唯一的掛載目錄。 對於 configmap 中的每個 key-value 對，都會新增一個檔案到指定的 mount 目錄，其中檔案名稱是 key，檔案內容是 key-value 對的值。 每個 --mount-configmap 選項指定一個掛載設定；例如，--mount-configmap /etc/config-a=config-a --mount-configmap /etc/config-b=config-b。 此值為可選項。

--mount-data-store, --mount-ds

裝載持續資料儲存庫。 格式為 MOUNT_DIRECTORY=STORAGE_NAME [:SUBPATH]。 SUBPATH 為選用。 此選項可以指定多次。 此值為可選項。

--mount-rm

從此工作執行的檔案系統中移除 configmap 或 secret 的內容，方法是指定掛載 configmap 或 secret 的目錄。 每個 --mount-rm 選項指定一個掛載目錄；例如，--mount-rm /etc/configmap-a --mount-rm /etc/secret-b。 此值為可選項。

--mount-secret, --mount-sec

透過提供掛載目錄和秘密名稱，將秘密的內容加入此工作執行的檔案系統，格式為 MOUNT_DIRECTORY=SECRET_NAME. 每個掛載的秘密必須使用唯一的掛載目錄。 對於秘密中的每個鍵值對，都會在指定的掛載目錄中加入一個檔案，其中檔案名稱是鍵，檔案內容是鍵值對的值。 每個 --mount-secret 選項指定一個掛載設定；例如，--mount-secret /etc/secret-a=secret--a --mount-secret /etc/secret-b=secret-b。 此值為可選項。

-n, --name

此工作執行的名稱。 如果引用的作業沒有相關的作業組態，則需要此值。 請使用專案內唯一的名稱。

• 名稱必須以小寫的英數字元開頭，並以小寫的英數字元結尾。
• 名稱必須為 53 個字元或以下，並可包含小寫字母、數字和連字符號 (-)。

此值為可選項。

--no-wait, --nw

重新提交作业运行，不要等待此作业运行的实例完成。 如果指定 --no-wait 選項，作業執行重新提交就會開始，不會等待。 使用 jobrun get 指令檢查工作執行狀態。 此值為可選項。 預設值為 true。

--output, -o

指定指令輸出的格式。 有效值為 json, yaml, jsonpath=JSONPATH_EXPRESSION，和 jsonpath-as-json=JSONPATH_EXPRESSION。 使用 jsonpath 指定 JSON 輸出元素的路徑。 此值為可選項。

--quiet, -q

指定此選項可減少指令的輸出。 此值為可選項。 預設值為 false。

--retrylimit, -r

在工作執行標示為失敗之前，重新執行此工作執行實例的次數。 當作業執行的陣列索引產生非零的退出代碼時，會重新執行。 只有當 mode 的值為 task`` 時，才可指定此選項。 此值為可選項。 預設值為 3。

--service-account, --sa

服務帳戶的名稱。 服務帳戶提供在實例中執行之程序的身分。 對於內建服務帳戶，您可以使用縮寫名稱 manager, none, reader，以及 writer。 您也可以使用以 Kubernetes Config Context 為前綴的全名，這可以使用 project current 指令來確定。 此值為可選項。

--service-account-clear, --sac

清除服務帳戶。 此值為可選項。 預設值為 false。

--trusted-profiles-enabled, --trusted, --tpe

啟用此工作執行實例裝載計算資源記號。 此值為可選項。 預設值為 false。

--wait, -w

重新提交工作執行，並等待此工作執行的實例完成。 如果指定 --wait 選項，工作執行重新提交會等待 --wait-timeout 選項設定的最長時間（以秒為單位），等待工作執行完成。 如果工作執行未在指定的 --wait-timeout 期間內完成，則工作執行重新提交失敗。 此值為可選項。 預設值為 false。

--wait-timeout, --wto

等待此工作執行實例完成所需的時間（以秒為單位）。 如果指定了 --wait 選項，則必須使用此值。 如果指定了 --no-wait 選項，此值會被忽略。 預設值為 600。

範例

下面的示例重新运行了 myjobrun 作业运行的实例 4-5。 重新提交的工作運行名稱為 myjobresubmit。

ibmcloud ce jobrun resubmit --name myjobresubmit --jobrun myjobrun --array-indices 4-5

輸出範例

Getting job run 'myjobrun'...
Rerunning job run 'myjobresubmit'...
Run 'ibmcloud ce jobrun get -n myjobresubmit' to check the job run status.
OK

指令選項

--argument, --arg, -a

設定此工作執行的參數。 每個 --argument 選項指定一個參數；例如，-a argA -a argB。 此值為可選項。

--array-indexes, --array-indices, --ai

指定用於此工作執行的實例索引，例如 0,3,6,9、1-5,7-8,10。 索引的結果集限制為 1000 個項目。 只有在未指定 array-size 的情況下，才可指定此選項。 此值為可選項。 預設值為 0。

--array-size, --as, --instances, --is

指定用於此工作執行的實例數。 當您使用此選項時，系統會將其轉換為陣列索引。 舉例來說，若您指定 instances （網址為 5 ），系統會將其轉換為 array-indexes （網址為 0 - 4 ）。 只有在未指定 --array-indexes 選項的情況下，才可指定此選項。 此值為可選項。 預設值為 1。

--array-size-var-override, --array-size-variable-override, --asvo

為 JOB_ARRAY_SIZE 環境變數指定自訂值。 預設情況下，JOB_ARRAY_SIZE 環境變數的值會設定為 array-size 中的數值，或是由 array-indexes 所指定的索引數量。 JOB_ARRAY_SIZE 環境變數的值不會影響設定的陣列大小。 使用此選項可針對工作重新執行的情況強制執行常數陣列大小值，在這種情況下，只有某些工作實例會被提交或重新提交。 此值為可選項。

--command, --cmd, -c

設定此工作執行的指令。 每個 --command 選項指定一個指令；例如，--cmd cmdA --cmd cmdB。 此值會覆寫在容器影像中指定的預設命令。 此值為可選項。

--cpu

此工作執行時，每個陣列索引所設定的 CPU 數量。 有關有效值，請參閱 支援的記憶體和 CPU 組合。 此值為可選項。 預設值為 1。

--env, -e

設定此工作執行的環境變數。 必須採用 NAME=VALUE 格式。 此動作可新增環境變數或覆寫現有的環境變數。 每個 --env 選項指定一個環境變數；例如，-e envA -e envB。 此值為可選項。

--env-cm, --env-from-configmap

使用下列其中一種方式，從儲存於此 configmap 的 key-value 對中設定環境變數：

• 若要為名為 configmapName 的 configmap 中的所有按鍵新增環境變數，請使用值 configmapName。 您可以在引用 configmap 時指定前綴來修改環境變數名稱。 若要指定前綴，請使用 PREFIX=CONFIGMAP_NAME。 每個結果環境變數的格式為 <PREFIX><NAME_OF_KEY_IN_CONFIGMAP>. 例如，要將配置表 configmapName 中所有變量名稱的鍵的前綴設為 CUSTOM_，請使用值 CUSTOM_=configmapName。 如果配置映射 configmapName 包含 KEY_A，環境變數名稱就是 CUSTOM_KEY_A。
• 若要為個別金鑰新增環境變數，請使用格式 NAME:KEY_A,KEY_B. 例如，若要在名為 configmapName 的 configmap 中為單一關鍵 key1 新增環境變數，請使用 configmapName:key1。 若要為引用的按鍵指定不同的名稱，請使用格式 NAME:NEW_NAME=KEY_A。 例如，若要為名為 configmapName 的 configmap 中的單一鍵 key1 新增名為 myKey 的環境變數，請使用值 configmapName:myKey=key1。

此值為可選項。

--env-sec, --env-from-secret

使用下列其中一種方式，從儲存於秘密中的鍵值對設定環境變數：

• 若要為命名為 secretName 的秘密中的所有金鑰新增環境變數，請使用 secretName。 您可以在引用秘密時指定前綴來修改環境變數名稱。 若要指定前綴，請使用 PREFIX=SECRET_NAME。 每個結果環境變數的格式為 <PREFIX><NAME_OF_KEY_IN_SECRET>. 例如，若要將密碼 secretName 中所有變數名稱的前綴設定為 CUSTOM_，請使用值 CUSTOM_=secretName。 如果密文 secretName 包含 KEY_A，環境變數名稱就是 CUSTOM_KEY_A。
• 若要為個別金鑰新增環境變數，請使用格式 NAME:KEY_A,KEY_B. 例如，若要在名稱為 secretName 的秘密中為單一金鑰 key1 新增環境變數，請使用 secretName:key1。 若要為引用的按鍵指定不同的名稱，請使用格式 NAME:NEW_NAME=KEY_A。 例如，要在一個名為 secretName 的秘密中為單一金鑰 key1 新增一個名為 myKey 的環境變數，請使用 secretName:myKey=key1 的值。

此值為可選項。

--ephemeral-storage, --es

本次作業執行的暫存空間數量。 若要表示兆位元組，請使用 M ；若要表示吉位元組，請使用 G。 此值為可選項。 預設值為 400M。

--force, -f

不驗證指定的 configmap 和 secret 參照是否存在。 Configmap 引用是使用 --env-from-configmap 選項指定的。 秘密參照使用 --env-from-secret 或 --registry-secret 選項指定。 此值為可選項。 預設值為 false。

--image, -i

用於此工作執行的影像名稱。 格式為 REGISTRY/NAMESPACE/REPOSITORY:TAG，其中 REGISTRY 和 TAG 皆為可選項目。 若未指定 REGISTRY，預設值為 docker.io。 若未指定 TAG，預設值為 latest。 如果未指定 --job 選項，則需要 --name 和 --image 值。 此值為可選項。

--job, -j

工作配置的名稱。 使用 job list 指令檢視工作組態。 如果指定 --job 值，則可選擇指定 --name 值。 如果未指定 --job 值，則必須指定 --name 和 --image 值。 此值為可選項。

--maxexecutiontime, --met

此工作執行的執行時間上限（以秒為單位）。 只有當 mode 的值為 task`` 時，才可指定此選項。 此值為可選項。 預設值為 7200。

--memory, -m

分配給此工作執行的記憶體數量。 若要表示兆位元組，請使用 M ；若要表示吉位元組，請使用 G。 有關有效值，請參閱 支援的記憶體和 CPU 組合。 此值為可選項。 預設值為 4G。

--mode

工作執行的模式。 有效值為 task 和 daemon。 在 task 模式下，maxexecutiontime 和 retrylimit 選項將生效。 在 daemon 模式下，由於沒有超時設定，且失敗的執行個體會無限期地重新啟動，因此不允許使用 maxexecutiontime 和 retrylimit 選項。 此值為可選項。 預設值為 task。

--mount-configmap, --mount-cm

透過提供掛載目錄和 configmap 的名稱，將 configmap 的內容新增至此工作執行的檔案系統，格式為 MOUNT_DIRECTORY=CONFIGMAP_NAME. 每個掛載的 configmap 必須使用唯一的掛載目錄。 對於 configmap 中的每個 key-value 對，都會新增一個檔案到指定的 mount 目錄，其中檔案名稱是 key，檔案內容是 key-value 對的值。 每個 --mount-configmap 選項指定一個掛載設定；例如，--mount-configmap /etc/config-a=config-a --mount-configmap /etc/config-b=config-b。 此值為可選項。

--mount-data-store, --mount-ds

裝載持續資料儲存庫。 格式為 MOUNT_DIRECTORY=STORAGE_NAME [:SUBPATH]。 SUBPATH 為選用。 此選項可以指定多次。 此值為可選項。

--mount-secret, --mount-sec

透過提供掛載目錄和秘密名稱，將秘密的內容加入此工作執行的檔案系統，格式為 MOUNT_DIRECTORY=SECRET_NAME. 每個掛載的秘密必須使用唯一的掛載目錄。 對於秘密中的每個鍵值對，都會在指定的掛載目錄中加入一個檔案，其中檔案名稱是鍵，檔案內容是鍵值對的值。 每個 --mount-secret 選項指定一個掛載設定；例如，--mount-secret /etc/secret-a=secret--a --mount-secret /etc/secret-b=secret-b。 此值為可選項。

-n, --name

此工作執行的名稱。 如果未指定 --job 值，則需要 --name 和 --image 值。 請使用專案內唯一的名稱。

• 名稱必須以小寫的英數字元開頭，並以小寫的英數字元結尾。
• 名稱必須為 53 個字元或以下，並可包含小寫字母、數字和連字符號 (-)。

此值為可選項。

--no-wait, --nw

提交作业运行，不要等待此作业运行的实例完成。 如果指定 --no-wait 選項，作業執行提交會開始，不會等待。 使用 jobrun get 指令檢查工作執行狀態。 此值為可選項。 預設值為 true。

--output, -o

指定指令輸出的格式。 有效值為 json, yaml, jsonpath=JSONPATH_EXPRESSION，和 jsonpath-as-json=JSONPATH_EXPRESSION。 使用 jsonpath 指定 JSON 輸出元素的路徑。 此值為可選項。

--quiet, -q

指定此選項可減少指令的輸出。 此值為可選項。 預設值為 false。

--registry-secret, --rs

登錄密鑰的名稱。 當您下載容器映像檔時，會使用登錄密鑰向專用登錄進行鑑別。 此值為可選項。

--retrylimit, -r

在工作執行標示為失敗之前，重新執行此工作執行實例的次數。 當作業執行的陣列索引產生非零的退出代碼時，會重新執行。 只有當 mode 的值為 task`` 時，才可指定此選項。 此值為可選項。 預設值為 3。

--service-account, --sa

服務帳戶的名稱。 服務帳戶提供在實例中執行之程序的身分。 對於內建服務帳戶，您可以使用縮寫名稱 manager, none, reader，以及 writer。 您也可以使用以 Kubernetes Config Context 為前綴的全名，這可以使用 project current 指令來確定。 此值為可選項。

--trusted-profiles-enabled, --trusted, --tpe

啟用此工作執行實例裝載計算資源記號。 此值為可選項。 預設值為 false。

--wait, -w

提交工作執行，並等待此工作執行的實例完成。 如果指定 --wait 選項，作業執行提交會等待 --wait-timeout 選項設定的最長時間（以秒為單位）完成作業執行。 如果工作執行未在指定的 --wait-timeout 期間內完成，則工作執行提交失敗。 此值為可選項。 預設值為 false。

--wait-timeout, --wto

等待此工作執行實例完成所需的時間（以秒為單位）。 如果指定了 --wait 選項，則必須使用此值。 如果指定了 --no-wait 選項，此值會被忽略。 預設值為 600。

範例

ibmcloud ce jobrun submit --name myjobrun --image icr.io/codeengine/firstjob --array-indices 1-5

輸出範例

Submitting job run 'myjobrun'...
Run 'ibmcloud ce jobrun get -n myjobrun' to check the job run status.
OK

指令選項

--cos-access-secret, --cos-sec

必要。 包含存取 COS 實例認證的密鑰名稱。 此欄位為必填項目。

--cos-bucket-name, --cos-bucket

必要。 COS 儲存區的名稱。 此欄位為必填項目。

--name, -n

必要。 持續資料儲存庫的名稱。 請使用專案內唯一的名稱。 此欄位為必填項目。

--cos-bucket-location, --cos-loc

COS 儲存區的位置。 此值為可選項。

--quiet, -q

指定此選項可減少指令的輸出。 此值為可選項。 預設值為 false。

範例

ibmcloud ce persistentdatastore create --name my-pds-2 --cos-bucket-name my-test-bucket-2 --cos-access-secret my-hmac-secret-2

輸出範例

Successfully created persistent data store named 'my-pds-2'.
OK

指令選項

--name, -n

必要。 持續資料儲存庫的名稱。 此欄位為必填項目。

--force, -f

強制刪除，而不進行確認。 此值為可選項。 預設值為 false。

--ignore-not-found, --inf

如果未找到，請勿失敗。 此值為可選項。 預設值為 false。

--quiet, -q

指定此選項可減少指令的輸出。 此值為可選項。 預設值為 false。

範例

ibmcloud ce persistentdatastore delete --name my-pds-3 -f

輸出範例

Deleting persistent data store 'my-pds-3'...
OK

指令選項

--name, -n

必要。 持續資料儲存庫的名稱。 此欄位為必填項目。

--output, -o

輸出格式。 有效值為 json, yaml, jsonpath=JSONPATH_EXPRESSION，和 jsonpath-as-json=JSONPATH_EXPRESSION。 此值為可選項。

--quiet, -q

指定此選項可減少指令的輸出。 此值為可選項。 預設值為 false。

範例

ibmcloud ce persistentdatastore get --name my-pds-2

輸出範例

Getting persistent data store 'my-pds-2'...
OK
Name:          my-pds-2  
ID:            abcdefgh-abcd-abcd-abcd-1a2b3c4d5e6f  
Type:          object_storage  
Created:       Fri, 11 Jul 2025 13:52:30 +0200  
Age:           103s  
Project Name:  myproject  
Project ID:    01234567-abcd-abcd-abcd-abcdabcd1111  
Data:    
  COS bucket:     my-test-bucket-2  
  Access secret:  my-hmac-secret-2  
  Bucket region:  eu-de  

指令選項

--output, -o

輸出格式。 有效值為 json, yaml, jsonpath=JSONPATH_EXPRESSION，和 jsonpath-as-json=JSONPATH_EXPRESSION。 此值為可選項。

--quiet, -q

指定此選項可減少指令的輸出。 此值為可選項。 預設值為 false。

--sort-by, -s

指定清單排序的直欄。 有效值為 name 和 age。 此值為可選項。 預設值為 name。

範例

此指令會列出專案中的所有持久性資料儲存。

ibmcloud ce persistentdatastore list

輸出範例

Listing persistent data stores...
OK
Name                       COS bucket          Access secret     Bucket region  Age  
my-pds-1                   my-test-bucket-1    my-hmac-secret-1  eu-gb          36d  
my-pds-2                   my-test-bucket-2    my-hmac-secret-2  eu-de          86s  
my-pds-3                   my-test-bucket-3    my-hmac-secret-3  us-south       6m30s  

指令選項

-n, --name

專案的名稱。 使用您所在區域特有的名稱。 名稱必須為 128 個字元或更少，並且可以包含：

• 任何 Unicode 或字母數字字符。
• 只有這些特殊字元：空格 ( )、句點 (. )、冒號 (: )、下劃線 (_) 和連字線 (-)。

此欄位為必填項目。

--endpoint, -e

專案的終點。 有效值為 public 和 private。 如果沒有明確指定 --endpoint 選項，則行為由系統決定。 如果 IBM Cloud CLI 連接到 private.cloud.ibm.com，Code Engine 專案的行為就好像 --endpoint 是 private。 如果 IBM Cloud CLI 連接到 cloud.ibm.com，Code Engine 專案的行為就好像 --endpoint 是 public。 此值為可選項。

--no-select, --ns

建立此專案後，請勿選擇專案為目前上下文。 如果您不選擇此選項，專案會自動被選取。 此值為可選項。 預設值為 false。

--no-wait, --nw

建立專案，不要等待專案建立。 如果指定 no-wait 選項，專案建立會開始，不會等待。 使用 project get 指令檢查專案狀態。 此值為可選項。 預設值為 false。

--output, -o

指定指令輸出的格式。 有效值為 json, yaml, jsonpath=JSONPATH_EXPRESSION，和 jsonpath-as-json=JSONPATH_EXPRESSION。 使用 jsonpath 指定 JSON 輸出元素的路徑。 此值為可選項。

--quiet, -q

指定此選項可減少指令的輸出。 此值為可選項。 預設值為 false。

--tag, -t

為專案指定的標籤。 標籤必須為 128 個字元或以下，並可包含字母、數字、空格 ( )、句點 (. )、冒號 (: )、下劃線 (_)，以及連字線 (-)。每個 --tag 選項指定一個標籤；例如，--tag tagA --tag tagB。 此值為可選項。

--wait, -w

建立專案，等待專案建立。 如果指定 --wait 選項，專案建立會等待 --wait-timeout 選項設定的最長時間（以秒為單位）。 如果專案未在指定的 --wait-timeout 期間內建立，專案建立會失敗。 此值為可選項。 預設值為 true。

--wait-timeout, --wto

等待建立專案所需的時間（以秒為單位）。 如果指定了 --wait 選項，則必須使用此值。 如果指定了 --no-wait 選項，此值會被忽略。 預設值為 600。

範例

ibmcloud ce project create --name myproject  

輸出範例

Creating project 'myproject'...
OK

指令選項

--output, -o

指定指令輸出的格式。 有效值為 json, yaml, jsonpath=JSONPATH_EXPRESSION，和 jsonpath-as-json=JSONPATH_EXPRESSION。 使用 jsonpath 指定 JSON 輸出元素的路徑。 此值為可選項。

--quiet, -q

指定此選項可減少指令的輸出。 此值為可選項。 預設值為 false。

範例

ibmcloud ce project current  

輸出範例

Getting the current project context...
OK
Name:       myproject
ID:         01234567-abcd-abcd-abcd-abcdabcd1111
Subdomain:  aabon2dfwa0
Domain:     us-south.codeengine.appdomain.cloud
Region:     us-south
Kubectl Context:  4svg40kna19
Kubernetes Config:
Context:             aabon2dfwa0
Environment Variable: export KUBECONFIG=/user/myusername/.bluemix/plugins/code-engine/myproject-01234567-abcd-abcd-abcd-abcdabcd1111.yaml

指令選項

--force, -f

強制刪除，而不進行確認。 此值為可選項。 預設值為 false。

--hard

立即刪除專案。 如果未指定 --hard 選項，則可使用 project restore 或 reclamation restore 指令在 7 天內還原專案。 此值為可選項。 預設值為 false。

--id, --guid

該專案的識別碼。 如果未指定 --name，則必須使用此值。

--name, -n

專案的名稱。 如果未指定 --id，則必須使用此值。

--no-wait, --nw

刪除專案，不要等待專案被刪除。 如果指定 no-wait 選項，專案刪除就會開始，不會等待。 使用 project get 指令檢查專案狀態。 此值為可選項。 預設值為 false。

--quiet, -q

指定此選項可減少指令的輸出。 此值為可選項。 預設值為 false。

--wait, -w

刪除該專案，並等待專案完成刪除。 如果指定 --wait 選項，專案刪除會等待 --wait-timeout 選項設定的最長時間（以秒為單位），專案才會被刪除。 如果專案未在指定的 --wait-timeout 期間內刪除，則專案刪除失敗。 此值為可選項。 預設值為 true。

--wait-timeout, --wto

等待刪除該專案所需的時間（以秒為單位）。 如果指定了 --wait 選項，則必須使用此值。 如果指定了 --no-wait 選項，此值會被忽略。 預設值為 600。

範例

ibmcloud ce project delete --name myproject -f

輸出範例

Deleting project 'myproject'...
OK

指令選項

--id, --guid

該專案的識別碼。 如果未指定 --name，則必須使用此值。

--name, -n

專案的名稱。 如果未指定 --id，則必須使用此值。

--output, -o

指定指令輸出的格式。 有效值為 json, yaml, jsonpath=JSONPATH_EXPRESSION，和 jsonpath-as-json=JSONPATH_EXPRESSION。 使用 jsonpath 指定 JSON 輸出元素的路徑。 此值為可選項。

--quiet, -q

指定此選項可減少指令的輸出。 此值為可選項。 預設值為 false。

範例

ibmcloud ce project get --name myproject

輸出範例

Getting project 'myproject'...
OK
Name:                                      myproject
ID:                                        abcdabcd-abcd-abcd-abcd-f1de4aab5d5d
CRN:                                       crn:v1:bluemix:public:codeengine:au-syd:a/1a2b3c4d5e6f7g1a2b3c4d5e6f7g1234:abcdabcd-abcd-abcd-abcd-f1de4aab5d5d::
Status:                                    active
Enabled:                                   true
Application Private Visibility Supported:  true
Selected:                                  true
Tags:                                      tag1, tag2
Region:                                    us-south
Resource Group:                            default
Service Binding Service ID:                ServiceId-1234abcd-abcd-abcd-1111-1a2b3c4d5e6f
Age:                                       52d
Created:                                   Mon, 30 Jun 2025 18:16:12 +0200
Updated:                                   Mon, 30 Jun 2025 18:16:58 +0200
Connectivity:    
  Outbound - Source IP addresses:                             
    Public internet  
    159.23.99.151  
    130.198.13.241  
    135.90.137.31  
    
    IBM Cloud private network  
    10.223.236.11  
    10.223.242.142  
    10.12.3.244  
  Inbound - Context-based restrictions for the data plane:    
    Enforcement status:         none  
    Public internet:            allowed  
    IBM Cloud private network:  allowed  
    Last applied:               Wed, 20 May 2026 15:52:02 +0200  
Quotas:
    Category                                  Used       Limit
    App revisions                             33         100
    Apps                                      10         100
    Build runs                                4          100
    Builds                                    4          100
    Configmaps                                7          100
    CPU                                       6.15       64
    Custom domain mappings                    4          80
    Ephemeral storage                         5415750Ki  256G
    Functions                                 2          20
    Instances (active)                        6          250
    Instances (total)                         9          2500
    Job runs                                  4          100
    Jobs                                      3          100
    Memory                                    26400M     256G
    Persistent data stores                    2          10
    Private path connections                  1          3
    Secrets                                   21         100
    Serverless fleets                         42         1000
    Subnet pools                              3          20
    Subscriptions (cron)                      1          100
    Subscriptions (IBM Cloud Object Storage)  0          100

指令選項

--all-resource-groups, --all

顯示所有資源群組的專案。 預設只顯示目前資源群組中的專案。 此值為可選項。 預設值為 false。

--output, -o

指定指令輸出的格式。 有效值為 json, yaml, jsonpath=JSONPATH_EXPRESSION，和 jsonpath-as-json=JSONPATH_EXPRESSION。 使用 jsonpath 指定 JSON 輸出元素的路徑。 此值為可選項。

--quiet, -q

指定此選項可減少指令的輸出。 此值為可選項。 預設值為 false。

--regions, -r

限制專案顯示於指定區域。 提供一個或多個區域的名稱；例如 us-south,eu-de。 此值為可選項。

--sort-by, -s

指定清單排序的直欄。 有效值為 name 和 age。 此值為可選項。 預設值為 name。

範例

ibmcloud ce project list

輸出範例

Getting projects...
OK
Name             ID                                    Status  Selected  Tags  Region    Resource Group  Age
myproj-eude      09768af4-abcd-abcd-abcd-24674ba90db0  active  false           eu-de     default         27d
myproject        cd09cfe1-abcd-abcd-abcd-0f8a8a1d0ddf  active  true            us-south  default         52d

指令選項

--id, --guid

該專案的識別碼。 如果未指定 --name，則必須使用此值。

--name, -n

專案的名稱。 如果未指定 --id，則必須使用此值。

--no-wait, --nw

還原專案，不要等待專案還原。 如果指定 no-wait 選項，專案還原會開始，不會等待。 使用 project get 指令檢查專案狀態。 此值為可選項。 預設值為 false。

--quiet, -q

指定此選項可減少指令的輸出。 此值為可選項。 預設值為 false。

--wait, -w

還原專案，等待專案還原。 如果指定 --wait 選項，專案還原會等待 --wait-timeout 選項設定的最長時間（以秒為單位），以便還原專案。 如果專案未在指定的 --wait-timeout 期間內還原，則專案還原失敗。 此值為可選項。 預設值為 true。

--wait-timeout, --wto

等待專案還原所需的時間（以秒為單位）。 如果指定了 --wait 選項，則必須使用此值。 如果指定了 --no-wait 選項，此值會被忽略。 預設值為 600。

範例

本範例將處於 soft deleted 狀態的 myproject 專案還原為作用中狀態。 使用 project list 指令顯示所有專案的清單及其狀態。

ibmcloud ce project restore --name myproject

輸出範例

Restoring project 'myproject'...
OK