Auf dieser Seite wird die AlloyDB Omni-Version 18.1.0 mit der Bereitstellungsoption RPM-Orchestrator dokumentiert. Wählen Sie eine andere Bereitstellungsoption aus.

Google verwendet KI-Technologie, um Inhalte in Ihre bevorzugte Sprache zu übersetzen. KI-Übersetzungen können Fehler enthalten.

AlloyDB Omni mit dem RPM-Orchestrator installieren

Wählen Sie eine Dokumentationsversion aus:

Auf dieser Seite wird beschrieben, wie Sie den AlloyDB Omni-Softwarestack und seine Verwaltungskomponenten mit dem AlloyDB Omni-Orchestrator installieren.

Hinweis

Bevor Sie die Komponenten installieren, müssen Sie die folgenden Voraussetzungen erfüllen:

Orchestrator installieren: Der AlloyDB Omni-Orchestrator Ansible-Collection oder die CLI muss auf Ihrem Steuerknoten installiert sein.
Maschinen bereitstellen: Sie müssen virtuelle RHEL9-Maschinen gemäß der von Ihnen ausgewählten Architektur bereitgestellt haben, z. B. als Standalone- oder Hochverfügbarkeitsarchitektur.
Netzwerk und Firewall konfigurieren: Alle erforderlichen Ports müssen zwischen Ihren Knoten geöffnet sein. Dazu gehören 5432 für Datenbanktraffic, 2379/2380 für etcd und die Verwaltungsports 6703, 6702 und 6700, die vom Cluster Manager und Node Manager verwendet werden.
Abhängigkeiten von Softwarepaketen prüfen: 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.

Inventar der Bereitstellungsspezifikation vorbereiten

Der Orchestrator verwendet eine Bereitstellungsspezifikationsdatei im Ansible-Inventarformat, um Ihre Clustertopologie zu verstehen. Erstellen Sie eine Datei mit dem Namen deployment_spec.yaml mit Ihren Knotendetails.

alloydbomni:
  vars:
    cluster_manager:
      name: "MANAGEMENT_CLUSTER_NAME"
    etcd:
      setup: SETUP_ETCD
      config_forcewrite: FORCE_OVERWRITE_ETCD
      # version: ETCD_VERSION  # Optional: defaults to the latest version
      # repo_url: ETCD_REPOSITORY_URL  # Optional
      # repo_gpg_key_url: GPG_KEY  # Optional
    alloydbomni:
      major_version: "PG_VERSION" # Mandatory: for example, 18
      # version: ALLOYDB_OMNI_VERSION    # Optional: defaults to the latest version
      # repo_url: ALLOYDB_OMNI_COMMON_REPOSITORY_URL     # Optional
      # repo_gpg_key_url: GPG_KEY  # Optional
    alloydbomni_monitor:
      # version: ALLOYDB_OMNI_MONITOR_VERSION    # Optional: defaults to the latest version
      # repo_url: ALLOYDB_OMNI_COMMON_REPOSITORY_URL   # Optional
      # repo_gpg_key_url: GPG_KEY  # Optional
    alloydbomni_cluster_manager:
      # version: ALLOYDB_OMNI_CLUSTER_MANAGER_VERSION      # Optional: defaults to the latest version
      # repo_url: ALLOYDB_OMNI_ORCHESTRATOR_REPOSITORY_URL # Optional
      # repo_gpg_key_url: GPG_KEY  # Optional
    alloydbomni_node_manager:
      # version: ALLOYDB_OMNI_NODE_MANAGER_VERSION         # Optional: defaults to the latest version
      # repo_url: ALLOYDB_OMNI_ORCHESTRATOR_REPOSITORY_URL # Optional
      # repo_gpg_key_url: GPG_KEY  # Optional
    pgbouncer:
      # version: ALLOYDB_OMNI_PGBOUNCER_VERSION    # Optional
      # repo_url: ALLOYDB_OMNI_COMMON_REPOSITORY_URL   # Optional
      # repo_gpg_key_url: GPG_KEY  # Optional
    pgbackrest:
      # version: ALLOYDB_OMNI_PGBACKREST_VERSION   # Optional
      # repo_url: ALLOYDB_OMNI_COMMON_REPOSITORY_URL   # Optional
      # repo_gpg_key_url: GPG_KEY  # Optional

  children:
    primary_instance_nodes:
      hosts:
        DB_HOST_1:
        DB_HOST_2:
        DB_HOST_3:
    load_balancer_nodes:    # Optional. Host group for load balancer. If empty, no load balancer is configured.
      hosts:
        LB_HOST_1:
        LB_HOST_2:
    etcd_nodes:     # Optional: Host group where etcd is set up
      hosts:
        ETCD_HOST_1:
        ETCD_HOST_2:
        ETCD_HOST_3:
    cluster_manager_nodes:    # Optional: Host group for cluster manager
      hosts:
        CM_HOST_1:
        CM_HOST_2:
        CM_HOST_3:

Ersetzen Sie Folgendes:

MANAGEMENT_CLUSTER_NAME: der Name Ihres Verwaltungsclusters. Dieser kann mit dem Namen Ihres Datenbankclusters identisch sein, wenn sie auf denselben Knoten installiert sind, z. B. my-management-cluster.
SETUP_ETCD: gibt an, ob der Orchestrator den etcd-Cluster konfigurieren und booten muss. Wenn der Wert auf true gesetzt ist, führt der Orchestrator die anfängliche etcd-Einrichtung und -Initialisierung auf den angegebenen etcd-Knoten durch. Wenn in Ihrer deployment_spec keine etcd-Knoten definiert sind, wird etcd standardmäßig auf den Cluster Manager-Knoten konfiguriert. Dieser Parameter entspricht dem Schlüssel etcd.setup in der Bereitstellungsspezifikation.
FORCE_OVERWRITE_ETCD: bestimmt, ob während der Einrichtung eine vorhandene etcd-Konfigurationsdatei ersetzt werden soll. Setzen Sie den Wert auf true, um die vorhandene Konfigurationsdatei auf den Zielknoten zu überschreiben. Andernfalls setzen Sie den Wert auf false(Standardeinstellung), um die vorhandene Konfiguration beizubehalten und unbeabsichtigte Dienstunterbrechungen zu vermeiden.
ETCD_VERSION: die Version des zu installierenden etcd-Pakets, z. B. 3.4.13.
ETCD_REPOSITORY_URL: die URL des Repositorys, das die etcd-RPMs enthält.
PG_VERSION: die Hauptversion von PostgreSQL Ihrer AlloyDB Omni-Installation, z. B. 18.
ALLOYDB_OMNI_VERSION: die Version der zu installierenden AlloyDB Omni-Datenbank-Engine, z. B. 18.1.0. Wenn dieser Parameter nicht angegeben ist, installiert der Orchestrator die neueste verfügbare Version.
ALLOYDB_OMNI_COMMON_REPO_URL: die URL des gemeinsamen Repositorys, das AlloyDB Omni-, Monitor-, PgBouncer- und pgBackRest-RPMs enthält.
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. Dieser kann auch als Pfad festgelegt werden, wenn der Schlüssel auf allen VMs in eine Datei heruntergeladen wird, z. B. /tmp/linux_signing_key.pub.
ALLOYDB_OMNI_MONITOR_VERSION: die Version des zu installierenden AlloyDB Omni-Monitorpakets. Die Standardeinstellung ist die neueste verfügbare Version.
ALLOYDB_OMNI_CLUSTER_MANAGER_VERSION: die Version des zu installierenden AlloyDB Omni-Cluster Managers. Wenn dieser Parameter nicht angegeben ist, installiert der Orchestrator die neueste verfügbare Version.
ALLOYDB_OMNI_ORCHESTRATOR_REPO_URL: die URL des Repositorys, das die AlloyDB Omni-Cluster Manager- und Node Manager-RPMs enthält.
ALLOYDB_OMNI_NODE_MANAGER_VERSION: die Version des zu installierenden AlloyDB Omni-Node Managers. Wenn dieser Parameter nicht angegeben ist, installiert der Orchestrator die neueste verfügbare Version.
ALLOYDB_OMNI_PGBOUNCER_VERSION: die Version des zu installierenden PgBouncer-Pakets.
ALLOYDB_OMNI_PGBACKREST_VERSION: die Version des zu installierenden pgBackRest-Pakets.
DB_HOST_1, DB_HOST_2, DB_HOST_3: die IP-Adressen oder vollständig qualifizierten Domainnamen (Fully Qualified Domain Names, FQDNs) der virtuellen Maschinen, die als Datenbankknoten festgelegt sind.
LB_HOST_1, LB_HOST_2: die IP-Adressen oder vollständig qualifizierten Domainnamen (Fully Qualified Domain Names, FQDNs) der virtuellen Maschinen, die als Load-Balancer-Knoten festgelegt sind.
ETCD_HOST_1, ETCD_HOST_2, ETCD_HOST_3: die IP-Adressen oder FQDNs der virtuellen Maschinen, die als etcd-Knoten festgelegt sind.
CM_HOST_1, CM_HOST_2, CM_HOST_3: die IP-Adressen oder FQDNs der virtuellen Maschinen, die als Cluster Manager-Knoten festgelegt sind.

Komponenten installieren

Sie können die AlloyDB Omni-Komponenten und ihre Abhängigkeiten mit Ansible installieren oder die Softwarepakete manuell auf jedem Knoten installieren.

AlloyDB Omni-Komponenten mit Ansible installieren

Die empfohlene Installationsmethode ist die Verwendung der bereitgestellten Ansible-Rolle.

Erstellen Sie ein Playbook mit dem Namen install.yaml, das auf die Installationsrolle aus der Orchestrator-Collection verweist.
```
  - name: Install AlloyDB Omni cluster components
    hosts: all
    vars:
      ansible_become: true
      ansible_user: SSH_USER
      ansible_ssh_private_key_file: SSH_KEY_PATH
    roles:
      - role: google.alloydbomni_orchestrator.install
```
Ersetzen Sie Folgendes:
- SSH_USER: der Nutzername, mit dem Sie über SSH eine Verbindung zu den Knoten in Ihrem Cluster herstellen.
- SSH_KEY_PATH: der Pfad zur privaten SSH-Schlüsseldatei auf Ihrem Steuerknoten, z. B. ~/.ssh/id_rsa.
Führen Sie das Playbook mit Ihrer Inventardatei aus, um die RPMs auf allen angegebenen Knoten herunterzuladen und zu installieren.
```
  ansible-playbook -i deployment_spec.yaml install.yaml
```

AlloyDB Omni-Komponenten manuell installieren

Wenn Sie Ansible nicht verwenden, müssen Sie die RPMs manuell auf jedem Knoten in Ihrem Cluster installieren.

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. Dieser kann auch als Pfad festgelegt werden, wenn der Schlüssel auf allen VMs in eine Datei heruntergeladen wird, z. B. file:///tmp/linux_signing_key.pub.

AlloyDB Omni-Komponenten auf etcd-Knoten installieren

Erstellen Sie auf allen etcd-Knoten eine YUM-Repository-Konfigurationsdatei mit dem Namen /etc/yum.repos.d/alloydb-etcd.repo:
```
[etcd]
name=AlloyDB Omni ETCD
baseurl=ETCD_REPOSITORY_URL
enabled=1
repo_gpgcheck=0
gpgcheck=1
gpgkey=REPO_GPG_KEY
```
etcd installieren:
```
sudo dnf install -y etcd
```

etcd booten, indem Sie die Konfigurationsdatei bearbeiten. Sie müssen etcd booten, bevor Sie AlloyDB Omni-Komponenten installieren.

Bearbeiten Sie auf etcd_nodes die Datei /etc/etcd/etcd.conf:

ETCD_NAME=ETCD_HOST
ETCD_DATA_DIR=/var/lib/etcd/data
ETCD_LISTEN_PEER_URLS=https://ETCD_HOST_IP:2380,https://127.0.0.1:2380
ETCD_LISTEN_CLIENT_URLS=https://ETCD_HOST_IP:2379,https://127.0.0.1:2379
ETCD_INITIAL_ADVERTISE_PEER_URLS=https://ETCD_HOST_IP:2380
ETCD_ADVERTISE_CLIENT_URLS=https://ETCD_HOST_IP:2379

ETCD_INITIAL_CLUSTER=ETCD_HOST_1=https://ETCD_HOST_IP_1:2380,ETCD_HOST_2=https://ETCD_HOST_IP_2:2380,ETCD_HOST_3=https://ETCD_HOST_IP_3:2380

ETCD_INITIAL_CLUSTER_STATE=new
ETCD_INITIAL_CLUSTER_TOKEN=CLUSTER_NAME
ETCD_ENABLE_V2=true

ETCD_CLIENT_CERT_AUTH=true
ETCD_TRUSTED_CA_FILE=/var/lib/etcd/ssl/etcd-ca.crt
ETCD_CERT_FILE=/var/lib/etcd/ssl/etcd-tls.crt
ETCD_KEY_FILE=/var/lib/etcd/ssl/etcd-tls.key
ETCD_PEER_CLIENT_CERT_AUTH=true
ETCD_PEER_TRUSTED_CA_FILE=/var/lib/etcd/ssl/etcd-ca.crt
ETCD_PEER_CERT_FILE=/var/lib/etcd/ssl/etcd-tls.crt
ETCD_PEER_KEY_FILE=/var/lib/etcd/ssl/etcd-tls.key

Wobei:

ETCD_HOST: aktueller etcd-Host.
ETCD_HOST_IP: aktuelle etcd-Host-IP-Adresse.
ETCD_HOST_1: der Name des ersten Knotens im etcd-Cluster.
ETCD_HOST_IP_1: die IP-Adresse des ersten Knotens im etcd-Cluster.
ETCD_HOST_2: der Name des zweiten Knotens im etcd-Cluster.
ETCD_HOST_IP_2: die IP-Adresse des zweiten Knotens im etcd-Cluster.
ETCD_HOST_3: der Name des dritten Knotens im etcd-Cluster.
ETCD_HOST_IP_3: die IP-Adresse des dritten Knotens im etcd-Cluster.
CLUSTER_NAME: Clustername gemäß der Steuerungsebene.

Konfigurieren Sie die Firewall so, dass die TCP-Kommunikation über die Ports 2379 und 2380 zugelassen wird.

Starten Sie etcd:

sudo systemctl enable etcd
sudo systemctl start etcd

AlloyDB Omni-Komponenten auf Cluster Manager-Knoten installieren

Erstellen Sie auf allen Cluster Manager-Knoten eine YUM-Repository-Konfigurationsdatei mit dem Namen /etc/yum.repos.d/alloydb-orchestrator.repo:

[alloydbomni_orchestrator]
name=AlloyDB Omni Orchestrator
baseurl=ALLOYDB_OMNI_ORCHESTRATOR_REPOSITORY_URL
enabled=1
repo_gpgcheck=0
gpgcheck=1
gpgkey=REPO_GPG_KEY

Installieren Sie den Cluster Manager:

sudo dnf install -y alloydbomni_cluster_manager

Starten Sie den Cluster Manager:

sudo systemctl enable alloydbomni_cluster_manager
sudo systemctl start alloydbomni_cluster_manager

AlloyDB Omni-Komponenten auf Datenbankknoten installieren

Erstellen Sie auf allen Datenbankknoten eine YUM-Repository-Konfigurationsdatei mit dem Namen /etc/yum.repos.d/alloydb-omni.repo:

[alloydbomni_core]
name=AlloyDB Omni Core
baseurl=ALLOYDB_OMNI_REPOSITORY_URL
enabled=1
repo_gpgcheck=0
gpgcheck=1
gpgkey=REPO_GPG_KEY

[alloydbomni_common]
name=AlloyDB Omni Common
baseurl=ALLOYDB_OMNI_COMMON_REPOSITORY_URL
enabled=1
repo_gpgcheck=0
gpgcheck=1
gpgkey=REPO_GPG_KEY
priority=1

[alloydbomni_orchestrator]
name=AlloyDB Omni Orchestrator
baseurl=ALLOYDB_OMNI_ORCHESTRATOR_REPOSITORY_URL
enabled=1
repo_gpgcheck=0
gpgcheck=1
gpgkey=REPO_GPG_KEY

Installieren Sie die Komponenten:

sudo dnf install -y alloydbomniPG_VERSION alloydbomni_monitor alloydbomni_node_manager pgbackrest

Starten Sie den Node Manager:

sudo systemctl enable alloydbomni_node_manager
sudo systemctl start alloydbomni_node_manager

(Optional) Wenn Sie keine separaten Load-Balancer-Knoten verwenden, installieren Sie pgbouncer und keepalived:
```
sudo dnf install -y pgbouncer keepalived
```

AlloyDB Omni-Komponenten auf Load-Balancer-Knoten installieren

Erstellen Sie auf allen Load-Balancer-Knoten eine YUM-Repository-Konfigurationsdatei mit dem Namen /etc/yum.repos.d/alloydb-omni-lb.repo:

[pgbouncer]
name=AlloyDB Omni Common
baseurl=ALLOYDB_OMNI_COMMON_REPOSITORY_URL
enabled=1
repo_gpgcheck=0
gpgcheck=1
gpgkey=REPO_GPG_KEY
priority=1

[alloydbomni_node_manager]
name=AlloyDB Omni Orchestrator
baseurl=ALLOYDB_OMNI_ORCHESTRATOR_REPOSITORY_URL
enabled=1
repo_gpgcheck=0
gpgcheck=1
gpgkey=REPO_GPG_KEY

Installieren Sie die Load-Balancer-Komponenten:

sudo dnf install -y alloydbomni_node_manager keepalived pgbouncer haproxy

Starten Sie den Node Manager:

sudo systemctl enable alloydbomni_node_manager
sudo systemctl start alloydbomni_node_manager

Zusammenfassung der installierten AlloyDB Omni-Komponenten

Beim Installationsvorgang werden je nach Knotentyp mehrere wichtige RPM-Pakete bereitgestellt:

Knotentyp	Installierte Komponenten	Hinweise
Knoten der primären Instanz	`alloydbomniPG_VERSION`, `alloydbomni_monitor`, `alloydbomni_node_manager`, `pgbouncer`, `pgbackrest`	Komponenten für die Datenbank-Engine, das Monitoring und die Verwaltung.
Load-Balancer-Knoten	`haproxy`	Optional. Die Installation wird übersprungen, wenn keine Load-Balancer-Knoten verfügbar sind.
Cluster Manager-Knoten	`alloydbomni_cluster_manager`	Kann auf Datenbankknoten installiert werden, wenn keine dedizierten Knoten verfügbar sind. Wenn keine Cluster Manager-Knoten angegeben sind, wird die Cluster Manager-Komponente auf den `primary_instance_nodes` installiert.
etcd-Knoten	`etcd`	Kann bei Bedarf auf Cluster Manager-Knoten installiert werden. Wenn keine etcd-Knoten angegeben sind, wird `etcd` auf den `cluster_manager_nodes` installiert.

Komponenten deinstallieren

Wenn Sie die AlloyDB Omni-Installation aus Ihrer Umgebung entfernen müssen, z. B. um einen Cluster außer Betrieb zu nehmen oder eine Neuinstallation vorzubereiten, können Sie alle Softwarekomponenten deinstallieren. Sie können AlloyDB Omni mit Ansible deinstallieren oder die RPMs manuell von jedem Knoten entfernen.

AlloyDB Omni-Komponenten mit Ansible deinstallieren

Wenn Sie die Komponenten des AlloyDB Omni-Softwarestacks mit Ansible entfernen möchten, verwenden Sie Ihre vorhandene Inventardatei und ein Playbook, das auf die Rolle google.alloydbomni_orchestrator.uninstall verweist.

Erstellen Sie ein Playbook mit dem Namen uninstall.yaml.
```
- name: Uninstall AlloyDB Omni cluster
  hosts: all
  vars:
    ansible_become: true
    ansible_user: SSH_USER
    ansible_ssh_private_key_file: SSH_KEY_PATH
  roles:
    - role: google.alloydbomni_orchestrator.uninstall
```
Ersetzen Sie Folgendes:
- SSH_USER: der Nutzername, mit dem Sie über SSH eine Verbindung zu den Knoten in Ihrem Cluster herstellen.
- SSH_KEY_PATH: der Pfad zur privaten SSH-Schlüsseldatei auf Ihrem Steuerknoten, z. B. ~/.ssh/id_rsa.
Führen Sie das Playbook aus. Sie müssen cleanup_data=true und cleanup_config=true als zusätzliche Variablen übergeben, um die Konfigurationsdateien und das Datenverzeichnis zu entfernen.
```
ansible-playbook -i deployment_spec.yaml uninstall.yaml -e "cleanup_data=true cleanup_config=true"
```
Hinweis: Wenn die Deinstallation aufgrund von Inkonsistenzen im Clusterstatus fehlschlägt, können Sie eine erzwungene Deinstallation versuchen, indem Sie -e force=true dem Befehl hinzufügen.

AlloyDB Omni-Komponenten manuell deinstallieren

Wenn Sie die AlloyDB Omni-Orchestrator-CLI verwenden, müssen Sie die RPMs manuell von jedem Knoten entfernen.

Führen Sie auf allen Datenbankknoten den folgenden Befehl aus:

sudo dnf remove -y alloydbomni_node_manager alloydbomniPG_VERSION alloydbomni_monitor pgbackrest keepalived pgbouncer

Führen Sie auf allen Load-Balancer-Knoten den folgenden Befehl aus:

sudo dnf remove -y alloydbomni_node_manager keepalived haproxy pgbouncer

Führen Sie auf allen Cluster Manager-Knoten den folgenden Befehl aus:
```
sudo dnf remove -y alloydbomni_cluster_manager
```
Optional: Führen Sie auf allen etcd-Knoten den folgenden Befehl aus, um etcd zu deinstallieren und etcd-Daten zu bereinigen:
```
sudo dnf remove -y etcd
sudo rm -rf /var/lib/etcd/data
```

Nächste Schritte

Informationen zum Verwenden eigener Zertifikats- und Schlüsseldateien für TLS finden Sie unter TLS in AlloyDB Omni.
AlloyDB Omni-Cluster erstellen.