開始使用 Code Engine CLI

您可以使用 IBM Cloud® Code Engine API 來建立和管理您的 Code Engine 實體。

設定您的 CLI 環境

若要使用 CLI 來建立及管理 Code Engine 實體，請設定 CLI 環境。 請確認您已安裝最新版本的 IBM Cloud CLI。

開始之前

您必須建立 IBM Cloud 帳戶。

  1. 下載並安裝 IBM Cloud CLI。

  2. 登入 IBM Cloud CLI。

    1. 登入 IBM Cloud CLI。
        ibmcloud login
    ```
2. 如果您有多個帳戶，系統會提示您選取要使用哪一個帳戶。 請依照提示操作，或使用 **`target`** 指令來選擇您的 IBM Cloud 帳戶。

```txt {: pre}
    ibmcloud target -c <account_id>
    ```
3. 指定地區。 請使用 **`target`** 命令來選取或變更區域。

```txt {: pre}
    ibmcloud target -r <region>
    ```
4. 指定資源群組。 若要取得資源群組的清單，請執行下列指令。

```txt {: pre}
    ibmcloud resource groups
    ```
    輸出範例

    ```txt {: screen}
    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
    ```
5. 執行下列指令將資源群組設為目標。

```txt {: pre}
    ibmcloud target -g <resource_group>
    ```
    輸出範例

    ```txt {: screen}
    Targeted resource group default
    ```

  3. 安裝 Code Engine CLI 外掛程式。

    ibmcloud plugin install code-engine

  4. 請確認已安裝 Code Engine CLI 外掛程式。 您可以使用 ibmcloud code-engine version 指令或 ibmcloud plugin list 指令來確認已安裝外掛程式。

    ibmcloud code-engine version

    輸出範例

    OK
version:  v1.54.2
commit:   e4800be63b1077563bdbaee9e656ce1f81c3e08d

  5. 執行 ibmcloud ce help 指令，以檢視 Code Engine CLI 的指令。 例如，

    ibmcloud ce help

使用 Code Engine CLI

現在已設定 Code Engine CLI 環境，您已準備好使用 Code Engine 資源，例如應用程式、函數或使用 CLI 的工作。

您必須先在專案的環境定義內工作，才能使用 Code Engine 資源。

專案是由 Code Engine 中的各項實體（例如應用程式、函式、工作、機隊和建置）所組成的集合。 專案以 Kubernetes 名稱空間為基礎。 專案名稱在 IBM Cloud® 資源群組、使用者帳戶及地區內必須是唯一的。 專案用於管理資源，並提供對其實體的存取權限。

一個專案提供以下功能：

  • 實體名稱的專用命名空間。
  • 專案資源的外部存取管理。
  • 對後端服務、註冊機構及資料庫的外連存取進行管理。
  • 一份針對傳輸層服務（ TLS ）自動生成的憑證。

如需 Code Engine 專案的相關資訊，請參閱 管理專案。

  1. 使用 project create 指令建立專案。 請使用對您的區域而言唯一的專案名稱。

    ibmcloud ce project create --name PROJECT_NAME

    輸出範例

    Creating project 'myproject'...
OK

  2. 使用 project get 指令來檢視專案的詳細資料。

    ibmcloud ce project get --name PROJECT_NAME

    輸出範例

    Getting project 'myproject'...
OK
Name:                       myproject
ID:                         01234567-abcd-abcd-abcd-abcdabcd1111
Status:                     active
Selected:                   true
Region:                     us-south
Resource Group:             default
Service Binding Service ID: ServiceId-1234abcd-abcd-abcd-1111-1a2b3c4d5e6f
Age:                        52d
Created:                    Fri, 15 Jan 2021 13:32:30 -0500
Updated:                    Fri, 15 Jan 2021 13:32:45 -0500
Quotas:
Category                                  Used      Limit
App revisions                             1         100
Apps                                      1         100
Build runs                                0         100
Builds                                    0         100
Configmaps                                2         100
CPU                                       1.025     64
Ephemeral storage                         902625Ki  256G
Instances (active)                        1         250
Instances (total)                         2         2500
Job runs                                  1         100
Jobs                                      1         100
Memory                                    4400M     256G
Secrets                                   5         100
Subscriptions (cron)                      0         100
Subscriptions (IBM Cloud Object Storage)  0         100

或者，您可以使用 project list 指令來顯示已建立專案的清單。

如果要使用 CLI 來使用專案，必須選取專案作為現行環境定義。 除非您指定 --no-select 選項，否則在建立專案時，會自動選取專案作為現行環境定義。 若要選取目前未設為目標的專案，請使用 project select 指令。

如需使用專案的相關資訊，請參閱 管理專案。

下一步

既然您已設定 CLI 環境，並已採取首要步驟來確保您在 Code Engine 專案的環境定義內工作，您可以使用 Code Engine CLI 來使用應用程式、函數及工作。

若要使用 CLI 開始使用 Code Engine 元件，請參閱下列主題。

如需 Code Engine CLI 的相關資訊，請參閱 設定 CLI 環境。

如需在 Code Engine CLI 環境中工作的相關資訊，請參閱 Code Engine CLI Command Reference 文件。

如需每一個 CLI 版本的變更摘要，請參閱 CLI 版本歷程。 請務必保持您的 CLI 處於最新狀態，以便能夠使用所有可用的指令及其選項。