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 tiempos de ejecución de contenedores.

Para obtener una descripción general de AlloyDB Omni, consulta el artículo Descripción general de AlloyDB Omni.

Antes de empezar

Elige una opción de descarga o instalación

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

Cumplir los requisitos de hardware y software

Asegúrate de que cumples los siguientes requisitos mínimos de hardware y software:

SO/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 disco
    		•
  • SO basado en Debian (Ubuntu, etc.) RHEL 8 o 9
  • Versión 5.3 o posterior del kernel de Linux
  • Cgroupsv2 habilitado
  • Docker Engine 20.10 o una versión posterior, o Podman 4.2.0 o una versión posterior
    		•
    macOS
  • CPU Intel con compatibilidad con AVX2 o chip M
  • 2 GB de RAM
  • 10 GB de espacio en disco
    		•
  • Docker Desktop 4.20 o una versión posterior
    		•
    (*) AlloyDB Omni es compatible con Arm (versión preliminar).

    Verificar 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 es compatible con cgroupsv2, verás el siguiente resultado:

    nodev cgroup

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

    Instalar AlloyDB Omni con Docker

    No es necesario tener acceso root para instalar AlloyDB Omni.

    Docker

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

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

      Sustituye NEW_PASSWORD por una contraseña para asignar el usuario postgres del nuevo contenedor después de crearlo.

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

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

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

    Podman

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

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

      Sustituye NEW_PASSWORD por una contraseña para asignar el usuario postgres del nuevo contenedor después de crearlo.

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

      podman exec -it my-omni 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=#.

    Limpieza

    Para limpiar el contenedor de AlloyDB Omni que has creado 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. Elimina el 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. Elimina el contenedor de AlloyDB Omni llamado my-omni:

        podman container rm my-omni

    Para obtener instrucciones sobre cómo instalar AlloyDB Omni en un nuevo contenedor para usarlo en producción, consulta la página Personalizar la instalación de AlloyDB Omni.

    Siguientes pasos