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

このページには、Cloud Data Fusion インスタンスのパッチリビジョンを管理するための情報とガイドラインが記載されています。

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

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

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

始める前に

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

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

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

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

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

コンソール

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 インスタンスのパッチ リビジョンへのアップグレード

コンソール

gcloud

REST API

例

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

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

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

gcloud

REST API

例

次のステップ

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

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

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

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

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

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