AlloyDB Omni RPM オーケストレーターをインストールする

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

RPM オーケストレーターを使用する AlloyDB Omni は、一連の仮想マシン（VM）またはベアメタル サーバーに AlloyDB Omni データベース クラスタをインストール、設定、管理するための自動化プラットフォームを提供します。RPM オーケストレーターを使用する AlloyDB Omni は、専用のコントロール ノードで実行される CLI と Ansible インターフェースを提供します。このインターフェースから、1 つ以上のクラスタをリモートで管理できます。

自動化のニーズに応じて、次の 2 つのオーケストレーター インターフェースから選択できます。

  • AlloyDB Omni オーケストレーター CLI alloydbctl: 自動化にシェル スクリプトを使用する環境におすすめします。
  • AlloyDB Omni オーケストレーター Ansible コレクション: Ansible ベースの自動化を使用する環境におすすめします。

制限事項

このリリースには、次の制限が適用されます。

  • このリリースでは、AlloyDB Omni PostgreSQL 18 のみがサポートされています。
  • このリリースでは、RHEL バージョン 9 と互換性のあるソフトウェア パッケージのみがサポートされています。
  • このリリースでは、Intel x86 64 ビットベースのプラットフォームのみがサポートされています。
  • このリリースでは、メジャー バージョンのアップグレードはサポートされていません。
  • このリリースには、ディザスタ リカバリを設定する手順は含まれていません。
  • このリリースには、読み取りプール インスタンスを設定する手順は含まれていません。
  • AlloyDB Omni モニタは SSL 接続をサポートしていません。モニタリング ダッシュボード サーバーは、AlloyDB Omni ノードと同じプライベート ネットワークにデプロイする必要があります。

始める前に

デプロイを開始する前に、次の要件を満たしていることを確認してください。

AlloyDB Omni パッケージを取得する

RPM オーケストレーターを使用する AlloyDB Omni ソフトウェア パッケージはプレビュー版です。RPM ファイルを受け取るには、RPM オーケストレーターを使用する AlloyDB Omni のプレビュー版の登録フォームから登録する必要があります。

プライベート Yum リポジトリを使用してソフトウェア パッケージを管理する場合は、リポジトリ管理の手順に沿って、依存する RPM ファイルをリポジトリに含めます。詳細については、ソフトウェア パッケージの依存関係をご覧ください。

ソフトウェア リポジトリを設定する

AlloyDB Omni RPM は、グローバル Yum リポジトリで管理されます。または、組織がプライベート Yum リポジトリでソフトウェアを管理している場合は、登録後に提供される RPM パッケージを管理ツールに従ってリポジトリに含める必要があります。デプロイ プロセスでは、プライベート リポジトリの URL が必要になります。

マシンをプロビジョニングする

RHEL 9 を実行する VM のセットをプロビジョニングします。これには次のものが含まれます。

  • コントローラ: デプロイをオーケストレートし、他のすべてのノードにパスワードなしで SSH アクセスできる 1 つのノード。
  • データベース: AlloyDB Omni コアとモニタリング サービスを実行する 1 つまたは 3 つのノード。
  • ロードバランサ: HAProxy と、PgBouncer などのオプションの接続プーラーを実行する 2 つのオプション ノード。

ネットワークとファイアウォールを構成する

アーキテクチャに基づいて、次の TCP ポートを許可するようにファイアウォールを構成します。

ポート プロトコル ノード サービス トラフィック メモ
5432 TCP ロードバランサ HAProxy 受信 該当する場合はロードバランサ ノード上
6432 TCP ロードバランサ PgBouncer 受信 該当する場合は接続プーラー
9187 TCP データベース AlloyDB モニタ 受信 該当する場合はモニタ。TLS はサポートされていません。
5432 TCP データベース AlloyDB 受信 3 ノードの復元力のあるアーキテクチャ
6432 TCP データベース PgBouncer 受信 3 ノードの復元力のあるアーキテクチャで該当する場合は接続プーラー
2380 TCP etcd etcd 受信 etcd ピアツーピア プロトコル用
- VRRP ロードバランサ Keepalived 受信 Keepalived リーダー選出
- VRRP データベース Keepalived 受信 3 ノードの復元力のあるアーキテクチャでの Keepalived リーダー選出
6703 TCP クラスタ マネージャー クラスタ マネージャー 受信 クラスタ マネージャー gRPC ポート
6702 TCP すべてのノード ノード マネージャー 受信 ノード マネージャー gRPC ポート
6700 TCP すべてのノード ノード マネージャー 受信 ノード マネージャー Init gRPC ポート
8086 HTTP すべてのノード ノード マネージャー 受信 プライマリまたはスタンバイを確認するノード マネージャー HTTP ポート
2379 TCP etcd etcd 受信 クラスタ マネージャーが etcd と連携するため
443 HTTPS データベース Cloud Storage 送信 バックアップ データを送信するため

ホスト SELinux モード

AlloyDB Omni は、パーミッシブ モードとエンフォーシング モードの両方で SELinux をサポートしています。

SELinux を有効または無効にするには、すべてのノードで /etc/selinux/config ファイルが更新されていることを確認します。クラスタをブートストラップする前に、すべてのデータベース ノードとロードバランサ ノードで SELinux の設定が一致していることを確認してください。現在の設定を確認するには、getenforce コマンドを使用します。

詳細については、SELinux ポリシーの仕様をご覧ください。

オーケストレーターをインストールする

Ansible

Ansible プレイブックを使用してクラスタを管理する場合は、この方法を使用します。

  1. コントロール ノードに Ansible と必要な Python ライブラリをインストールします。

    # Install EPEL for RHEL 9
sudo dnf install https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm -y
# Install Ansible and dependencies
sudo dnf install ansible
sudo dnf install python3-grpcio python3-protobuf python3-googleapis-common-protos

  2. Ansible コレクション tar ファイルとその署名をダウンロードし、パッケージを確認してインストールします。

    # Download the collection and its signature
wget ALLOYDBOMNI_SERVER/google-alloydbomni_orchestrator-0.1.0-1.tar.gz
wget ALLOYDBOMNI_SERVER/google-alloydbomni_orchestrator-0.1.0-1.tar.gz.asc

# Import the Google Linux signing key
curl -sS https://dl.google.com/linux/linux_signing_key.pub | gpg --import

# Verify the collection tarball
gpg --verify google-alloydbomni_orchestrator-0.1.0-1.tar.gz.asc \
google-alloydbomni_orchestrator-0.1.0-1.tar.gz

# Install the collection
ansible-galaxy collection install google-alloydbomni_orchestrator-0.1.0-1.tar.gz

# Verify the installation
ansible-galaxy collection list | grep alloydbomni_orchestrator

    ALLOYDBOMNI_SERVER は、Ansible コレクション tar ファイルを含む AlloyDB Omni ソフトウェア パッケージがホストされているサーバーの URL に置き換えます。このソースは、RPM オーケストレーターを使用する AlloyDB Omni のプレビュー版に登録した後に提供されます。

alloydbctl

リソースの管理にコマンドライン ユーティリティを使用する場合は、この方法を使用します。

  1. コントロール ノードの /etc/yum.repos.d/alloydbomni_orchestrator.repo に Yum 構成ファイルを作成します。

    [alloydbomni_orchestrator]
name=Google AlloyDB Omni orchestrator packages
baseurl=ALLOYDB_OMNI_ORCHESTRATOR_REPOSITORY_URL
enabled=1
repo_gpgcheck=0
gpgcheck=1
gpgkey=REPO_GPG_KEY

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

    • ALLOYDB_OMNI_ORCHESTRATOR_REPOSITORY_URL: AlloyDB Omni オーケストレーター RPM を含むリポジトリの URL。
    • REPO_GPG_KEY: GNU Privacy Guard（GPG）検証用の Google の公開鍵の場所（例: https://dl.google.com/linux/linux_signing_key.pub）。鍵がファイルにダウンロードされている場合は、パスとして設定することもできます（例: file:///tmp/linux_signing_key.pub）。

  2. パッケージをインストールし、バイナリをシステムの PATH に追加します。

    sudo dnf install alloydbomni_orchestrator
export PATH=$PATH:/usr/local/bin

  3. 次のコマンドを実行して、インストールの内容を確認します。

    alloydbctl --help