Instalar AlloyDB Omni

Selecciona una versión de la documentación:

En esta guía de inicio rápido, se muestra cómo instalar AlloyDB Omni, que se puede ejecutar en cualquier entorno basado en UNIX que admita entornos de ejecución de contenedores.

Para obtener una descripción general de AlloyDB Omni, consulta Descripción general de AlloyDB Omni.

Antes de comenzar

Antes de instalar AlloyDB Omni, asegúrate de cumplir con los siguientes requisitos.

Elige una opción de descarga o instalación

Medios Ubicaciones de descarga y guías de instalación Implementación en
Imagen de Debian DockerHub (etiquetas)
  • Docker, Podman. Puedes ejecutar estas herramientas de creación de contenedores como un contenedor en cualquier máquina virtual (VM).
Imagen de UBI (Red Hat) Catálogo del ecosistema de Red Hat
  • entorno de Red Hat. Ejecuta esto como un contenedor.

Cumple con los requisitos de hardware y software

Asegúrate de cumplir con los siguientes requisitos mínimos de hardware y software:

SO o plataforma Hardware mínimo Software mínimo
Linux
  • CPU x86-64 o Arm (*) con compatibilidad con AVX2
  • 2 GB de RAM
  • 10 GB de espacio en el disco
    		•
  • SO basado en Debian (Ubuntu, etc.), RHEL 8 o 9
  • Versión de kernel de Linux 5.3 o posterior
  • Cgroupsv2 habilitado
  • Docker Engine 20.10 o versiones posteriores, o Podman 4.2.0 o versiones posteriores
    		•
    macOS
  • CPU Intel con compatibilidad con AVX2 o chip M
  • 2 GB de RAM
  • 10 GB de espacio en el disco
    		•
  • Docker Desktop 4.20 o una versión posterior
    		•
    (*) La compatibilidad con Arm se encuentra en versión preliminar.

    Verifica que cgroupsv2 esté habilitado

    Para determinar si cgroupsv2 está habilitado en tu máquina, ejecuta el siguiente comando:

    grep cgroup /proc/filesystems

    Si tu máquina admite cgroupsv2, verás el siguiente resultado:

    nodev cgroup
nodev cgroupsv2

    Si tu máquina no admite cgroupsv2, verás el siguiente resultado:

    nodev cgroup

    Instala un entorno de ejecución de contenedores

    Instala un entorno de ejecución de contenedores, como Docker o Podman. AlloyDB Omni se ejecuta en un contenedor.

    Instala AlloyDB Omni con Docker

    No se requiere acceso raíz para instalar AlloyDB Omni.

    Docker

    1. Usa el comando docker run para crear un contenedor nuevo con AlloyDB Omni llamado my-omni:

        docker run --name my-omni \
    -e POSTGRES_PASSWORD=NEW_PASSWORD \
    -d google/alloydbomni:IMAGE_TAG

      Reemplaza lo siguiente:

      • NEW_PASSWORD: Es una contraseña que se asignará al usuario postgres del contenedor recién creado.

      • IMAGE_TAG: Es la etiqueta de la imagen, por ejemplo, 18.3.0 para la imagen de Debian más reciente o 18.3.0-ubi9 para la imagen de UBI más reciente.

    2. Conéctate a AlloyDB Omni alojado en contenedores con psql:

        docker exec -it my-omni psql -h localhost -U postgres

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

    Podman

    1. Usa el comando podman run para crear un contenedor nuevo con AlloyDB Omni llamado my-omni:

        podman run --name my-omni \
    -e POSTGRES_PASSWORD=NEW_PASSWORD \
    -d google/alloydbomni:IMAGE_TAG

      Reemplaza lo siguiente:

      • NEW_PASSWORD: Es una contraseña que se asignará al usuario postgres del contenedor recién creado.

      • IMAGE_TAG: Es la etiqueta de la imagen, por ejemplo, 18.3.0 para la imagen de Debian más reciente o 18.3.0-ubi9 para la imagen de UBI más reciente.

    2. Conéctate a AlloyDB Omni alojado en contenedores con psql:

        podman exec -it my-omni psql -h localhost -U postgres

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

    Realiza una limpieza

    Para limpiar el contenedor de AlloyDB Omni que creaste durante esta guía de inicio rápido, sigue estos pasos:

    Docker

    1. Detén el contenedor de AlloyDB Omni llamado my-omni:

        docker container stop my-omni

    2. Borra tu contenedor de AlloyDB Omni llamado my-omni:

        docker container rm my-omni

    Podman

    1. Detén el contenedor de AlloyDB Omni llamado my-omni:

        podman container stop my-omni

    2. Borra tu contenedor de AlloyDB Omni llamado my-omni:

        podman container rm my-omni

    Si quieres obtener instrucciones para instalar AlloyDB Omni en un contenedor nuevo para usarlo en producción, consulta la página Personaliza tu instalación de AlloyDB Omni.

    ¿Qué sigue?