AlloyDB Omni-RPM-Orchestrator installieren

Wählen Sie eine Dokumentationsversion aus:

AlloyDB Omni mit dem RPM-Orchestrator bietet eine Automatisierungsplattform zum Installieren, Einrichten und Verwalten von AlloyDB Omni-Datenbankclustern auf einer Reihe von virtuellen Maschinen (VMs) oder Bare-Metal-Servern. AlloyDB Omni mit dem RPM-Orchestrator bietet eine CLI- und Ansible-Schnittstelle, die auf einem dedizierten Steuerknoten ausgeführt wird, von dem aus Sie einen oder mehrere Cluster remote verwalten.

Je nach Ihren Automatisierungsanforderungen können Sie zwischen zwei Orchestrator-Schnittstellen wählen:

  • AlloyDB Omni-Orchestrator-CLI alloydbctl: Empfohlen für Umgebungen, in denen Shell-Skripts für die Automatisierung verwendet werden.
  • AlloyDB Omni-Orchestrator-Ansible-Sammlung: Empfohlen für Umgebungen, in denen Ansible-basierte Automatisierung verwendet wird.

Beschränkungen

Für diesen Release gelten die folgenden Einschränkungen:

  • Dieser Release unterstützt nur AlloyDB Omni PostgreSQL 18.
  • Dieser Release unterstützt nur mit RHEL Version 9 kompatible Softwarepakete.
  • Dieser Release unterstützt nur die Intel x86 64-Bit-basierte Plattform.
  • Upgrades der Hauptversion werden in diesem Release nicht unterstützt.
  • Dieser Release enthält keine Anleitung zum Einrichten der Notfallwiederherstellung.
  • Dieser Release enthält keine Anleitung zum Einrichten von Lesepoolinstanzen.
  • Der AlloyDB Omni-Monitor unterstützt keine SSL-Verbindungen. Sie müssen Ihre Monitoring-Dashboard-Server im selben privaten Netzwerk wie die AlloyDB Omni-Knoten bereitstellen.

Hinweis

Bevor Sie mit der Bereitstellung beginnen, müssen Sie die folgenden Anforderungen erfüllen:

AlloyDB Omni-Pakete abrufen

Die Softwarepakete von AlloyDB Omni mit dem RPM-Orchestrator sind in der Vorabversion verfügbar. Sie müssen sich über das Anmeldeformular für die Vorabversion von AlloyDB Omni mit dem RPM-Orchestrator anmelden, um die RPM-Dateien zu erhalten.

Wenn Sie Softwarepakete über ein privates Yum-Repository verwalten, folgen Sie der Anleitung Ihrer Repository-Verwaltung, um abhängige RPM-Dateien in das Repository aufzunehmen. Weitere Informationen finden Sie unter Softwarepaketabhängigkeiten.

Software-Repository einrichten

AlloyDB Omni-RPMs werden in einem globalen Yum-Repository verwaltet. Wenn Ihre Organisation Software über ein privates Yum-Repository verwaltet, müssen Sie die nach der Registrierung bereitgestellten RPM-Pakete gemäß Ihren Verwaltungstools in Ihr Repository aufnehmen. Sie benötigen die URL Ihres privaten Repository während der Bereitstellung.

Maschinen bereitstellen

Stellen Sie eine Reihe von VMs mit RHEL 9 bereit, darunter:

  • Controller: 1 Knoten, der die Bereitstellung orchestriert und passwortlosen SSH-Zugriff auf alle anderen Knoten hat.
  • Datenbank: 1 oder 3 Knoten, auf denen die AlloyDB Omni-Kern- und Monitoring-Dienste ausgeführt werden.
  • Load-Balancer: 2 optionale Knoten, auf denen HAProxy und optionale Verbindungspooler wie PgBouncer ausgeführt werden.

Netzwerk und Firewall konfigurieren

Konfigurieren Sie Ihre Firewall so, dass die folgenden TCP-Ports basierend auf Ihrer Architektur zugelassen werden:

Port Protokoll Knoten Dienst Traffic Hinweise
5432 TCP Load-Balancer HAProxy Eingehend Auf dem Load-Balancer-Knoten, falls zutreffend
6432 TCP Load-Balancer PgBouncer Eingehend Verbindungspooler, falls zutreffend
9187 TCP Datenbank AlloyDB-Monitor Eingehend Monitor, falls zutreffend; unterstützt kein TLS
5432 TCP Datenbank AlloyDB Eingehend Resiliente Architektur mit 3 Knoten
6432 TCP Datenbank PgBouncer Eingehend Verbindungspooler, falls zutreffend, in einer resilienten Architektur mit 3 Knoten
2380 TCP etcd etcd Eingehend Für das Peer-to-Peer-Protokoll von etcd
- VRRP Load-Balancer Keepalived Eingehend Keepalived-Leader-Wahl
- VRRP Datenbank Keepalived Eingehend Keepalived-Leader-Wahl in einer resilienten Architektur mit 3 Knoten
6703 TCP Cluster Manager Cluster Manager Eingehend gRPC-Port des Cluster Managers
6702 TCP Alle Knoten Knoten-Manager Eingehend gRPC-Port des Knoten-Managers
6700 TCP Alle Knoten Knoten-Manager Eingehend gRPC-Port für die Initialisierung des Knoten-Managers
8086 HTTP Alle Knoten Knoten-Manager Eingehend HTTP-Port des Knoten-Managers zum Prüfen des primären oder Standby-Knotens
2379 TCP etcd etcd Eingehend Damit der Cluster Manager mit etcd arbeiten kann
443 HTTPS Datenbank Cloud Storage Ausgehend Zum Senden von Sicherungsdaten

SELinux-Modus des Hosts

AlloyDB Omni unterstützt SELinux sowohl im permissiven als auch im erzwingenden Modus.

Wenn Sie SELinux aktivieren oder deaktivieren möchten, prüfen Sie, ob die Datei /etc/selinux/config auf allen Knoten aktualisiert wurde. Bevor Sie den Cluster booten, müssen die SELinux-Einstellungen auf allen Datenbank- und Load-Balancer-Knoten einheitlich sein. Verwenden Sie den Befehl getenforce, um die aktuellen Einstellungen zu prüfen.

Weitere Informationen finden Sie unter SELinux-Richtlinienspezifikationen.

Orchestrator installieren

Ansible

Verwenden Sie diese Methode, wenn Sie Ansible-Playbooks zum Verwalten Ihrer Cluster verwenden möchten.

  1. Installieren Sie auf Ihrem Steuerknoten Ansible und die erforderlichen Python-Bibliotheken:

    # 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. Laden Sie die Tar-Datei der Ansible-Sammlung und ihre Signatur herunter, prüfen Sie das Paket und installieren Sie es:

    # 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
    

    Ersetzen Sie ALLOYDBOMNI_SERVER durch die URL des Servers, auf dem die AlloyDB Omni-Softwarepakete, einschließlich der Tar-Datei der Ansible-Sammlung, gehostet werden. Diese Quelle wird Ihnen zur Verfügung gestellt, nachdem Sie sich für die Vorabversion von AlloyDB Omni mit dem RPM-Orchestrator angemeldet haben.

alloydbctl

Verwenden Sie diese Methode, wenn Sie ein Befehlszeilenprogramm zum Verwalten von Ressourcen bevorzugen.

  1. Erstellen Sie auf dem Steuerknoten unter /etc/yum.repos.d/alloydbomni_orchestrator.repo eine Yum-Konfigurationsdatei:

    [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
    

    Ersetzen Sie Folgendes:

    • ALLOYDB_OMNI_ORCHESTRATOR_REPOSITORY_URL: die URL des Repository, das die AlloyDB Omni-Orchestrator-RPMs enthält.
    • REPO_GPG_KEY: der Speicherort des öffentlichen Schlüssels von Google für die GNU Privacy Guard-Überprüfung (GPG), z. B. https://dl.google.com/linux/linux_signing_key.pub. Dies kann auch als Pfad festgelegt werden, wenn der Schlüssel in eine Datei heruntergeladen wird, z. B. file:///tmp/linux_signing_key.pub.
  2. Installieren Sie das Paket und fügen Sie die Binärdatei dem PATH Ihres Systems hinzu:

    sudo dnf install alloydbomni_orchestrator
    export PATH=$PATH:/usr/local/bin
    
  3. Überprüfen Sie die Installation mit folgendem Befehl:

    alloydbctl --help