AlloyDB Omni Kubernetes Operator の最新バージョンに移行する

このページでは、AlloyDB Omni オペレーターのバージョン 1.0.0 からバージョン 1.1.0 へのアップグレード手順について説明します。

Kubernetes で AlloyDB Omni をアップグレードする手順は、実行している AlloyDB Omni のバージョンと、アップグレード先のバージョンによって異なります。

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

Kubernetes

データベース クラスタで使用されている 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 Operator のバージョン 1.0.0 以降を実行している場合、このコマンドはデータベース クラスタで使用されている AlloyDB Omni のバージョンを出力します。

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

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

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

1.0.0 より前のバージョンの AlloyDB Omni Operator を実行している場合は、1.0.0 より前の AlloyDB Omni Operator からアップグレードするの手順に沿って操作します。

そうでない場合は、ターゲット バージョン番号を確認するに進みます。

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

Kubernetes

AlloyDB Omni Operator のバージョンが 1.0.0 以降の場合は、アップグレード先の AlloyDB Omni のバージョンによって次の手順が異なります。これには、AlloyDB Omni のバージョン番号を理解する必要があります。

AlloyDB Omni のバージョン番号は、次のコンポーネントで構成されています。

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

たとえば、AlloyDB Omni バージョン 15.5.5 は、PostgreSQL バージョン 15.5 をサポートする AlloyDB Omni のパッチ バージョン 5 です。

新しいバージョンの PostgreSQL をサポートする AlloyDB Omni のバージョンにアップグレードする場合は、データベース クラスタとともに AlloyDB Omni オペレーター自体をアップグレードする必要があります。特定の PostgreSQL マイナー バージョンをサポートする AlloyDB Omni リリースの各セットには、独自の AlloyDB Omni Operator バージョン番号があります。これは、AlloyDB Omni バージョンのリリースノートで確認できます。

AlloyDB Omni の新しいパッチ バージョンにのみアップグレードする場合は、データベース クラスタのみをアップグレードできます。AlloyDB Omni オペレーター自体をアップグレードする必要はありません。

それ以外の場合は、AlloyDB Omni オペレーターをアップグレードするセクションに進みます。

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

Kubernetes

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 Operator のバージョンに置き換えます（1.1.0 など）。

  2. 最新の AlloyDB Omni オペレーター バイナリをダウンロードします。

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

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

    kubectl apply -f alloydbomni-operator/crds

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

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

AlloyDB Omni Operator のアップグレードが完了したら、インプレース アップグレードを実行するの手順に沿って新しいデータベース クラスタを作成します。

AlloyDB Omni クラスタが AlloyDB Omni Operator 1.0.0 で作成された場合は、クラスタをバージョン 15.5.5 にアップグレードする前に、マニフェストに controlPlaneAgentsVersion フィールドを追加して 1.1.0 に設定します。そうでない場合は、次のエラーが表示されます。

admission webhook "vdbcluster.alloydbomni.dbadmin.goog" denied the request: unsupported database version 15.5.5 and/or control plane agents version 1.0.0

controlPlaneAgentsVersion フィールドを含むマニフェストの例を次に示します。

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