Code Engine CLI 支援的環境

Code Engine 命令列介面 (CLI) 支援以下環境：

• Linux 64 位元
• Linux 64 位元 ARM
• Linux 32 位元
• Mac OS X 64 位元
• Mac OS X M1/ARM
• Windows 64 位元
• Windows 32 位元

安裝 IBM Cloud CLI

安裝最新版本的 IBM Cloud CLI。

開始之前

您必須建立一個 IBM Cloud 帳戶。

1. 下載並安裝 IBM Cloud CLI。

   此安裝包包含以下檔案：

   • IBM Cloud Object Storage 外掛程式
   • IBM Cloud Container Registry 外掛程式
   • IBM Cloud Kubernetes Service 外掛程式

   如需更多資訊，請參閱 IBM Cloud CLI。

2. 登入 IBM Cloud CLI。

   ibmcloud login
   

3. 如果您有多個帳戶，系統會提示您選取要使用哪一個帳戶。 請依照提示操作，或使用 target 指令來選擇您的 IBM Cloud 帳戶。

   ibmcloud target -c <account_id>
   

4. 您也須指定一個地區。 您可以使用 target 命令來選取或變更區域。

   ibmcloud target -r <region>
   

5. 您必須指定一個資源群組。 若要取得資源群組的清單，請執行下列指令。

   ibmcloud resource groups
   

   輸出範例

   Retrieving all resource groups under account <account_id> as email@ibm.com...
   OK
   Name      ID                                 Default Group   State
   default   a8a12accd63b437bbd6d58fb8b462ca7   true            ACTIVE
   test      a8a12abbbd63b437cca6d58fb8b462ca7  false           ACTIVE
   

6. 執行下列指令將資源群組設為目標。

   ibmcloud target -g <resource_group>
   

   輸出範例

   Targeted resource group default
   

安裝 Code Engine CLI 外掛程式

安裝最新版本的 Code Engine CLI。

請務必確認您已安裝最新版本的 IBM Cloud 命令列介面（CLI）。 否則，您的 Code Engine CLI 安裝可能會失敗，並顯示類似「Could not find compatible binary to install for plug-in code-engine」的訊息。

1. 安裝 Code Engine 外掛程式。

   ibmcloud plugin install code-engine
   

2. 請使用 ibmcloud plugin show code-engine 指令來確認外掛程式是否已安裝。

   ibmcloud plugin show code-engine
   

   輸出範例

   Plugin Name                              code-engine[ce]
   Plugin Version                           1.31.0
   Plugin SDK Version                       0.9.0
   Minimal IBM Cloud CLI version required   1.0.0
   Private endpoints supported              true
   Commands:
   code-engine,ce                    Manage Code Engine components.
   [...]
   

3. 若要執行 Code Engine 指令，請使用 ibmcloud code-engine 或 ibmcloud ce。 若要查看 Code Engine 外掛程式所能執行的所有功能，請執行 ibmcloud ce （不帶任何參數）。

   ibmcloud ce
   

若需要，您可以安裝 jq 套件。 許多 Code Engine 指令都包含一個選項（--output JSON ），可用於產生 JSON 輸出。 透過這個套件，您可以從命令列檢視並解析 JSON 回應。

如需更多關於 Code Engine 指令的資訊，請參閱 [**ibmcloud ce** 指令](/docs/codeengine?topic=codeengine-cli)。

更新 Code Engine CLI

請定期更新 CLI，以善用新功能。

1. 執行 ibmcloud plugin list 指令。

   ibmcloud plugin list
   

   輸出範例

   Listing installed plug-ins...
   Plugin Name                                  Version   Status             Private endpoints supported
   code-engine[ce]                              1.31.0                       true
   container-registry                           0.1.571                      true
   container-service[kubernetes-service]        1.0.408                      false
   

2. 如果有多個更新可用，請執行 ibmcloud plugin update 指令。

   ibmcloud plugin update code-engine
   

解除安裝 CLI

如果不再需要 CLI，則可以將它解除安裝。

1. 列出已安裝的外掛程式。

   ibmcloud plugin list
   

2. 解除安裝這些外掛程式。 例如，若要解除安裝「Code Engine」CLI 外掛程式：

   ibmcloud plugin uninstall code-engine
   

3. 執行下列指令，並檢查已安裝的外掛程式清單，以驗證已解除安裝外掛程式。

   ibmcloud plugin list
   

您已刪除的外掛程式不會顯示在搜尋結果中。

在您的網頁瀏覽器中存取 IBM Cloud Shell

透過 IBM® Cloud Shell，您可直接透過網頁瀏覽器使用 IBM Cloud 命令列介面 (CLI) 及其他 CLI 外掛程式。

IBM Cloud Shell 透過多個 外掛程式和工具 來實現，其中包括基礎的 IBM Cloud 命令列介面 (ibmcloud) 以及 Code Engine 命令列介面。

在使用 Cloud Shell 時，請注意以下限制。

• 您可以同時開啟最多五個工作階段，這些工作階段各自獨立運作，因此您可以同時處理不同的資源、區域和帳戶。
• 您在本地端下載並編輯的任何檔案（例如 YAML 檔案），都會暫時儲存於「Cloud Shell」中，且不會在不同工作階段之間保留。
• Cloud Shell 設有使用配額，限制您每週的使用時間不得超過 50 小時。

要啟動並使用「IBM Cloud Shell」，請在「IBM Cloud 主機」功能表列中，點擊「Cloud Shell」圖示 。 會話開始後，系統會自動使用您當前的帳戶憑證登入 IBM Cloud CLI。