このページでは、RPM オーケストレータ のデプロイオプションを使用して AlloyDB Omni バージョン 18.3.0 について説明します。別のデプロイオプションを選択してください。

Google は AI 技術を使用して、コンテンツをご希望の言語に翻訳しています。AI 翻訳には誤りが含まれる場合があります。

RPM オーケストレータークラスタコンポーネントを更新する

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

このページでは、Red Hat Enterprise Linux（RHEL）環境で AlloyDB Omni データベースクラスタのソフトウェアパッケージ、リソース構成、RPM オーケストレーターを更新する方法について説明します。

始める前に

すべてのノードとクラスタコンポーネントの詳細を含む Deployment の仕様ファイル deployment_spec.yaml があることを確認します。

オーケストレーターをアップグレードする

オーケストレーターはデータベースクラスタを管理します。他のクラスタコンポーネントをアップグレードする前に、コントロールノードのオーケストレーターをアップグレードする必要があります。

Ansible

Ansible プレイブックを使用してインフラストラクチャを管理する場合は、次の手順を完了します。

次のコマンドを実行して、コントロールノードにインストールされている google.alloydbomni_orchestrator コレクションのバージョンを確認します。
```
ansible-galaxy collection list | grep alloydbomni_orchestrator
```
既存のバージョンを上書きするには、コレクション tar ファイルの最新の安定版リリースをダウンロードして、強制インストールを実行します。
```
ansible-galaxy collection install --force google-alloydbomni_orchestrator-NEW_VERSION.tar.gz
```
NEW_VERSION は、新しいコレクションのバージョンに置き換えます。

alloydbctl

alloydbctl コマンドラインツールを使用する場合は、次の手順を完了します。

コントロールノードにインストールされている RPM オーケストレーター alloydbomni_orchestrator のパッケージバージョンを確認するには、次のコマンドを実行します。
```
rpm -q alloydbomni_orchestrator
```
パッケージマネージャーを使用して、コントロールノードのソフトウェアパッケージをアップグレードします。
```
sudo dnf upgrade alloydbomni_orchestrator
```

Ansible を使用してクラスタコンポーネントを更新する

提供されている Ansible ロールを使用して更新することをおすすめします。

オーケストレーターコレクションの update ロールを参照する update.yaml という名前のハンドブックを作成します。update_action パラメータの値を update_rpm に設定する必要があります。

デフォルトでは、update ロールはコントロールプレーンとデータプレーンの両方を更新します。コントロールプレーンまたはデータプレーンのコンポーネントのみを更新するには、他のプレーンのパラメータを false に設定します。
```
---
- hosts: all
  become: true
  vars:
    update_action: "update_rpm"
    ansible_user: SSH_USER
    ansible_ssh_private_key_file: PRIVATE_KEY_PATH
    update_control_plane: true # Optional argument if you want to only update data plane components
    update_data_plane: true # Optional argument if you want to only update control plane components
  roles:
    - role: google.alloydbomni_orchestrator.update
```
次のように置き換えます。
- SSH_USER: クラスタノードにアクセスできる SSH ユーザー名。
- PRIVATE_KEY_PATH: SSH 認証鍵ファイルのパス。
- update_action: 更新のスコープ。この値を update_rpm に設定します。
- update_control_plane: 省略可。データプレーンコンポーネントのみを更新するには、false に設定します。デフォルトは true です。
- update_data_plane: 省略可。コントロールプレーンコンポーネントのみを更新するには、false に設定します。デフォルトは true です。
指定されたすべてのノードで更新を実行するには、インベントリファイルを使用してハンドブックを実行します。
```
ansible-playbook -i DEPLOYMENT_SPEC update.yaml
```
DEPLOYMENT_SPEC は、デプロイ仕様ファイルのパスに置き換えます。

Deployment の仕様ファイルで、クラスタ内の各コンポーネントのインストール済みバージョンが定義されていることを確認します。更新ロールは、インベントリファイルでバージョンを構成する方法に基づいてコンポーネントを更新します。
- コンポーネントのバージョンがインストールされているバージョンと一致する場合、更新ロールはそのコンポーネントを変更しません。
- コンポーネントのバージョンを特定のターゲットバージョンに変更すると、コンポーネントはそのバージョンに更新されます。
- コンポーネントのバージョンフィールドを空のままにすると、構成されたリポジトリで使用可能な最新バージョンにコンポーネントが更新されます。

注: Ansible によってトリガーされたオーケストレーションプロセス中にパッケージの更新が失敗した場合、AlloyDB Omni オーケストレーターの Ansible ロールは、組み込みのトランザクション整合性を使用して復元します。Ansible ロールは、更新を実行する前に、既存のパッケージバージョンを自動的にキャプチャします。更新に失敗すると、Ansible ロールのブロック構造とレスキュー構造により、以前にインストールされたパッケージバージョンに自動的にダウングレードされます。高可用性（HA）トポロジでは、この復元プロセスは、スタンバイが失敗した場合はプライマリノードを慎重にバイパスし、プライマリノードが失敗した場合は HA スイッチオーバーを実行します。これにより、クラスタの安定性を維持し、ダウンタイムを回避できます。

クラスタコンポーネントを手動で更新する

Ansible オーケストレーターを使用していない場合や、更新プロセスをきめ細かく制御する場合は、クラスタ内の各ノードの RPM コンポーネントを手動で更新できます。ソフトウェアアップデートは、スケジュールされたメンテナンスの時間枠内に行うことをおすすめします。

手動更新プロセスでは、次の 2 つのプレーンを更新します。

コントロールプレーン（RPM オーケストレーターコンポーネント）: コントロールプレーンは、データベースクラスタを制御および管理するレイヤです。RPM デプロイでは、コントロールプレーンに cluster_manager、node_manager、etcd が含まれます。
データプレーン（データベースクラスタ）: データプレーンには、AlloyDB Omni データベースエンジン自体（monitor）や、pgBackRest、PgBouncer、keepalived、HAProxy などのサービスを含むデータベースクラスタコンポーネントが含まれています。データプレーンをアップグレードすると、データベースバージョンの更新、セキュリティパッチ、パフォーマンスの改善がデータベースクラスタに直接適用されます。

リファレンスアーキテクチャに関係なく、コントロールプレーンを更新する手順は同じです。データプレーンを更新する前に、コントロールプレーンコンポーネントを更新する必要があります。データプレーンを更新する手順は、データベースのデプロイアーキテクチャによって異なります。

サービスまたはパッケージを更新する手順は次のとおりです。

サービスを停止します。
```
sudo systemctl stop SERVICE
```
次のいずれかのコマンドを使用してパッケージをアップグレードします。
- 利用可能な最新バージョンに更新するには:
```
sudo dnf upgrade PACKAGE
```
- 特定のバージョンに更新するには:
```
sudo dnf upgrade PACKAGE-VERSION
```
サービスを起動します。
```
sudo systemctl start SERVICE
```

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

SERVICE: 停止して開始するサービスの名前（例: pgbouncer、keepalived）。
PACKAGE: 更新するパッケージの名前（例: pgbouncer、alloydbomni18）。
VERSION: インストールするターゲットパッケージのバージョン（18.3.0 や 18.3.0-2.rhel9 など）。

コントロールプレーンを手動で更新する

コントロールプレーンを更新するには、指定されたノードで次の操作を行います。

すべてのクラスタマネージャーノードでクラスタマネージャーを停止するには、次のコマンドを実行します。

注: 他のコントロールプレーンコンポーネントを更新する前に、すべてのクラスタマネージャーノードでクラスタマネージャーを停止します。
```
sudo systemctl stop alloydbomni_cluster_manager
```
すべての DCS ノードで etcd を更新するには、次のコマンドを順番に実行します。
```
sudo systemctl stop etcd
sudo dnf upgrade etcd
sudo systemctl start etcd
```

すべてのノードでノードマネージャーを更新するには、次のコマンドを順番に実行します。

sudo systemctl stop alloydbomni_node_manager
sudo dnf upgrade alloydbomni_node_manager
sudo systemctl start alloydbomni_node_manager

コントロールプレーンコンポーネントを更新したら、すべてのクラスタマネージャーノードでクラスタマネージャーを更新し、必要に応じて再起動できます。
```
sudo dnf upgrade alloydbomni_cluster_manager
sudo systemctl start alloydbomni_cluster_manager
```

データプレーンを手動で更新する

データプレーンを更新するには、デプロイアーキテクチャに指定された順序でデータベースとヘルパーサービスを更新します。各サービスについて、サービスの停止、パッケージのアップグレード、サービスの起動という厳密な順序で操作する必要があります。

リファレンスアーキテクチャに応じて、デプロイの手順に沿って操作します。

alloydbctl get コマンドを使用してクラスタのステータスを取得し、出力形式を YAML に設定します。
```
alloydbctl get -d DEPLOYMENT_SPEC -t RESOURCE_TYPE -n CLUSTER_NAME -o yaml
```
次のように置き換えます。
- RESOURCE_TYPE: 検査するリソースタイプ（例: DBCluster）。
- CLUSTER_NAME: データベースクラスタの名前。
- DEPLOYMENT_SPEC: Deployment 仕様ファイルのパス。
YAML 出力で、status セクションの instanceList をメモします。

ロールが Primary に設定されているノードを見つけます。他のすべてのデータベースノードはスタンバイノードです。
最初にスタンバイノードで実行されているすべてのデータプレーンコンポーネントを更新し、次にプライマリノードでそれらのコンポーネントを更新します。各ノードのデータプレーンコンポーネントを更新する手順は次のとおりです。
1. AlloyDB Omni を更新するには、次のコマンドを順番に実行します。
```
sudo systemctl stop alloydbomni18
sudo dnf upgrade alloydbomni18
sudo systemctl start alloydbomni18
```
  注: アクティブなプライマリノードを安全にステップダウンするには、切り替えを実行します。詳細については、スイッチオーバーを実行するをご覧ください。
2. モニターを更新するには、次のコマンドを順番に実行します。
```
sudo systemctl stop alloydbomni_monitor
sudo dnf upgrade alloydbomni_monitor
sudo systemctl start alloydbomni_monitor
```
3. pgBackRest を更新するには、次のコマンドを順番に実行します。
```
sudo dnf upgrade pgbackrest
```
4. PgBouncer を更新するには、次のコマンドを順番に実行します。
```
sudo systemctl stop pgbouncer
sudo dnf upgrade pgbouncer
sudo systemctl start pgbouncer
```
5. keepalived を更新するには、次のコマンドを順番に実行します。
```
sudo systemctl stop keepalived
sudo dnf upgrade keepalived
sudo systemctl start keepalived
```
  注: リファレンスアーキテクチャにロードバランサが含まれている場合、keepalived と pgbouncer はロードバランサノードで実行されます。これらのコンポーネントを最初にスタンバイロードバランサノードで更新し、次にプライマリロードバランサノードで更新します。
6. HAProxy を更新するには、次のコマンドを順番に実行します。
```
sudo systemctl stop haproxy
sudo dnf upgrade haproxy
sudo systemctl start haproxy
```