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

ドキュメントのバージョンを選択してください。

このページでは、AlloyDB Omni Operator をアップグレードする方法について説明します。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 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 からアップグレードするの手順を実施します。それ以外の場合は、ターゲット バージョン番号を確認するに進みます。

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

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

AlloyDB Omni Operator をアップグレードする

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

  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.3.0 など）。

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

    gcloud storage 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

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

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