Installa l'orchestratore RPM di AlloyDB Omni

Seleziona una versione della documentazione:

AlloyDB Omni che utilizza l'orchestratore RPM fornisce una piattaforma di automazione per installare, configurare e gestire i cluster di database AlloyDB Omni su un insieme di macchine virtuali (VM) o server bare metal. AlloyDB Omni che utilizza l'orchestratore RPM fornisce un'interfaccia CLI e Ansible che viene eseguita su un nodo di controllo dedicato da cui gestisci uno o più cluster da remoto.

A seconda delle tue esigenze di automazione, puoi scegliere tra due interfacce dell'orchestratore:

  • CLI dell'orchestratore AlloyDB Omni alloydbctl: consigliata per gli ambienti che utilizzano script di shell per l'automazione.
  • Raccolta Ansible dell'orchestratore AlloyDB Omni: consigliata per gli ambienti che utilizzano l'automazione basata su Ansible.

Limitazioni

A questa release si applicano le seguenti limitazioni:

  • Questa release supporta solo AlloyDB Omni PostgreSQL 18.
  • Questa release supporta solo i pacchetti software compatibili con RHEL versione 9.
  • Questa release supporta solo la piattaforma basata su Intel x86 a 64 bit.
  • Gli upgrade della versione principale non sono supportati in questa release.
  • Questa release non include le istruzioni per configurare il ripristino di emergenza.
  • Questa release non include le istruzioni per configurare le istanze del pool di lettura.
  • Il monitor AlloyDB Omni non supporta le connessioni SSL. Devi eseguire il deployment dei server della dashboard di monitoraggio sulla stessa rete privata dei nodi AlloyDB Omni.

Prima di iniziare

Prima di iniziare il deployment, assicurati di soddisfare i seguenti requisiti:

Ottieni i pacchetti AlloyDB Omni

I pacchetti software AlloyDB Omni che utilizzano l'orchestratore RPM sono in anteprima. Devi registrarti utilizzando il modulo di registrazione all'anteprima di AlloyDB Omni che utilizza l'orchestratore RPM per ricevere i file RPM.

Se gestisci i pacchetti software tramite un repository Yum privato, segui le istruzioni di gestione del repository per includere i file RPM dipendenti nel repository. Per saperne di più, consulta Dipendenze dei pacchetti software.

Configura un repository software

Gli RPM di AlloyDB Omni vengono gestiti in un repository Yum globale. In alternativa, se la tua organizzazione gestisce il software tramite un repository Yum privato, devi includere i pacchetti RPM forniti dopo la registrazione nel repository in base agli strumenti di gestione. Avrai bisogno dell'URL del repository privato durante il processo di deployment.

Esegui il provisioning delle macchine

Esegui il provisioning di un insieme di VM che eseguono RHEL 9, tra cui:

  • Controller: 1 nodo che orchestra il deployment e ha accesso SSH senza password a tutti gli altri nodi.
  • Database: 1 o 3 nodi che eseguono i servizi di base e di monitoraggio di AlloyDB Omni.
  • Bilanciatore del carico: 2 nodi facoltativi che eseguono HAProxy e pool di connessioni facoltativi come PgBouncer.

Configura la rete e il firewall

Configura il firewall in modo da consentire le seguenti porte TCP in base alla tua architettura:

Porta Protocollo Nodo Servizio Traffico Note
5432 TCP Bilanciatore del carico HAProxy In entrata Sul nodo del bilanciatore del carico, se applicabile
6432 TCP Bilanciatore del carico PgBouncer In entrata Pool di connessioni, se applicabile
9187 TCP Database Monitor AlloyDB In entrata Monitor, se applicabile; non supporta TLS
5432 TCP Database AlloyDB In entrata Architettura resiliente a 3 nodi
6432 TCP Database PgBouncer In entrata Pool di connessioni, se applicabile, su un'architettura resiliente a 3 nodi
2380 TCP etcd etcd In entrata Per il protocollo peer-to-peer etcd
- VRRP Bilanciatore del carico Keepalived In entrata Elezione del leader Keepalived
- VRRP Database Keepalived In entrata Elezione del leader Keepalived su un'architettura resiliente a 3 nodi
6703 TCP Gestore cluster Gestore cluster In entrata Porta gRPC del gestore cluster
6702 TCP Tutti i nodi Gestore nodi In entrata Porta gRPC del gestore nodi
6700 TCP Tutti i nodi Gestore nodi In entrata Porta gRPC di inizializzazione del gestore nodi
8086 HTTP Tutti i nodi Gestore nodi In entrata Porta HTTP del gestore nodi per controllare il nodo primario o di standby
2379 TCP etcd etcd In entrata Per il funzionamento del gestore cluster con etcd
443 HTTPS Database Cloud Storage In uscita Per l'invio dei dati di backup

Modalità SELinux dell'host

AlloyDB Omni supporta SELinux in modalità permissiva e di applicazione.

Per attivare o disattivare SELinux, verifica che il file /etc/selinux/config sia aggiornato su tutti i nodi. Prima di eseguire il bootstrap del cluster, assicurati che le impostazioni di SELinux siano coerenti su tutti i nodi del database e sui nodi del bilanciatore del carico. Per verificare le impostazioni correnti, utilizza il comando getenforce.

Per saperne di più, consulta Specifiche delle policy SELinux.

Installa l'orchestratore

Ansible

Utilizza questo metodo se prevedi di utilizzare i playbook Ansible per gestire i cluster.

  1. Sul nodo di controllo, installa Ansible e le librerie Python richieste:

    # 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. Scarica il file tar della raccolta Ansible e la relativa firma, verifica il pacchetto e installalo:

    # 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

    Sostituisci ALLOYDBOMNI_SERVER con l'URL del server in cui sono ospitati i pacchetti software AlloyDB Omni, incluso il file tar della raccolta Ansible. Questa origine ti viene fornita dopo la registrazione all'anteprima di AlloyDB Omni che utilizza l'orchestratore RPM Anteprima.

alloydbctl

Utilizza questo metodo se preferisci un'utilità della riga di comando per la gestione delle risorse.

  1. Crea un file di configurazione Yum sul nodo di controllo in /etc/yum.repos.d/alloydbomni_orchestrator.repo:

    [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

    Sostituisci quanto segue:

    • ALLOYDB_OMNI_ORCHESTRATOR_REPOSITORY_URL: l'URL del repository contenente gli RPM dell'orchestratore AlloyDB Omni.
    • REPO_GPG_KEY: la posizione della chiave pubblica di Google per la verifica GNU Privacy Guard (GPG), ad esempio https://dl.google.com/linux/linux_signing_key.pub. Può essere impostato anche come percorso se la chiave viene scaricata in un file, ad esempio file:///tmp/linux_signing_key.pub.

  2. Installa il pacchetto e aggiungi il file binario a PATH del sistema:

    sudo dnf install alloydbomni_orchestrator
export PATH=$PATH:/usr/local/bin

  3. Verifica l'installazione eseguendo:

    alloydbctl --help