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 uses AI technology to translate content into your preferred language. AI translations can contain errors.

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: Die Ansible-Sammlung oder CLI des AlloyDB Omni-Orchestrators muss auf Ihrem Steuerknoten installiert sein.
Stellen Sie Maschinen bereit: Sie müssen RHEL9-VMs gemäß der von Ihnen ausgewählten Architektur bereitstellen, z. B. als Standalone- oder Hochverfügbarkeitskonfiguration.
Netzwerk und Firewall konfigurieren: Achten Sie darauf, dass alle erforderlichen Ports zwischen Ihren Knoten geöffnet sind. Dazu gehören 5432 für Datenbanktraffic, 2379/2380 für etcd sowie die Verwaltungsports 6703, 6702 und 6700, die vom Cluster Manager und Node Manager verwendet werden.
Softwarepaketabhängigkeiten 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 die Clustertopologie zu verstehen. Erstellen Sie eine Datei mit dem Namen deployment_spec.yaml und 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. Das kann derselbe Name wie der Name Ihres Datenbankclusters 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 festgelegt ist, führt der Orchestrator die anfängliche Einrichtung und Initialisierung von etcd auf den dafür vorgesehenen etcd-Knoten aus. Wenn in Ihrer „deployment_spec“ keine etcd-Knoten definiert sind, wird standardmäßig etcd auf den Cluster-Manager-Knoten konfiguriert. Dieser Parameter entspricht dem Schlüssel etcd.setup in der Bereitstellungsspezifikation.
FORCE_OVERWRITE_ETCD: Gibt an, ob eine vorhandene etcd-Konfigurationsdatei während der Einrichtung ersetzt werden soll. Auf true setzen, um die vorhandene Konfigurationsdatei auf den Zielknoten zu überschreiben. Andernfalls auf false(Standard) setzen, um die vorhandene Konfiguration beizubehalten und unbeabsichtigte Dienstunterbrechungen zu verhindern.
ETCD_VERSION: Die Version des zu installierenden etcd-Pakets, z. B. 3.4.13.
ETCD_REPOSITORY_URL: die URL des Repositorys mit den etcd-RPMs.
PG_VERSION: Die Hauptversion von PostgreSQL Ihrer AlloyDB Omni-Installation, z. B. 18.
ALLOYDB_OMNI_VERSION: Die Version der AlloyDB Omni-Datenbank-Engine, die installiert werden soll, z. B. 18.1.0. Wenn diese Option nicht angegeben wird, installiert der Orchestrator die neueste verfügbare Version.
ALLOYDB_OMNI_COMMON_REPO_URL: Die URL des gemeinsamen Repositorys mit den RPMs für AlloyDB Omni, Monitor, PgBouncer und pgBackRest.
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 auf allen VMs in eine Datei heruntergeladen wird, z. B. /tmp/linux_signing_key.pub.
ALLOYDB_OMNI_MONITOR_VERSION: Die Version des AlloyDB Omni-Monitorpakets, die installiert werden soll. Die Standardeinstellung ist die neueste verfügbare Version.
ALLOYDB_OMNI_CLUSTER_MANAGER_VERSION: Die Version des AlloyDB Omni-Clustermanagers, die installiert werden soll. Wenn diese Option nicht angegeben wird, installiert der Orchestrator die neueste verfügbare Version.
ALLOYDB_OMNI_ORCHESTRATOR_REPO_URL: Die URL des Repositorys mit den RPMs für den AlloyDB Omni-Clustermanager und den Knotenmanager.
ALLOYDB_OMNI_NODE_MANAGER_VERSION: Die Version des AlloyDB Omni-Knotenmanagers, die installiert werden soll. Wenn diese Option nicht angegeben wird, installiert der Orchestrator die neueste verfügbare Version.
ALLOYDB_OMNI_PGBOUNCER_VERSION: Die Version des PgBouncer-Pakets, die installiert werden soll.
ALLOYDB_OMNI_PGBACKREST_VERSION: Die Version des pgBackRest-Pakets, die installiert werden soll.
DB_HOST_1, DB_HOST_2, DB_HOST_3: Die IP-Adressen oder vollständig qualifizierten Domainnamen (FQDNs) der virtuellen Maschinen, die als Datenbankknoten vorgesehen sind.
LB_HOST_1, LB_HOST_2: Die IP-Adressen oder vollständig qualifizierten Domainnamen (FQDNs) der virtuellen Maschinen, die als Load-Balancer-Knoten vorgesehen 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 vorgesehen sind.

Komponenten installieren

Sie können die AlloyDB Omni-Komponenten und ihre Abhängigkeiten mit Ansible oder durch manuelle Installation der Softwarepakete 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-Sammlung 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 Kontrollknoten, 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 auf jedem Knoten in Ihrem Cluster manuell installieren.

REPO_GPG_KEY: der Speicherort des öffentlichen Google-Schlüssels für die GNU Privacy Guard-Bestätigung (GPG), z. B. https://dl.google.com/linux/linux_signing_key.pub. Dies 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
```
Installieren Sie etcd:
```
sudo dnf install -y etcd
```

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

Bearbeiten Sie auf etcd_nodes /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-Organisator.
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: Der 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 Clustermanager:

sudo dnf install -y alloydbomni_cluster_manager

Starten Sie den Clustermanager:

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 Knotenmanager:

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 Knotenmanager:

sudo systemctl enable alloydbomni_node_manager
sudo systemctl start alloydbomni_node_manager

Zusammenfassung der installierten AlloyDB Omni-Komponenten

Beim Installationsprozess 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.
Clustermanager-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 dem `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 dem `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 deinstallieren AlloyDB Omni mit Ansible oder indem Sie die RPMs manuell von jedem Knoten entfernen.

AlloyDB Omni-Komponenten mit Ansible deinstallieren

Wenn Sie die AlloyDB Omni-Softwarestackkomponenten 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 Kontrollknoten, 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 dem Befehl -e force=true 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 Bereitstellen eigener Zertifikats- und Schlüsseldateien für TLS finden Sie unter TLS in AlloyDB Omni.
AlloyDB Omni-Cluster erstellen