安裝 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 假設主機上的 SELinux (如有) 已設為寬鬆模式，包括檔案系統存取權。

事前準備

開始部署前，請確認您符合下列需求：

取得 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 處於寬容模式，請在所有資料庫和負載平衡器節點上執行下列指令。控制節點不需要這些指令：

sudo sed -i 's/^SELINUX=enforcing/SELINUX=permissive/g' /etc/selinux/config
sudo setenforce 0

安裝自動調度管理工具

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：Google 公開金鑰的位置，用於 GNU Privacy Guard (GPG) 驗證，例如 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