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

このページでは、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

Google Cloud コンソールで、Cloud Data Fusion のページに移動します。
[インスタンス] をクリックし、インスタンス名の横にあるチェックボックスをオンにします。

[インスタンス] に移動
[アップグレード] をクリックします。
最新のパッチリビジョンを選択し、[アップグレード] をクリックします。
Cloud Data Fusion ウェブインターフェースでアップグレードされたインスタンスにアクセスするには、[インスタンスを表示] をクリックします。
アップグレードが正常に完了したことを確認するには、Google Cloud コンソールで [インスタンスの詳細] ページを再読み込みします。[バージョン] フィールドでアップデートを確認します。

注: Cloud Data Fusion ウェブインターフェースの [システム管理者] ページの上部に表示されるバージョン番号には、パッチのリビジョン番号は表示されません。

gcloud

利用可能なパッチリビジョンに更新するには、ローカルターミナルの 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 として渡すことができます。
注: patch_revision 引数の渡しはオプションです。指定しない場合、利用可能な最新のパッチリビジョンが使用されます。

詳細については、gcloud CLI リファレンスをご覧ください。
アップグレードが正常に完了したことを確認する手順は次のとおりです。
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

以前のパッチリビジョンにロールバックするには、ローカルターミナルの 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 リファレンスをご覧ください。
次の手順で、ロールバックが成功したことを確認します。
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
}

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

始める前に

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

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

Console

gcloud

REST API

例

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

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

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

gcloud

REST API

例

次のステップ

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

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

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

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

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

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