Instalar AlloyDB Omni

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.

  • Cumple con 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 el disco
    		•
  • SO basado en Debian (Ubuntu, etcétera) RHEL 8 o 9
  • Versión 5.3 o posterior del kernel de Linux
  • 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.

    Determina si cgroupsv2 está habilitado en tu máquina

    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

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

Instala AlloyDB Omni con Docker

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:16

    Reemplaza NEW_PASSWORD por una contraseña para asignar el usuario postgres del contenedor nuevo después de su creación.

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

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

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

Podman

  1. Usa el comando docker 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:16

    Reemplaza NEW_PASSWORD por una contraseña para asignar el usuario postgres del contenedor nuevo después de su creación.

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

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

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

Limpia

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 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. Borra el contenedor de AlloyDB Omni llamado my-omni:

      podman container rm my-omni

Para obtener instrucciones sobre cómo instalar AlloyDB Omni en un contenedor nuevo para el uso en producción, ve a la página Cómo personalizar la instalación de AlloyDB Omni.

¿Qué sigue?