インスタンスのパッチ リビジョンを管理する

このページでは、Cloud Data Fusion インスタンスのパッチ リビジョンを管理するための情報とガイドラインについて説明します。

パッチ リビジョンと他のアップグレードの違いについては、インスタンスのアップグレードとパッチ リビジョンの比較をご覧ください。

パッチ リビジョンには、インスタンスの重要なセキュリティ アップデートとバグの修正が含まれています。パッチ リビジョンは、パイプラインやプラグインを変更せずに、プラットフォームにのみ修正を適用します。アップグレード プロセスには、インスタンスとパイプラインのダウンタイムが含まれます。

Cloud Data Fusion のバージョニングの詳細については、Cloud Data Fusion のバージョニングと利用可能なパッチ リビジョンのアップグレードをご覧ください。

始める前に

  • パッチ リビジョンにアップグレードする前に、リリースノートで、含まれている特定の修正に関する情報を確認します。これらの変更がインスタンスに与える影響を理解することが重要です。
  • 環境を準備します。
    • パッチ リビジョンのダウンタイムをスケジュールします。
    • 推奨: アップグレード前に、実行中のパイプラインを停止し、Cloud Composer トリガーなどのアップストリーム トリガーを無効にします。 アップグレードが開始すると、実行中のパイプラインはすべて停止します。

インスタンスのアップグレードとパッチ リビジョンの比較

インスタンスのアップグレード
これらのバージョンには、プラットフォームの最新機能、機能の強化、パフォーマンスの改善が含まれています。インスタンスのアップグレードはプラグインの変更に関連付けられており、パイプラインのアップグレードが必要です。詳細については、バージョン アップグレード: インスタンスとパイプラインをご覧ください。
パッチ リビジョン
これらのバージョンには、プラットフォームの重要なセキュリティとバグの修正のみが含まれ、パイプラインとプラグインの機能は変更または更新されません。

Cloud Data Fusion インスタンスのパッチ リビジョンへのアップグレード

Cloud Data Fusion インスタンスのパッチ リビジョンにアップグレードするには、 Google Cloud コンソール、Google Cloud CLI、または REST API で次の手順を行います。

Console

  1. Google Cloud コンソールで、Cloud Data Fusion のページに移動します。

  2. [インスタンス] をクリックし、インスタンス名の横にあるチェックボックスをオンにします。

    [インスタンス] に移動

  3. [アップグレード] をクリックします。

  4. 最新のパッチ リビジョンを選択し、[アップグレード] をクリックします。

  5. Cloud Data Fusion ウェブ インターフェースでアップグレードされたインスタンスにアクセスするには、[インスタンスを表示] をクリックします。

  6. アップグレードが正常に完了したことを確認するには、 Google Cloud コンソールで [インスタンスの詳細] ページを再読み込みします。[バージョン] フィールドでアップデートを確認します。

gcloud

  1. 利用可能なパッチ リビジョンに更新するには、ローカル ターミナルの Cloud Shell セッションから次の gcloud CLI コマンドを実行します。

    gcloud beta data-fusion instances update INSTANCE_ID \
  --project=PROJECT_ID \
  --location=LOCATION_NAME \
  --version=CURRENT_INSTANCE_VERSION \
  --patch_revision=AVAILABLE_PATCH_REVISION

    以下を置き換えます。

    • INSTANCE_ID: インスタンスの名前。
    • PROJECT_ID: Cloud Data Fusion インスタンスを含むプロジェクトの ID。
    • LOCATION_NAME: インスタンスのロケーション。
    • CURRENT_INSTANCE_VERSION: 現在のバージョン。

    • AVAILABLE_PATCH_REVISION: アップグレード先のパッチ リビジョン。

    • 省略可: インスタンスに該当する場合は、--enable_stackdriver_logging 、 --enable_stackdriver_monitoring 、--labelsフラグを追加します。

    • 省略可: enable.unrecoverable.reset などの CDAP プロパティを --options として渡すことができます。

    詳細については、gcloud CLI リファレンスをご覧ください。

  2. アップグレードが正常に完了したことを確認する手順は次のとおりです。

    1. ローカル ターミナルの Cloud Shell セッションから次の gcloud CLI コマンドを実行して、インスタンスの詳細を取得します。

      gcloud beta data-fusion instances describe \
  --project=PROJECT_ID \
  --location=LOCATION_NAME \
  INSTANCE_ID

    2. インスタンスの詳細の PATCH_REVISION フィールドが指定されたバージョンに更新されていることを確認します。

REST API

Cloud Data Fusion インスタンスのパッチ リビジョンを実行するには、patch() メソッドを呼び出します。リクエストの patchRevision オプション フィールドを設定します。パッチ リビジョンを指定しない場合は、利用可能な最新のリビジョンが使用されます。

例

次の例は、REST API を使用してインスタンスをパッチ リビジョンにアップグレードする方法を示しています。

インスタンスを特定のパッチ リビジョン バージョンにアップグレードする

patch() メソッドを呼び出します。

PATCH https://datafusion.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_NAME/instances/INSTANCE_ID

以下を置き換えます。

  • PROJECT_ID: Cloud Data Fusion インスタンスを含むプロジェクトの ID。
  • LOCATION_NAME: インスタンスのロケーション。
  • INSTANCE_ID: インスタンスの名前。

次の JSON リクエスト本文を使用します。

{
  "version": VERSION_NUMBER,
  "patchRevision": PATCH_REVISION_NUMBER
}

以下を置き換えます。

  • VERSION_NUMBER: インスタンスのバージョン（6.7.3 など）。
  • PATCH_REVISION_NUMBER: アップグレード先のパッチ リビジョンのバージョン（6.7.3.1 など）。利用可能なパッチ リビジョンをご覧ください。

たとえば、6.7.3 バージョン インスタンスを 6.7.3.1 パッチ リビジョンにアップグレードするには、次の JSON リクエスト本文を使用します。

{
  "version": 6.7.3,
  "patchRevision": 6.7.3.1
}

インスタンスをデフォルトのパッチ リビジョン バージョンにアップグレードする

patch() メソッドを呼び出します。

PATCH https://datafusion.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_NAME/instances/INSTANCE_ID

次の JSON リクエスト本文を使用します。

{
  "version": VERSION_NUMBER
}

VERSION_NUMBER は、インスタンスのバージョン（6.7.3 など）に置き換えます。

{
  "version": 6.7.3
}

パッチ リビジョンをロールバックする

パッチ リビジョンを組み込んだ後に予期しない問題が発生した場合は、次の手順でパッチ リビジョンを以前の安定した状態に戻します。

gcloud

  1. 以前のパッチ リビジョンにロールバックするには、ローカル ターミナルの Cloud Shell セッションから次の gcloud CLI コマンドを実行します。

    gcloud beta data-fusion instances update INSTANCE_ID \
  --project=PROJECT_ID \
  --location=LOCATION_NAME \
  --version=CURRENT_INSTANCE_VERSION \
  --patch_revision=STABLE_PATCH_REVISION

    以下を置き換えます。

    • INSTANCE_ID: インスタンスの名前。
    • PROJECT_ID: Cloud Data Fusion インスタンスを含むプロジェクトの ID。
    • LOCATION_NAME: インスタンスのロケーション。
    • CURRENT_INSTANCE_VERSION: 現在のバージョン。

    • STABLE_PATCH_REVISION: ロールバック先のパッチ リビジョン。

    • 省略可: インスタンスに該当する場合は、--enable_stackdriver_logging 、 --enable_stackdriver_monitoring 、--labelsフラグを追加します。

    • 省略可: enable.unrecoverable.reset などの CDAP プロパティを --options として渡すことができます。

    詳細については、gcloud CLI リファレンスをご覧ください。

  2. ロールバックが成功したことを確認する手順は次のとおりです。

    1. ローカル ターミナルの Cloud Shell セッションから次の gcloud CLI コマンドを実行して、インスタンスの詳細を取得します。

      gcloud beta data-fusion instances describe \
  --project=PROJECT_ID \
  --location=LOCATION_NAME \
  INSTANCE_ID

    2. インスタンスの詳細の PATCH_REVISION フィールドが指定されたバージョンに戻っていることを確認します。

REST API

Cloud Data Fusion インスタンスでパッチ リビジョンをロールバックするには、patch() メソッドを呼び出します。リクエストの patchRevision フィールドを、以前の安定したパッチ リビジョンに設定します。

例

この例では、REST API を使用して 6.7.3.1 パッチ リビジョンから 6.7.3 パッチ リビジョンにインスタンスをロールバックする方法を示しています。

patch() メソッドを呼び出します。

PATCH https://datafusion.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_NAME/instances/INSTANCE_ID

以下を置き換えます。

  • PROJECT_ID: Cloud Data Fusion インスタンスを含むプロジェクトの ID。
  • LOCATION_NAME: インスタンスのロケーション。
  • INSTANCE_ID: インスタンスの名前。

次の JSON リクエスト本文を使用します。

{
  "version": VERSION_NUMBER,
  "patchRevision": STABLE_PATCH_REVISION
}

以下を置き換えます。

  • VERSION_NUMBER: インスタンスのバージョン（6.7.3 など）。
  • STABLE_PATCH_REVISION: ロールバック先のパッチ リビジョン。利用可能なパッチ リビジョンをご覧ください。

たとえば、インスタンスを 6.7.3.1 パッチ リビジョンから 6.7.3 パッチ リビジョンにロールバックするには、次の JSON リクエスト本文を使用します。

{
  "version": 6.7.3,
  "patchRevision": 6.7.3
}

次のステップ