更新及刪除環境

本頁面說明如何更新、刪除和查看 Cloud Composer 環境的詳細資料,以及如何更新和查看環境的 Apache Airflow 設定。

事前準備

  • 如要更新或刪除環境,您必須具備下列權限:

  • 大部分的 gcloud composer 指令都需要位置。如要指定位置,您可以使用 --location 標記或設定預設位置

  • Cloud Composer 有一些無法變更的預先設定 Airflow 參數。您可以變更的 Cloud Composer 環境設定為節點數、Airflow 設定覆寫、環境變數、標籤和 PyPI 套件。

  • 提交 Airflow 設定更新要求後,您必須等候約 5 分鐘,更新內容才會套用到所有 Airflow 執行個體 (工作站、伺服器、排程器)。

限制

Cloud Composer 不接受並行環境更新或刪除要求。您必須等候某個環境更新或刪除要求完成,然後才能發出另一個環境更新或刪除要求。

更新環境

如要更新 Cloud Composer 環境 (包括 Airflow 設定),請按照下列步驟操作:

主控台

  1. 在 Google Cloud Platform 中開啟「Environments」(環境) 頁面。

    開啟「Environments」(環境) 頁面

  2. 按一下環境的名稱進行修改。

  3. 根據您要更新的屬性,選取對應的分頁標籤。

  4. 按一下 [Edit] (編輯)

  5. 進行更新,然後按一下 [Submit] (提交)。

gcloud

如要更新 Airflow 設定,請搭配 --update-airflow-configs 標記執行 gcloud composer environments update 指令:

gcloud composer environments update ENVIRONMENT_NAME \
    --location LOCATION \
    --update-airflow-configs=KEY=VALUE,KEY=VALUE,... 

其中:

  • ENVIRONMENT_NAME 是環境的名稱。
  • LOCATION 是環境所在的 Compute Engine 地區。
  • KEY=VALUE 是以連字號分隔的設定區段和屬性名稱 (例如 core-print_stats_interval) 以及其對應的值。

例如:

gcloud composer environments update test-environment \
    --location us-central1 \
    --update-airflow-configs=core-load_example=True,webserver-dag_orientation=TB 

如需其他範例,請參閱 gcloud composer environments update 參考資料頁面。

API

如要更新 Cloud Composer 環境 (包括 Airflow 設定),請使用 Cloud Composer REST API 發出 environments.patch API 要求。

還原預設 Airflow 設定

如要還原所有預設 Airflow 設定值,請使用以下指令:

gcloud composer environments update ENVIRONMENT_NAME \
    --location LOCATION \
    --clear-airflow-configs

如要還原一或多個預設 Airflow 設定值,請使用以下指令:

gcloud composer environments update ENVIRONMENT_NAME \
    --location LOCATION \
    --remove-airflow-configs=core-load_example,webserver-dag_orientation 

其中:

  • ENVIRONMENT_NAME 是環境的名稱。
  • LOCATION 是環境所在的 Compute Engine 地區。

例如:

gcloud composer environments update test-environment \
    --location us-central1 \
    --update-airflow-configs=core-load_example=True,webserver-dag_orientation=TB 

指令會在作業完成時終止。如要避免等候,請使用 --async 標記。

查看環境詳細資料

如要查看 Cloud Composer 環境詳細資料 (包括 Airflow 設定),請按照下列步驟操作:

主控台

  1. 在 GCP 主控台中開啟「Environments」(環境) 頁面。

    開啟「Environments」(環境) 頁面

  2. 按一下環境的名稱
  3. 選取適當的屬性分頁標籤。

gcloud

gcloud composer environments describe ENVIRONMENT_NAME \
    --location LOCATION
    --format="get(PROPERTY)"

其中:

  • ENVIRONMENT_NAME 是環境的名稱。
  • LOCATION 是環境所在的 Compute Engine 地區。
  • --format 是用來指定環境屬性的選項,例如針對 Airflow 網路伺服器網址指定 config.airflowUri

例如:

gcloud composer environments describe test-environment 
--location us-central1 --format="get(config.airflowUri)"

# Returns https://a6b3z6e3nnZZZnnd3a-tp.appspot.com

API

如要使用 Cloud Composer REST API 查看 Airflow 設定,請發出 environments.get API 要求,並填入環境 ID。

升級機器類型

您可以建立新的代管執行個體群組範本,並更新環境 GKE 叢集中的執行個體,藉此手動升級環境 GKE 叢集的機器類型。

如要升級機器類型,請按照下列步驟操作:

  1. 在 GCP 主控台中,按一下要升級的環境名稱
  2. 按照下列步驟找出目前的執行個體群組範本:
    1. 在「Environment details」(環境詳細資料) 頁面中,按一下 [GKE cluster ID] (GKE 叢集 ID) 連結。
    2. 在「Clusters」(叢集) 頁面的「Node Pools」(節點集區) 部分中,記下「Instance groups」(執行個體群組) 名稱,然後按一下其連結。
    3. 在「Instance Groups」(執行個體群組) 頁面的「Members」(成員) 底下,按一下範本連結。畫面上隨即會顯示「Instance templates」(執行個體範本) 頁面。
  3. 按照下列步驟建立新的執行個體群組範本:
    1. 在「Instance templates」(執行個體範本) 頁面中,按一下 [Create similar] (建立類似的執行個體範本)。
    2. 在「Create an instance template」(指定執行個體範本) 頁面中,指定新範本的名稱。
    3. 在「Machine type」(機器類型) 底下選擇機器類型,然後按一下 [Create] (建立)。新範本隨即會顯示在「Instance templates」(執行個體範本) 頁面的清單中。
  4. 按照下列步驟更新環境叢集中的執行個體:
    1. 依序前往「Compute Engine」>「Instance groups」(執行個體群組) 頁面,然後按一下您先前記下的執行個體群組名稱
    2. 按一下 [Rolling update] (滾動式更新)。
    3. 在「Template」(範本) 底下,選取您建立的新範本。
    4. 按一下 [Update] (更新)

刪除環境

如要刪除 Cloud Composer 環境,請按照下列步驟操作:

主控台

  1. 在 GCP 主控台中開啟「Environments」(環境) 頁面。

    開啟「Environments」(環境) 頁面

  2. 找出要刪除的環境,然後勾選旁邊的方塊。
  3. 按一下 [Delete] (刪除)

gcloud

執行以下指令即可刪除 Cloud Composer 環境:

gcloud composer environments delete ENVIRONMENT_NAME \
    --location LOCATION   

其中:

  • ENVIRONMENT_NAME 是環境的名稱。
  • LOCATION 是環境所在的 Compute Engine 地區。

執行 gcloud composer environments describe --help 可查看指令參數資訊。

API

如要使用 Cloud Composer REST API 刪除環境,請發出 environments.delete API 要求,並填入環境 ID。

後續步驟

本頁內容對您是否有任何幫助?請提供意見:

傳送您對下列選項的寶貴意見...

這個網頁
Cloud Composer