Personalizar la instalación de AlloyDB Omni

Selecciona una versión de la documentación: 15.5.5

• Actual (16.8.0)
• 16.8.0
• 16.3.0
• 15.12.0
• 15.7.1
• 15.7.0
• 15.5.5
• 15.5.4
• 15.5.2

Nota: El uso que hagas de AlloyDB Omni está sujeto al acuerdo entre tú y Google que rige las ofertas de Google Cloud . Si no tienes una cuenta de Google Cloud o no has celebrado ningún otro contrato con Google que rija las ofertas de Google Cloud , no continúes ni descargues este software hasta que lo hayas hecho. Para crear una cuenta de Google Cloud , consulta la página principal Google Cloud .

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 habituales.

Para empezar a usar AlloyDB Omni rápidamente con la configuración predeterminada, consulta la guía de inicio rápido de AlloyDB Omni.

Antes de empezar

En la siguiente tabla se muestra 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 20 GB o más 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 anterior a la 5.3 que admita las directivas MADV_COLLAPSE y MADV_POPULATE_WRITE Cgroupsv2 habilitado Docker Engine 25.0.0 o una versión posterior, o Podman 5.0.0 o una versión posterior
macOS	CPU Intel con compatibilidad con AVX2 o chip M 8 GB de RAM por cada CPU asignada a AlloyDB Omni 20 GB o más 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.

Se proporcionan comandos de Podman para un contenedor sin raíz que se ejecuta en Security-Enhanced Linux (SELinux) inhabilitado.

Un solo servidor

Montar 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 gestionada por Docker. Es una forma cómoda de empezar, pero dificulta la búsqueda y el uso del directorio de datos. En su lugar, puedes configurar un montaje de enlace para asignar el directorio de datos a una ubicación conocida de tu disco.

Docker

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.5

Haz los cambios siguientes:

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

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

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

• HOST_PORT: el puerto TCP de la máquina host al que el contenedor publica el puerto 5432. Para usar el puerto predeterminado de PostgreSQL en la máquina host, especifica 5432.

Podman

podman 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.5

Haz los cambios siguientes:

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

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

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

• HOST_PORT: el puerto TCP de la máquina host al que el contenedor publica el puerto 5432. Para usar el puerto predeterminado de PostgreSQL en la máquina host, especifica 5432.

Podman

podman 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.5

Haz los cambios siguientes:

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

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

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

• HOST_PORT: el puerto TCP de la máquina host al que el contenedor publica el puerto 5432. Para usar el puerto predeterminado de PostgreSQL en la máquina host, especifica 5432.

Habilitar ulimits

Los parámetros de ulimit especifican los límites de los procesos que puede usar el contenedor de Docker. Para obtener un rendimiento óptimo, te recomendamos que definas los siguientes ulimits:

• nice=-20:-20: AlloyDB Omni ajusta las prioridades de los procesos para permitir que los procesos críticos de PostgreSQL se ejecuten con una prioridad más alta. Cuanto mayor sea la prioridad, mayor será la asignación de CPUs disponibles para los procesos. Para ajustar las prioridades de los procesos, especifica --ulimit=nice=-20:-20, que elimina las limitaciones del contenedor de AlloyDB Omni.

• memlock=-1:-1: AlloyDB Omni realiza una gestión automática de la memoria. Si se define --ulimit=memlock=-1:-1, la base de datos puede controlar mejor cómo se intercambian las páginas de memoria, lo que puede mejorar el rendimiento.

Docker

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

Podman

podman run --name CONTAINER_NAME \
-e POSTGRES_PASSWORD=NEW_PASSWORD \
--ulimit=nice=-20:-20 --ulimit=memlock=-1:-1 \
-p HOST_PORT:5432 -d google/alloydbomni:15.5.5

Especificar un controlador de registro

De forma predeterminada, Docker no realiza rotaciones de registros. Esto puede consumir mucho espacio en disco y, con el tiempo, provocar que se agote. Puedes configurar Docker para que use otro controlador de registro. Por ejemplo, para registrarte en journald, haz lo siguiente:

Docker

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

Podman

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

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

También puedes configurar el registro mediante PostgreSQL. Para obtener más información, consulta la documentación de PostgreSQL sobre informes de errores y registros.

Advertencia: Solo en AlloyDB Omni, si asignas el valor true a la marca alloydb.enable_pgaudit y el valor on al parámetro logging_collector de PostgreSQL, es posible que se pierdan registros de auditoría.

Montar un volumen de memoria compartida

Si tienes previsto 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 varía en función del sistema operativo del host, como se muestra en los siguientes ejemplos.

Linux

Para que el contenedor pueda acceder a la memoria compartida, monta /dev/shm:

Docker

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

Podman

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

macOS

Para que el contenedor pueda acceder a la memoria compartida, incluye la marca --shm-size:

Docker

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

Sustituye SHARED_MEMORY_SIZE por el tamaño que quieras asignar a /dev/shm en el contenedor, con el formato descrito en Ejecutar contenedores. Por ejemplo, para especificar un gigabyte, usa el valor 1g.

Podman

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

Sustituye SHARED_MEMORY_SIZE por el tamaño que quieras asignar a /dev/shm en el contenedor, con el formato descrito en Ejecutar contenedores. Por ejemplo, para especificar un gigabyte, usa el valor 1g.

Te recomendamos que definas el tamaño de la memoria compartida en un número de megabytes igual al valor de la marca google_job_scheduler.max_parallel_workers_per_job de tu base de datos multiplicado por 250. Para obtener más información sobre el motor de columnas, consulta Configurar el motor de columnas en AlloyDB Omni.

Por ejemplo, si la marca de base de datos google_job_scheduler.max_parallel_workers_per_job tiene el valor predeterminado 2, considera la posibilidad de añadir una marca con el valor --shm-size=500m o superior al iniciar el servidor de la base de datos.

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