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 すべてのノード ノード マネージャー 受信 ノード マネージャー初期化 gRPC ポート
8086 HTTP すべてのノード ノード マネージャー 受信 プライマリまたはスタンバイを確認するためのノード マネージャーの HTTP ポート
2379 TCP etcd etcd 受信 Cluster Manager が etcd と連携する
443 HTTPS データベース Cloud Storage 送信 バックアップ データの送信

ホスト SELinux モード

AlloyDB Omni は、permissive モードと自動適用モードの両方で SELinux をサポートしています。

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

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

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

Ansible

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

  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