Personaliza la instalación de AlloyDB Omni

Selecciona una versión de la documentación:

AlloyDB Omni se implementa a través de una imagen de Docker, lo que permite diferentes formas de personalización. En esta página, se muestran algunas de las personalizaciones comunes que se usan.

Para comenzar rápidamente con AlloyDB Omni con la configuración predeterminada, consulta Inicio rápido: AlloyDB Omni.

Antes de comenzar

En la siguiente tabla, se enumeran la configuración de hardware y software recomendada para AlloyDB Omni.

SO/plataforma Configuración de hardware recomendada Configuración de software recomendada
Linux
  • CPU x86-64 o Arm (*) con compatibilidad con AVX2
  • 8 GB de RAM por cada CPU asignada a AlloyDB Omni
  • Más de 20 GB de espacio en disco
    		•
  • SO basado en Debian (Ubuntu, etc.) o RHEL 9
  • Versión 6.1 o posterior del kernel de Linux, o cualquier versión del kernel de Linux anterior a la 5.3 que admita las directivas MADV_COLLAPSE y MADV_POPULATE_WRITE
  • Cgroupsv2 habilitado
  • Docker Engine 25.0.0+ o Podman 5.0.0+
    		•
    macOS
  • CPU Intel con compatibilidad con AVX2 o chip M
  • 8 GB de RAM por cada CPU asignada a AlloyDB Omni
  • Más de 20 GB de espacio en disco
    		•
  • Docker Desktop 4.30 o versiones posteriores
    		•
    (*) La compatibilidad con Arm está en versión preliminar.

    AlloyDB Omni se ejecuta en un contenedor. Instala un entorno de ejecución de contenedores como Docker o Podman en tu máquina antes de instalar AlloyDB Omni.

    Servidor único

    Activa un directorio de datos externo

    De forma predeterminada, el comando de la guía de inicio rápido para instalar AlloyDB Omni almacena los datos de la base de datos en un área administrada por Docker. Esto es conveniente para comenzar, pero dificulta encontrar y usar el directorio de datos. En su lugar, puedes configurar una activación de vinculación para asignar el directorio de datos a una ubicación conocida en tu disco.

    docker run --name CONTAINER_NAME \
-e POSTGRES_PASSWORD=NEW_PASSWORD \
-v DATA_DIR:/var/lib/postgresql/data \
-p HOST_PORT:5432 -d google/alloydbomni:15.5.4

    Reemplaza lo siguiente:

    • CONTAINER_NAME: Es el nombre que se asignará a este nuevo contenedor de AlloyDB Omni en el registro de contenedores de tu máquina anfitrión, por ejemplo, my-omni.

    • NEW_PASSWORD: Es la contraseña asignada al usuario postgres del contenedor nuevo después de su creación.

    • DATA_DIR: Es la ruta de acceso del sistema de archivos que deseas que AlloyDB Omni use para su directorio de datos.

    • HOST_PORT: Es el puerto TCP en la máquina anfitrión al que el contenedor debe publicar su propio puerto 5432. Para usar también el puerto predeterminado de PostgreSQL en la máquina anfitrión, especifica 5432.

    Habilita ulimits

    Los parámetros ulimit especifican varios límites de proceso que el contenedor de Docker puede usar. Para un rendimiento óptimo, AlloyDB Omni ajusta las prioridades de los procesos para permitir que los procesos críticos de PostgreSQL se ejecuten con mayor prioridad, es decir, obtienen una mayor asignación de CPUs disponibles. Para permitir esto, especifica -20:-20, que quita las limitaciones para el contenedor de AlloyDB Omni.

    docker run --name CONTAINER_NAME \
-e POSTGRES_PASSWORD=NEW_PASSWORD \
--ulimit=nice=-20:-20 \
-p HOST_PORT:5432 -d google/alloydbomni:15.5.4

    Especifica un controlador de registro

    De forma predeterminada, Docker no realiza rotaciones de registros. Esto puede ocupar mucho espacio en disco y, finalmente, provocar el agotamiento del espacio en disco. Puedes configurar Docker para que use un controlador de registro diferente. Por ejemplo, para registrar en journald, haz lo siguiente:

    docker run --name CONTAINER_NAME \
-e POSTGRES_PASSWORD=NEW_PASSWORD \
--log-driver=journald \
-p HOST_PORT:5432 -d google/alloydbomni:15.5.4

    Para obtener más información sobre Docker y los controladores de registro, consulta la documentación de Docker Configura los controladores de registro.

    También puedes configurar el registro con PostgreSQL. Para obtener más información, consulta la documentación de PostgreSQL Informes de errores y registro.

    Activa un volumen de memoria compartida

    Si planeas usar el motor de columnas de AlloyDB con AlloyDB Omni, te recomendamos que pongas la memoria compartida a disposición del contenedor de AlloyDB Omni. El método para hacerlo difiere según el sistema operativo host, como se muestra en los siguientes ejemplos.

    Linux

    Para que la memoria compartida esté disponible para el contenedor, activa /dev/shm:

       docker run --name CONTAINER_NAME \
     -e POSTGRES_PASSWORD=NEW_PASSWORD \
     -p HOST_PORT:5432 \
     -v /dev/shm:/dev/shm \
     -d google/alloydbomni:15.5.4

    macOS

    Para que la memoria compartida esté disponible para el contenedor, incluye la marca --shm-size:

     docker run --name CONTAINER_NAME \
    -e POSTGRES_PASSWORD=NEW_PASSWORD \
    -p HOST_PORT:5432 \
    --shm-size=SHARED_MEMORY_SIZE \
    -d google/alloydbomni:15.5.4

    Reemplaza SHARED_MEMORY_SIZE por el tamaño que se establecerá para /dev/shm en el contenedor, en el formato que se describe en Ejecuta contenedores. Por ejemplo, para especificar un gigabyte, usa el valor 1g.

    Te recomendamos que establezcas el tamaño de la memoria compartida en una cantidad de megabytes igual a al menos el valor de la marca de tu base de datos google_job_scheduler.max_parallel_workers_per_job, multiplicado por 250. Para obtener más información sobre el motor de columnas, consulta Configura el motor de columnas en AlloyDB Omni.

    Por ejemplo, si la marca de base de datos google_job_scheduler.max_parallel_workers_per_job está establecida en su valor predeterminado de 2, considera agregar una marca de --shm-size=500m o superior cuando inicies el servidor de la base de datos.

    Para obtener más información sobre la marca --shm-size, consulta Ejecuta contenedores.