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 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 contenedorización 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/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étera) RHEL 8 o 9
  • Versión 5.3 o posterior del kernel de Linux
  • Cgroupsv2 habilitado
  • Docker Engine 20.10 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 disco
  • Docker Desktop 4.20 o versiones posteriores
  • (*) 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 contenedor

    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 de administrador 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 las siguientes variables:

      • NEW_PASSWORD: Es la contraseña que se asignará al usuario postgres del contenedor nuevo después de su creación.
      • IMAGE_TAG: Usa 16.8.0 para la imagen de Debian más reciente o 16.8.0-ubi para la imagen de UBI más reciente.

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

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

      En la ventana de la terminal, se muestra el texto de acceso 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:IMAGE_TAG

      Reemplaza las siguientes variables:

      • NEW_PASSWORD: Es la contraseña que se asignará al usuario postgres del contenedor nuevo después de su creación.
      • IMAGE_TAG: Usa 16.3.0 para la imagen de Debian más reciente o 16.3.0-ubi para la imagen de UBI más reciente.

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

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

      En la ventana de la terminal, se muestra el texto de acceso 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 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

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

    ¿Qué sigue?