安裝 AlloyDB Omni RPM 編排器

選取文件版本：

使用 RPM Orchestrator 的 AlloyDB Omni 提供自動化平台，可在虛擬機器 (VM) 或裸機伺服器上安裝、設定及管理 AlloyDB Omni 資料庫叢集。使用 RPM 自動調度管理工具的 AlloyDB Omni 提供 CLI 和 Ansible 介面，可在專用控制節點上執行，從中遠端管理一或多個叢集。

您可以根據自動化需求，選擇下列其中一種自動化調度管理工具介面：

  • 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 軟體套件目前為預先發布版。您必須使用 AlloyDB Omni 使用 RPM 自動調度管理工具預先發布版註冊表單註冊，才能收到 RPM 檔案。

如果您透過私人 Yum 存放區管理軟體套件，請按照存放區管理的操作說明，將依附的 RPM 檔案納入存放區。詳情請參閱「軟體套件依附元件」。

設定軟體存放區

AlloyDB Omni RPM 會在全域 Yum 存放區中維護。或者，如果貴機構透過私人 Yum 存放區管理軟體，則必須根據管理工具，將註冊後提供的 RPM 套件納入存放區。部署期間，您需要提供私人存放區網址。

佈建機器

佈建一組執行 RHEL 9 的 VM，包括：

  • 控制器：1 個節點，負責安排部署作業，並可透過無密碼 SSH 存取所有其他節點。
  • 資料庫：1 或 3 個節點，執行 AlloyDB Omni 核心和監控服務。
  • 負載平衡器：2 個選用節點，可執行 HAProxy 和選用的連線集區，例如 PgBouncer。

設定網路和防火牆

請根據您的架構設定防火牆，允許下列 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 所有節點 Node Manager 連入 Node Manager gRPC 通訊埠
6700 TCP 所有節點 Node Manager 連入 Node Manager Init gRPC 通訊埠
8086 HTTP 所有節點 Node Manager 連入 用於檢查主要或待命節點的 Node Manager 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 替換為託管 AlloyDB Omni 軟體套件 (包括 Ansible 集合 tar 檔案) 的伺服器網址。註冊使用 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 的存放區網址。
    • 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