設定 CLI

安裝、更新及刪除必要的 CLI ，並將您的環境設定為使用 IBM Cloud® Code Engine。

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 Functions 外掛程式
    • 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_name> 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 指令。

更新 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

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

在 Web 瀏覽器中存取 IBM Cloud Shell

使用 IBM® Cloud Shell，您可以直接從 Web 瀏覽器使用 IBM Cloud CLI 及其他 CLI 外掛程式。

IBM Cloud Shell 已啟用數個 外掛程式和工具，包括基本 IBM Cloud CLI (ibmcloud) 及 Code Engine CLI。

當您使用 Cloud Shell時，請記住下列限制。

  • 您可以開啟最多五個並行階段作業，這些階段作業可獨立運作，以便您可以一次使用不同的資源、地區及帳戶。
  • 您在本端下載及編輯的任何檔案 (例如 YAML 檔案) 都會暫時儲存在 Cloud Shell 中，且不會跨階段作業持續保存。
  • Cloud Shell 具有使用配額，可將您限制為一週內 50 小時。

若要啟動並使用 IBM Cloud Shell，請在 IBM Cloud 主控台 功能表列中，按一下 Cloud Shell 圖示 IBM Cloud Shell 圖示。 階段作業即會啟動，並使用您的現行帳戶認證自動將您登入 IBM Cloud CLI。