AlloyDB Omni Kubernetes オペレーターの最新バージョンに移行する

このページでは、AlloyDB Omni オペレーターをアップグレードする方法について説明します。Kubernetes で AlloyDB Omni をアップグレードする手順は、現在の AlloyDB Omni のバージョンとアップグレード先のバージョンによって異なります。

現在のバージョンを確認する

データベース クラスタで使用されている AlloyDB Omni のバージョンを確認するには、次のコマンドを実行します。

kubectl get dbclusters.alloydbomni.dbadmin.goog DB_CLUSTER_NAME -n NAMESPACE -o jsonpath='{.status.primary.currentDatabaseVersion}'

次のように置き換えます。

  • DB_CLUSTER_NAME: データベース クラスタの名前。これは、作成時に宣言したデータベース クラスタ名と同じです。

  • NAMESPACE: データベース クラスタの Kubernetes Namespace。

AlloyDB Omni オペレーターのバージョン 1.0.0 以降を実行している場合、このコマンドはデータベース クラスタで使用されている AlloyDB Omni のバージョンを出力します。

Kubernetes クラスタにインストールされている AlloyDB Omni オペレーターのバージョンを確認するには、次のコマンドを実行します。

kubectl get dbclusters.alloydbomni.dbadmin.goog DB_CLUSTER_NAME -n NAMESPACE -o jsonpath='{.status.primary.currentControlPlaneAgentsVersion}'

AlloyDB Omni オペレーターのバージョン 1.0.0 以降を実行している場合、出力は Kubernetes クラスタで実行されている AlloyDB Omni オペレーターのバージョン番号です。

1.0.0 より前のバージョンの AlloyDB Omni オペレーターを実行している場合は、1.0.0 より前の AlloyDB Omni オペレーターからアップグレードするの手順に沿って操作します。そうでない場合は、ターゲット バージョン番号を確認するに進みます。

ターゲット バージョン番号を確認する

AlloyDB Omni オペレーターのバージョン 1.0.0 以降を実行している場合、次の手順は、アップグレード先の AlloyDB Omni のバージョンによって異なります。AlloyDB Omni のバージョン番号には、次のコンポーネントが含まれます。

  • PostgreSQL との互換性のメジャー バージョン番号
  • PostgreSQL との互換性のマイナー バージョン番号
  • この AlloyDB Omni リリースのパッチ バージョン番号

たとえば、AlloyDB Omni バージョン 15.7.0 は PostgreSQL バージョン 15.7 をサポートしていますが、AlloyDB Omni リリース パッチはありません。

ターゲット バージョンに適したインストール オプションを選択します。

設置シナリオ 手順を更新する
新しいバージョンの PostgreSQL をサポートする AlloyDB Omni のバージョンにアップグレードする。 AlloyDB Omni オペレーターとデータベース クラスタをアップグレードします。特定の PostgreSQL マイナー バージョンをサポートする AlloyDB Omni リリースの各セットには、独自の AlloyDB Omni オペレーター バージョン番号があります。これは、AlloyDB Omni バージョンのリリースノートで確認できます。AlloyDB Omni オペレーター バージョンの互換性表を使用して、AlloyDB Omni オペレーター バージョンがオペレーター バージョンと互換性があることを確認します。
AlloyDB Omni の新しいパッチ バージョンにのみアップグレードする場合。 データベース クラスタのみをアップグレードします。アップグレードする前に、AlloyDB Omni オペレーターのバージョンの互換性表とリリースノートを確認し、AlloyDB Omni オペレーターの更新も必要かどうかを判断します。
その他のすべてのシナリオ AlloyDB Omni オペレーターをアップグレードするの手順に沿って操作します。

AlloyDB Omni オペレーターをアップグレードする

AlloyDB Omni オペレーターをアップグレードする手順は次のとおりです。

  1. 環境変数を定義します。

    export GCS_BUCKET=alloydb-omni-operator
export OPERATOR_VERSION=OPERATOR_VERSION
export HELM_PATH=$OPERATOR_VERSION/alloydbomni-operator-$OPERATOR_VERSION.tgz

    OPERATOR_VERSION は、アップグレード先の AlloyDB Omni オペレーターのバージョンに置き換えます（例: 1.2.0）。

  2. 最新の AlloyDB Omni オペレーター ファイルをダウンロードします。

    gsutil cp -r gs://$GCS_BUCKET/$HELM_PATH ./
tar -xvzf alloydbomni-operator-${OPERATOR_VERSION}.tgz

  3. 最新の AlloyDB Omni オペレーター カスタム リソース定義を適用します。

    kubectl apply -f alloydbomni-operator/crds

  4. AlloyDB Omni オペレーターの Helm チャートをアップグレードします。

    helm upgrade alloydbomni-operator alloydbomni-operator-${OPERATOR_VERSION}.tgz \
--namespace alloydb-omni-system \
--atomic \
--timeout 5m

    dbCluster を更新するには、マニフェスト ファイルで databaseVersion と controlPlaneAgentsVersion のバージョンを更新する必要があります。次のコードは、databaseVersion のバージョン 15.7.0 と controlPlaneAgentsVersion のバージョン 1.2.0 を指定するマニフェスト ファイルの一部です。

    apiVersion: alloydbomni.dbadmin.goog/v1
kind: DBCluster
metadata:
name: DB_CLUSTER_NAME
spec:
databaseVersion: "15.7.0"
controlPlaneAgentsVersion: "1.2.0"
...