Personaliza la instalación de AlloyDB Omni

Selecciona una versión de la documentación:

En esta página, se muestra cómo descargar, instalar y conectarse a AlloyDB Omni. Para comenzar rápidamente con AlloyDB Omni con la configuración predeterminada, consulta Instala AlloyDB Omni en Debian o Ubuntu.

En este documento, también aprenderás a hacer lo siguiente:

  • Crear una nueva partición de disco para optimizar el almacenamiento de datos
  • Configurar tu servidor
  • Garantizar la compatibilidad con Debian, Ubuntu y RHEL

Antes de comenzar

Requisitos del sistema

Debian

  • Una máquina virtual o física que ejecute un SO basado en Debian, como Debian o Ubuntu.
  • Un mínimo de 2 CPU, con arquitectura x86/AMD64
  • Un mínimo de 2 GB de RAM Para un rendimiento óptimo, te recomendamos que asignes 8 GB de RAM por cada CPU.
  • Al menos 20 GB de almacenamiento disponible
  • Acceso raíz sin restricciones dentro del SO
  • Docker versión 20.10 o posterior
  • Versión 4.18 o posterior del kernel de Linux Recomendamos la versión 5.3 o posterior del kernel para obtener el mejor rendimiento.
  • cgroup v2 de Linux habilitado

    De forma predeterminada, cgroup v2 está habilitado en la mayoría de los sistemas Linux modernos. Para verificar si cgroup v2 está habilitado, ejecuta stat -fc %T /sys/fs/cgroup/ en una shell. Si cgroup v2 está habilitado, el resultado del comando muestra cgroup2fs.

  • Si deseas realizar la integración con Vertex AI, necesitas que la Google Cloud CLI esté disponible en tu entorno.

  • Para instalar AlloyDB Omni en una plataforma en la nube, te recomendamos que uses los siguientes tipos de instancias:
    • En Google Cloud, recomendamos n2-highmem instancias.
    • En Amazon Web Services, recomendamos instancias R6i.
    • En Microsoft Azure, recomendamos instancias Ebsv5.
  • Te recomendamos que uses un dispositivo de almacenamiento SSD dedicado para almacenar tus datos. Si usas un dispositivo físico para este propósito, te recomendamos conectarlo directamente a la máquina anfitrión.

RHEL

  • Una máquina virtual o física que ejecute Red Hat Enterprise Linux (RHEL) versión 8 o posterior Para permitir que funcionen las funciones de administración automática de memoria de AlloyDB Omni, usa RHEL versión 9 o posterior.
  • Un mínimo de 2 CPU, con arquitectura x86/AMD64
  • Un mínimo de 2 GB de RAM Para un rendimiento óptimo, te recomendamos que asignes 8 GB de RAM por cada CPU.
  • Al menos 20 GB de almacenamiento disponible
  • Acceso raíz sin restricciones dentro del SO
  • Docker versión 20.10 o posterior
  • Versión 4.18 o posterior del kernel de Linux Recomendamos la versión 5.3 o posterior del kernel para obtener el mejor rendimiento.
  • cgroup v2 de Linux habilitado

    De forma predeterminada, cgroup v2 está habilitado en la mayoría de los sistemas Linux modernos. Para verificar si cgroup v2 está habilitado, ejecuta stat -fc %T /sys/fs/cgroup/ en una shell. Si cgroup v2 está habilitado, el resultado del comando muestra cgroup2fs.

  • Si deseas realizar la integración con Vertex AI, necesitas que la Google Cloud CLI esté disponible en tu entorno.

  • Para instalar AlloyDB Omni en una plataforma en la nube, te recomendamos que uses los siguientes tipos de instancias:
    • En Google Cloud, recomendamos n2-highmem instancias.
    • En Amazon Web Services, recomendamos instancias R6i.
    • En Microsoft Azure, recomendamos instancias Ebsv5.
  • Te recomendamos que uses un dispositivo de almacenamiento SSD dedicado para almacenar tus datos. Si usas un dispositivo físico para este propósito, te recomendamos conectarlo directamente a la máquina anfitrión.

Descarga e instala AlloyDB Omni

  1. Instala la CLI de AlloyDB Omni.

  2. Usa la CLI de AlloyDB Omni para confirmar que tu máquina Linux esté lista para instalar AlloyDB Omni:

    sudo alloydb system-check

    Si es necesario, modifica tu sistema hasta que el resultado del comando system-check muestre una verificación correcta.

  3. Opcional: Para crear una nueva partición de disco para que AlloyDB Omni la use para el almacenamiento de datos, te recomendamos que uses un sistema de archivos ext4 para obtener un rendimiento óptimo.

    1. Para crear un sistema de archivos ext4, usa el siguiente comando:

      mkfs.ext4 -m 1 -F "$disk_path"
    2. Para activar el disco, usa el siguiente comando:

      mount --make-shared -o noatime,discard,errors=panic "$disk_path" "$disk_mountpoint"
  4. Instala el software del servidor con una de las siguientes opciones:

    • Para configurar el servidor como una instancia principal, ejecuta el siguiente comando:

      sudo alloydb database-server install --data-dir=$(realpath DATA_DIR)

      Reemplaza DATA_DIR por el directorio de tu sistema de archivos local en el que deseas que AlloyDB Omni almacene sus datos, metadatos y archivos de configuración. AlloyDB Omni intenta crear este directorio si aún no existe. Si no especificas este valor, AlloyDB Omni usa /var/alloydb/main/ de forma predeterminada.

      Para que AlloyDB Omni escuche las conexiones en un puerto TCP que no sea el 5432 predeterminado, incluye la marca --pg-port:

      sudo alloydb database-server install \
          --data-dir=$(realpath DATA_DIR) \
          --pg-port=PORT

      Reemplaza PORT por el puerto TCP en el que deseas que AlloyDB Omni acepte conexiones.

    • Para configurar el servidor como una réplica de lectura, incluye las marcas --replica-source-ip y --replica-source-port:

      sudo alloydb database-server install \
          --data-dir=$(realpath DATA_DIR) \
          --replica-source-ip=SOURCE_IP \
          --replica-source-port=SOURCE_PORT

      Reemplaza lo siguiente:

      • DATA_DIR: Es el directorio de tu sistema de archivos local en el que deseas que AlloyDB Omni almacene sus datos, metadatos y archivos de configuración. AlloyDB Omni intenta crear este directorio si aún no existe. Si no especificas este valor, AlloyDB Omni usa /var/alloydb/main/ de forma predeterminada.

      • SOURCE_IP: Es la dirección IP de la instancia principal de AlloyDB Omni desde la que se realizará la replicación.

      • SOURCE_PORT: Es el puerto TCP de la instancia principal de AlloyDB Omni desde la que se realizará la replicación. Si no proporcionas este valor, AlloyDB Omni aplica un valor predeterminado de 5432.

      Para obtener más información sobre las réplicas de lectura de AlloyDB Omni, consulta Crea una réplica de solo lectura.

  5. Si tu sistema ejecuta Red Hat Enterprise Linux, actualiza el archivo /usr/lib/tuned/virtual-guest/tuned.conf con lo siguiente:

    vm.swappiness=1
    

Conéctate al servidor de base de datos y úsalo

Conéctate a AlloyDB Omni con psql:

sudo docker exec -it pg-service psql -h localhost -U postgres

En la ventana de la terminal, se muestra el texto de acceso psql que termina con un mensaje postgres=#.