Instalar o AlloyDB Omni

Selecione uma versão da documentação:

Este guia de início rápido mostra como instalar o AlloyDB Omni, que pode ser executado em qualquer ambiente baseado em UNIX que ofereça suporte a ambientes de execução de contêineres.

Para uma visão geral do AlloyDB Omni, consulte Visão geral do AlloyDB Omni.

Antes de começar

Escolher uma opção de download ou instalação

Mídia Locais de download e guias de instalação Implantação em
Imagem do Debian DockerHub (tags)
  • Docker, Podman. É possível executar essas ferramentas de contêinerização como um contêiner em qualquer máquina virtual (VM).
Imagem UBI (Red Hat) Red Hat Ecosystem Catalog
  • Ambiente Red Hat. Execute como um contêiner.

Atender aos requisitos de hardware e software

Verifique se você atende aos seguintes requisitos mínimos de hardware e software:

SO/plataforma Hardware mínimo Software mínimo
Linux
  • CPU x86-64 ou Arm (*) com suporte a AVX2
  • 2 GB de RAM
  • 10 GB de espaço em disco
    		•
  • SO baseado em Debian (Ubuntu etc.), RHEL 8 ou 9
  • Versão do kernel do Linux 5.3 ou mais recente
  • Cgroupsv2 ativado
  • Docker Engine 20.10 ou mais recente ou Podman 4.2.0 ou mais recente
    		•
    macOS
  • CPU Intel com suporte a AVX2 ou chip M
  • 2 GB de RAM
  • 10 GB de espaço em disco
    		•
  • Docker Desktop 4.20 ou mais recente
    		•
    (*) O AlloyDB Omni oferece suporte ao Arm (prévia).

    Verificar se o cgroupsv2 está ativado

    Para determinar se o cgroupsv2 está ativado na sua máquina, execute o seguinte comando:

    grep cgroup /proc/filesystems

    Se a máquina oferecer suporte ao cgroupsv2, você verá a seguinte saída:

    nodev cgroup
nodev cgroupsv2

    Se a máquina não oferecer suporte ao cgroupsv2, você verá a seguinte saída:

    nodev cgroup

    Instalar um ambiente de execução de contêiner

    Instale um ambiente de execução de contêiner, como o Docker ou o Podman. O AlloyDB Omni é executado em um contêiner.

    Instalar o AlloyDB Omni usando o Docker

    O acesso root não é necessário para instalar o AlloyDB Omni.

    Docker

    1. Use o comando docker run para criar um novo contêiner com o AlloyDB Omni chamado my-omni:

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

      Substitua NEW_PASSWORD por uma senha para atribuir ao novo usuário postgres do contêiner após a criação.

    2. Conecte-se ao AlloyDB Omni em contêiner usando psql:

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

      A janela do terminal mostra o texto de login psql que termina com um postgres=# prompt.

    Podman

    1. Use o comando docker run para criar um novo contêiner com o AlloyDB Omni chamado my-omni:

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

      Substitua NEW_PASSWORD por uma senha para atribuir ao novo usuário postgres do contêiner após a criação.

    2. Conecte-se ao AlloyDB Omni em contêiner usando psql:

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

      A janela do terminal mostra o texto de login psql que termina com um prompt postgres=#.

    Limpar

    Para limpar o contêiner do AlloyDB Omni criado durante este guia de início rápido, siga estas etapas:

    Docker

    1. Interrompa o contêiner do AlloyDB Omni chamado my-omni:

        docker container stop my-omni

    2. Exclua o contêiner do AlloyDB Omni chamado my-omni:

        docker container rm my-omni

    Podman

    1. Interrompa o contêiner do AlloyDB Omni chamado my-omni:

        podman container stop my-omni

    2. Exclua o contêiner do AlloyDB Omni chamado my-omni:

        podman container rm my-omni

    Para instruções sobre como instalar o AlloyDB Omni em um novo contêiner para uso em produção, acesse a página Personalizar a instalação do AlloyDB Omni.

    A seguir