環境の更新と削除

このページでは、Cloud Composer 環境の更新、削除、詳細の表示方法について説明します。また、環境の Apache Airflow 構成を更新、表示する方法についても説明します。

始める前に

  • 環境を更新または削除するには次の権限が必要になります。

    • composer.environments.update(環境を更新する)
    • composer.environments.delete(環境を削除する)

      詳細については、Cloud Composer のアクセス制御をご覧ください。

  • ほとんどの gcloud composer コマンドにはロケーションが必要です。--location フラグを使用するかデフォルトのロケーションを設定することでロケーションを指定できます。

  • いくつかの Airflow パラメータは Cloud Composer 用に事前構成されていて、変更できません。ノード数、Airflow 構成のオーバーライド、環境変数、ラベル、PyPI パッケージといった Cloud Composer 環境構成は更新できます。

  • Airflow 構成の更新は、更新リクエストを送信してから約 5 分後に、すべての Airflow インスタンス(ワーカー、サーバー、スケジューラ)で有効になります。

制限事項

Cloud Composer は、環境の更新リクエストや削除リクエストの同時実行は受け付けません。環境の更新リクエストや削除リクエストを発行する際は、前の更新リクエストまたは削除リクエストが完了するまで待機する必要があります。

環境の更新

Airflow 構成を含む Cloud Composer 環境を更新するには、次の手順を行います。

Console

  1. Google Cloud Platform で [環境] ページを開きます。

    [環境] ページを開く

  2. 変更する環境の [名前] をクリックします。

  3. 更新するプロパティに対応するタブを選択します。

  4. [編集] をクリックします。

  5. 更新の編集が終わったら、[送信] をクリックします。

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 環境の更新リファレンス ページをご覧ください。

API

Cloud Composer REST API を使用して、Airflow 構成を含む Cloud Composer 環境を更新するには、environments.patch API リクエストを発行します。

デフォルトの Airflow 構成の復元

デフォルトの Airflow 構成の値をすべて復元するには、次のコマンドを実行します。

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

1 つ以上のデフォルトの 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 フラグを指定してください。

環境の詳細の表示

Airflow 構成を含む Cloud Composer 環境の詳細を表示するには、次の手順を行います。

Console

  1. GCP Console で [環境] ページを開きます。

    [環境] ページを開く

  2. 環境の [名前] をクリックします。
  3. 適切なプロパティタブを選択します。

gcloud

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

ここで

  • ENVIRONMENT_NAME は、環境の名前です。
  • LOCATION は、環境が配置される Compute Engine のリージョンです。
  • --format は、Airflow ウェブサーバーの URL に 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 構成を表示するには、環境 ID を入力した environments.get API リクエストを作成します。

マシンタイプのアップグレード

環境の GKE クラスタのマシンタイプを手動でアップグレードするには、新しいマネージド インスタンス グループ テンプレートを作成し、環境の GKE クラスタ内のインスタンスを更新します。

マシンタイプをアップグレードするには、次の手順を行います。

  1. GCP Console で、アップグレードする環境の名前をクリックします。
  2. 現在のインスタンス グループ テンプレートを確認するには、次の手順を行います。
    1. [環境の詳細] ページで、[GKE cluster ID] リンクをクリックします。
    2. [ノードプール] セクションのクラスタのページで、[インスタンス グループ] の名前をメモし、そのリンクをクリックします。
    3. [メンバー] の [インスタンス グループ] ページで、テンプレートのリンクをクリックします。[インスタンス テンプレート] ページが表示されます。
  3. 新しいインスタンス グループ テンプレートを作成するには、次の手順を行います。
    1. [インスタンス テンプレート] ページで、[同様のものを作成] をクリックします。
    2. [インスタンス テンプレートの作成] ページで、新しいテンプレートの名前を指定します。
    3. [マシンタイプ] でマシンタイプを選択し、[作成] をクリックします。新しいテンプレートが [インスタンス テンプレート] ページの一覧に表示されます。
  4. 環境のクラスタ内のインスタンスを更新するには、次の手順を行います。
    1. [Compute Engine]> [インスタンス グループ] ページで、前の手順でメモしておいたインスタンス グループの名前をクリックします。
    2. [ローリング更新] をクリックします。
    3. [テンプレート] で、作成した新しいテンプレートを選択します。
    4. [更新] をクリックします。

環境の削除

Cloud Composer 環境を削除するには、次の手順を行います。

Console

  1. GCP Console で [環境] ページを開きます。

    [環境] ページを開く

  2. 削除する環境の横にあるチェックボックスをオンにします。
  3. [削除] をクリックします。

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 を使用して環境を削除するには、環境 ID を入力した environments.delete API リクエストを作成します。

次のステップ

このページは役立ちましたか?評価をお願いいたします。

フィードバックを送信...