Instala el orquestador de RPM de AlloyDB Omni

Selecciona una versión de la documentación:

AlloyDB Omni con el organizador RPM proporciona una plataforma de automatización para instalar, configurar y administrar clústeres de bases de datos de AlloyDB Omni en un conjunto de máquinas virtuales (VMs) o servidores sin sistema operativo. AlloyDB Omni con el organizador RPM proporciona una CLI y una interfaz de Ansible que se ejecutan en un nodo de control dedicado desde el que administras uno o más clústeres de forma remota.

Según tus necesidades de automatización, puedes elegir entre dos interfaces de organizador:

  • CLI del organizador de AlloyDB Omni alloydbctl: Se recomienda para entornos que usan secuencias de comandos de shell para la automatización.
  • Colección de Ansible del organizador de AlloyDB Omni: Se recomienda para entornos que usan Ansible-based automatización.

Limitaciones

Se aplican las siguientes limitaciones a esta versión:

  • Esta versión solo admite AlloyDB Omni PostgreSQL 18.
  • Esta versión solo admite paquetes de software compatibles con la versión 9 de RHEL.
  • Esta versión solo admite la plataforma basada en Intel x86 de 64 bits.
  • En esta versión, no se admiten las actualizaciones de la versión principal.
  • Esta versión no incluye instrucciones para configurar la recuperación ante desastres.
  • Esta versión no incluye instrucciones para configurar instancias de grupo de lectura.
  • El monitor de AlloyDB Omni no admite conexiones SSL. Debes implementar los servidores del panel de supervisión en la misma red privada que los nodos de AlloyDB Omni.

Antes de comenzar

Antes de iniciar la implementación, asegúrate de cumplir con los siguientes requisitos:

Obtén paquetes de AlloyDB Omni

Los paquetes de software de AlloyDB Omni con el orquestador RPM están en versión preliminar. Debes registrarte con el formulario de registro de la versión preliminar de AlloyDB Omni con el organizador RPM para recibir los archivos RPM.

Si administras paquetes de software a través de un repositorio Yum privado, sigue las instrucciones de la administración del repositorio para incluir archivos RPM dependientes en el repositorio. Para obtener más información, consulta Dependencias de paquetes de software.

Configura un repositorio de software

Los RPM de AlloyDB Omni se mantienen en un repositorio Yum global. Como alternativa, si tu organización administra software a través de un repositorio Yum privado, debes incluir los paquetes RPM proporcionados después del registro en tu repositorio según tus herramientas de administración. Necesitas la URL de tu repositorio privado durante el proceso de implementación.

Aprovisiona máquinas

Aprovisiona un conjunto de VMs que ejecuten RHEL 9, incluidos los siguientes:

  • Controlador: 1 nodo que organiza la implementación y tiene acceso SSH sin contraseña a todos los demás nodos.
  • Base de datos: 1 o 3 nodos que ejecutan los servicios principales y de supervisión de AlloyDB Omni.
  • Balanceador de cargas: 2 nodos opcionales que ejecutan HAProxy y agrupadores de conexiones opcionales, como PgBouncer.

Configura la red y el firewall

Configura el firewall para permitir los siguientes puertos TCP según tu arquitectura:

Puerto Protocolo Nodo Servicio Tráfico Notas
5432 TCP Balanceador de cargas HAProxy Entrantes En el nodo del balanceador de cargas, si corresponde
6432 TCP Balanceador de cargas PgBouncer Entrantes Agrupador de conexiones, si corresponde
9187 TCP Base de datos Monitor de AlloyDB Entrantes Monitor, si corresponde; no admite TLS
5432 TCP Base de datos AlloyDB Entrantes Arquitectura resistente de 3 nodos
6432 TCP Base de datos PgBouncer Entrantes Agrupador de conexiones, si corresponde en la arquitectura resistente de 3 nodos
2380 TCP etcd etcd Entrantes Para el protocolo de par a par de etcd
- VRRP Balanceador de cargas Keepalived Entrantes Elección de líder de Keepalived
- VRRP Base de datos Keepalived Entrantes Elección de líder de Keepalived en la arquitectura resistente de 3 nodos
6703 TCP Gestor de clúster Administrador de clústeres Entrantes Puerto gRPC del gestor de clúster
6702 TCP Todos los nodos Node Manager Entrantes Puerto gRPC del administrador de nodos
6700 TCP Todos los nodos Node Manager Entrantes Puerto gRPC de inicialización del administrador de nodos
8086 HTTP Todos los nodos Node Manager Entrantes Puerto HTTP del administrador de nodos para verificar el nodo principal o en espera
2379 TCP etcd etcd Entrantes Para que el gestor de clúster funcione con etcd
443 HTTPS Base de datos Cloud Storage Salientes Para enviar datos de copia de seguridad

Modo SELinux del host

AlloyDB Omni admite SELinux en los modos permisivo y de aplicación.

Para habilitar o inhabilitar SELinux, verifica que el archivo /etc/selinux/config se actualice en todos los nodos. Antes de iniciar el clúster, asegúrate de que la configuración de SELinux sea coherente en todos los nodos de la base de datos y los nodos del balanceador de cargas. Para verificar la configuración actual, usa el comando getenforce.

Para obtener más información, consulta Especificaciones de la política de SELinux.

Instala el organizador

Ansible

Usa este método si planeas usar libros de jugadas de Ansible para administrar tus clústeres.

  1. En tu nodo de control, instala Ansible y las bibliotecas de Python necesarias:

    # 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. Descarga el archivo tar de la colección de Ansible y su firma, verifica el paquete y, luego, instálalo:

    # 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
    

    Reemplaza ALLOYDBOMNI_SERVER por la URL del servidor en el que se alojan los paquetes de software de AlloyDB Omni, incluido el archivo tar de la colección de Ansible. Esta fuente se te proporciona después de registrarte en la versión preliminar de AlloyDB Omni con el organizador RPM Preview.

alloydbctl

Usa este método si prefieres una utilidad de línea de comandos para administrar recursos.

  1. Crea un archivo de configuración de Yum en el nodo de control en /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
    

    Reemplaza lo siguiente:

    • ALLOYDB_OMNI_ORCHESTRATOR_REPOSITORY_URL la URL del repositorio que contiene los RPM del organizador de AlloyDB Omni.
    • REPO_GPG_KEY: la ubicación de la clave pública de Google para la verificación de GNU Privacy Guard (GPG), por ejemplo, https://dl.google.com/linux/linux_signing_key.pub. También se puede configurar como una ruta de acceso si la clave se descarga en un archivo, por ejemplo, file:///tmp/linux_signing_key.pub.
  2. Instala el paquete y agrega el objeto binario a la PATH de tu sistema:

    sudo dnf install alloydbomni_orchestrator
    export PATH=$PATH:/usr/local/bin
    
  3. Ejecuta el siguiente comando para verificar la instalación:

    alloydbctl --help