このページには、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 コンソールで [インスタンスの詳細] ページを再読み込みします。[バージョン] フィールドで更新を確認します。
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 として渡すことができます。
詳細については、gcloud CLI リファレンスをご覧ください。
次の手順に沿って、アップグレードが成功したことを確認します。
ローカル ターミナルの Cloud Shell セッションから次の gcloud CLI コマンドを実行して、インスタンスの詳細を取得します。
gcloud beta data-fusion instances describe \ --project=PROJECT_ID \ --location=LOCATION_NAME \ INSTANCE_ID
インスタンスの詳細の
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 リファレンスをご覧ください。
次の手順に沿って、ロールバックが成功したことを確認します。
ローカル ターミナルの Cloud Shell セッションから次の gcloud CLI コマンドを実行して、インスタンスの詳細を取得します。
gcloud beta data-fusion instances describe \ --project=PROJECT_ID \ --location=LOCATION_NAME \ INSTANCE_ID
インスタンスの詳細の
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 でのバージョニングについて学習する。
- 利用可能なバージョンとパッチ リビジョンのアップグレードを確認する。
- アップグレードのトラブルシューティング。