Personalizar la instalación de AlloyDB Omni

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

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

• Crea una partición de disco para optimizar el almacenamiento de datos.
• Configura tu servidor.
• Asegúrate de que sea compatible con Debian, Ubuntu y RHEL.

Antes de empezar

Descargar e instalar 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 devuelva una comprobación correcta.

3. Opcional: Para crear una partición de disco nueva que AlloyDB Omni pueda usar para almacenar 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 montar 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 instancia principal, ejecuta el siguiente comando:

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

     Sustituye DATA_DIR por el directorio del sistema de archivos local en el que quieras 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 usará /var/alloydb/main/ de forma predeterminada.

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

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

     Sustituye PORT por el puerto TCP en el que quieres que AlloyDB Omni acepte conexiones.

   • Para configurar el servidor como 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

     Haz los cambios siguientes:

     • DATA_DIR: el directorio de tu sistema de archivos local en el que quieres 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 usará /var/alloydb/main/ de forma predeterminada.

     • SOURCE_IP: la dirección IP de la instancia principal de AlloyDB Omni desde la que se va a replicar.

     • SOURCE_PORT: el puerto TCP de la instancia principal de AlloyDB Omni desde la que se va a replicar. Si no proporciona este valor, AlloyDB Omni aplicará el valor predeterminado 5432.

     Para obtener más información sobre las réplicas de lectura de AlloyDB Omni, consulta Crear 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
   

Conectarse al servidor de bases de datos y usarlo

Conéctate a AlloyDB Omni mediante psql:

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

La ventana de la terminal muestra el texto de inicio de sesión psql que termina con un prompt postgres=#.