En esta página, se documenta la versión 15.5.2 de AlloyDB Omni con la opción de implementación de Kubernetes. Elige otra opción de implementación.

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

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 usando 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 física o virtual que ejecute un SO basado en Debian, como Debian o Ubuntu.
Un mínimo de 2 CPU, con arquitectura x86/AMD64
Al menos 2 GB de RAM. Para obtener un rendimiento óptimo, te recomendamos que asignes 8 GB de RAM a 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 del kernel 5.3 o posterior 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 un shell. Si cgroup v2 está habilitado, el resultado del comando muestra cgroup2fs.
Si deseas realizar la integración con Vertex AI, necesitas Google Cloud CLI disponible en tu entorno.
Para instalar AlloyDB Omni en una plataforma de nube, te recomendamos que uses los siguientes tipos de instancias:
- En Google Cloud, recomendamos instancias n2-highmem.
- En Amazon Web Services, recomendamos las instancias R6i.
- En Microsoft Azure, recomendamos instancias Ebsv5.
Te recomendamos que uses un dispositivo de almacenamiento SSD exclusivo para almacenar tus datos. Si usas un dispositivo físico para este propósito, te recomendamos que lo conectes 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 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
Al menos 2 GB de RAM. Para obtener un rendimiento óptimo, te recomendamos que asignes 8 GB de RAM a 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 Para obtener el mejor rendimiento, te recomendamos la versión del kernel 5.3 o una posterior.
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 un shell. Si cgroup v2 está habilitado, el resultado del comando muestra cgroup2fs.
Si deseas realizar la integración con Vertex AI, necesitas Google Cloud CLI disponible en tu entorno.
Para instalar AlloyDB Omni en una plataforma de nube, te recomendamos que uses los siguientes tipos de instancias:
- En Google Cloud, recomendamos instancias n2-highmem.
- En Amazon Web Services, recomendamos las instancias R6i.
- En Microsoft Azure, recomendamos instancias Ebsv5.
Te recomendamos que uses un dispositivo de almacenamiento SSD exclusivo para almacenar tus datos. Si usas un dispositivo físico para este propósito, te recomendamos que lo conectes directamente a la máquina anfitrión.

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 tu sistema hasta que el resultado del comando system-check muestre una verificación exitosa.
Opcional: Para crear una nueva partición de disco que AlloyDB Omni pueda usar 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 grandes (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 usará /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 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 usará /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.
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 la 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=#.