安裝 AlloyDB Omni RPM 編排器

AlloyDB Omni 採用 RPM Orchestrator，提供自動化平台，可在一組虛擬機器 (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 Port，用於檢查主要或待命狀態
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