AlloyDB for PostgreSQL の最新アップデートをできるだけ早くクラスタに適用する必要がある場合は、セルフサービス メンテナンスを実行できます。最新バージョンに更新すると、AlloyDB の新機能を利用できるようになり、パッチが適用されます。また、拒否期間を設定して、重要な期間中の中断を防ぐことができます。
詳細については、メンテナンスの概要をご覧ください。
セルフ メンテナンスのユースケース
AlloyDB は通常、ユーザーに代わってクラスタにメンテナンスを適用し、メンテナンス オペレーションを実行してクラスタ内のデータベース ソフトウェアをアップグレードします。デフォルトでは、AlloyDB は各地域の営業時間外にメンテナンスを実行します。必要に応じて、メンテナンスの時間枠を設定すると、希望する定期メンテナンス時間を定義し、今後の定期メンテナンスについて通知を受け取ることができます。特定のリリースと PostgreSQL バージョンの場合、メンテナンスの時間枠が設定されていないクラスタでメンテナンスを完了してから、メンテナンスの時間枠が設定されているクラスタでスケジュールされます。
セルフサービス メンテナンスを実行する理由としては、次のようなものがあります。
- クラスタでメンテナンスがスキップされた。これは、拒否期間を設定した場合、または移行中にクラスタがブートストラップ状態だった場合に発生します。
- 定期メンテナンスの前にクラスタの更新が必要である。
- 最新の状態ではないクラスタに拒否期間を設定する必要がある。以前のバージョンのインスタンスを含むクラスタでは、拒否期間の設定がサポートされない場合があります。
- カスタマイズされた頻度または不定期な頻度でメンテナンスを実行する必要がある。この場合は、拒否期間を設定し、必要なタイミングでセルフサービス メンテナンスを実行できます。拒否期間によってセルフサービス メンテナンスがブロックされることはありません。
更新中のリソース粒度
AlloyDB はクラスタレベルでのメンテナンスのみをサポートしています。クラスタ内で、AlloyDB はインスタンスの更新順序を決定します。AlloyDB は各インスタンスのメンテナンスを個別に試行して完了するため、インスタンスによってリリースが異なる可能性があります。たとえば、クラスタで拒否期間が設定されているため既存のインスタンスのメンテナンスをスキップし、その後で最新バージョンのインスタンスを作成する場合があります。
利用可能な最新バージョンを表示する
最新バージョンについては、AlloyDB のメンテナンス変更履歴をご覧ください。変更履歴は、すべてのリージョンのクラスタにメンテナンスが適用された後に更新されます。最新バージョンがリージョンに適用される方法については、最新バージョンをご覧ください。
インスタンスの現在のバージョンを表示する
gcloud CLI を使用するには、Google Cloud CLI をインストールして初期化するか、Cloud Shell を使用します。
バージョンの表示は、インスタンス レベルでのみサポートされています。
インスタンスの現在のメンテナンス バージョンを表示するには、
gcloud alloydb instances describeコマンドを実行します。gcloud alloydb instances describe INSTANCE_ID \ --cluster CLUSTER_ID \ --region LOCATION_ID次のように置き換えます。
INSTANCE_ID: バージョンを表示するインスタンスの ID。CLUSTER_ID: インスタンスが配置されているクラスタの ID。LOCATION_ID: このクラスタが配置されている Google Cloud リージョン。例:us-central1
レスポンスで
maintenanceVersionNameフィールドを見つけて、インスタンスが実行しているバージョンを確認します。次に例を示します。"maintenanceVersionName": "POSTGRES_16.20251015.04_00"
クラスタを利用可能な最新バージョンに更新する
gcloud
gcloud CLI を使用するには、Google Cloud CLI をインストールして初期化するか、Cloud Shell を使用します。
クラスタを最新バージョンに更新するには、maintenance-version フラグを指定して gcloud alloydb clusters update コマンドを実行します。
gcloud alloydb clusters update CLUSTER_ID \
--region LOCATION_ID \
--maintenance-version=latest次のように置き換えます。
CLUSTER_ID: 最新バージョンに更新するクラスタの ID。LOCATION_ID: このクラスタが配置されている Google Cloud リージョン。例:us-central1
レスポンスの例:
Operation ID: operation-1746645915198-63490b152e3c8-2aed1bd1-3fd73867
Updating cluster...done.
REST v1
この例では、このクラスタを最新バージョンに更新します。この呼び出しのパラメータの完全なリストについては、メソッド: projects.locations.clusters.patch をご覧ください。
リクエストのデータを使用する前に、次のように置き換えます。
CLUSTER_ID: 最新バージョンに更新するクラスタ。PROJECT_ID: クラスタが配置されているプロジェクトの ID。LOCATION_ID: このクラスタが配置されている Google Cloud リージョン。例:us-central1
クラスタを最新バージョンに更新するには、次の PATCH リクエストを使用します。
PATCH https://alloydb.googleapis.com/v1/{cluster.name=projects/PROJECT_ID/locations/LOCATION_ID/clusters/CLUSTER_ID?update_mask=maintenance_version_selection_policy}
maintenance_version_selection_policy クエリ パラメータは、クラスタのインスタンスを更新するバージョンを指定します。
リクエストの JSON 本文は次のようになります。
{
"maintenanceVersionSelectionPolicy": "MAINTENANCE_VERSION_SELECTION_POLICY_LATEST",
}