En esta página, se muestra la documentación de la versión 15.5.2 de AlloyDB Omni. Para obtener documentación de la versión más reciente de AlloyDB Omni, haz clic aquí.

Se usó la API de Cloud Translation para traducir esta página.

Personaliza la instalación de AlloyDB Omni

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

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

Crea una nueva partición de disco para optimizar el almacenamiento de datos.
Configura tu servidor.
Garantiza 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 Ubuntu o Debian.
Un mínimo de 2 CPUs, con arquitectura x86/AMD64
Al menos 2 GB de RAM. Para obtener un rendimiento óptimo, te recomendamos asignar 8 GB de RAM para cada CPU.
Al menos 20 GB de almacenamiento disponible
Acceso raíz sin restricciones dentro del SO
Docker versión 20.10 o superior
Versión 4.18 o posterior del kernel de Linux Para obtener un mejor rendimiento, te recomendamos que uses la versión 5.3 del kernel o una posterior.
Se habilitó cgroup v2 de Linux.
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 un shell. Si cgroup v2 está habilitado, el resultado del comando muestra cgroup2fs.
Si deseas realizar la integración con Vertex AI, debes tener la Google Cloud CLI 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 de R6i.
- En Microsoft Azure, recomendamos Ebsv5 instancias.
Te recomendamos que uses un dispositivo de almacenamiento SSD dedicado para almacenar tus datos. Si usas un dispositivo físico para este fin, te recomendamos que lo conectes directamente a la máquina host.

RHEL

Una máquina virtual o física que ejecute Red Hat Enterprise Linux (RHEL) versión 8 o posterior Para que funcionen las funciones de administración automática de la memoria de AlloyDB Omni, usa RHEL versión 9 o una posterior.
Un mínimo de 2 CPUs, con arquitectura x86/AMD64
Al menos 2 GB de RAM. Para obtener un rendimiento óptimo, te recomendamos asignar 8 GB de RAM para cada CPU.
Al menos 20 GB de almacenamiento disponible
Acceso raíz sin restricciones dentro del SO
Docker versión 20.10 o superior
Versión 4.18 o posterior del kernel de Linux Para obtener un mejor rendimiento, te recomendamos que uses la versión 5.3 del kernel o una posterior.
Se habilitó cgroup v2 de Linux.
De forma predeterminada, cgroup v2 está habilitado en la mayoría de los sistemas Linux modernos. Para verificar si el cgroup v2 está habilitado, ejecuta stat -fc %T /sys/fs/cgroup/ en un shell. Si cgroup v2 está habilitado, el resultado del comando muestra cgroup2fs.
Si deseas realizar la integración con Vertex AI, debes tener la Google Cloud CLI 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 de R6i.
- En Microsoft Azure, recomendamos Ebsv5 instancias.
Te recomendamos que uses un dispositivo de almacenamiento SSD dedicado para almacenar tus datos. Si usas un dispositivo físico para este fin, te recomendamos que lo conectes directamente a la máquina host.

Descarga e instala AlloyDB Omni

Instala la CLI de AlloyDB Omni.
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 el sistema hasta que el resultado del comando system-check muestre una verificación correcta.
Opcional: Para crear una nueva partición de disco que AlloyDB Omni 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"
```
Instala el software del servidor con una de las siguientes opciones:

Nota: Para instalar AlloyDB Omni con las funciones de aprendizaje automático (AA) habilitadas, incluida la capacidad de consultar modelos de lenguaje extensos (LLM), consulta Cómo instalar AlloyDB Omni con AlloyDB AI.
- 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 se establece de forma predeterminada en /var/alloydb/main/.
  
  Para que AlloyDB Omni escuche conexiones en un puerto TCP distinto del 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 en 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 se establece de forma predeterminada en /var/alloydb/main/.
  - SOURCE_IP: Es la dirección IP de la instancia principal de AlloyDB Omni desde la que se replicará.
  - SOURCE_PORT: Es el puerto TCP de la instancia principal de AlloyDB Omni desde la que se replicará. 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.
Si tu sistema ejecuta Red Hat Enterprise Linux, actualiza el archivo /usr/lib/tuned/virtual-guest/tuned.conf con lo siguiente:
```
vm.swappiness=1
```

Cómo conectarse al servidor de la base de datos y usarlo

Conéctate a AlloyDB Omni con psql:

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

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