Instalar o AlloyDB Omni

Selecione uma versão da documentação:

Neste guia de início rápido, mostramos como instalar o AlloyDB Omni, que pode ser executado em qualquer ambiente baseado em UNIX compatível com 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

Antes de instalar o AlloyDB Omni, verifique se você atende aos requisitos a seguir.

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) Catálogo do ecossistema da Red Hat
  • ambiente Red Hat. Execute isso 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 5.3 ou mais recente do kernel do Linux
  • 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 versões mais recentes
  • (*) O suporte ao Arm está em Pré-lançamento.

    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 for compatível com cgroupsv2, você verá a seguinte saída:

    nodev cgroup
    nodev cgroupsv2
    

    Se a máquina não for compatível com cgroupsv2, você vai ver a seguinte saída:

    nodev cgroup
    

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

    Instale um ambiente de execução de contêineres, como Docker ou 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:IMAGE_TAG

      Substitua as seguintes variáveis:

      • NEW_PASSWORD: a senha a ser atribuída ao novo usuário postgres do contêiner após a criação.
      • IMAGE_TAG: use 16.8.0 para a imagem mais recente do Debian ou 16.8.0-ubi para a imagem mais recente do UBI.

    2. Conecte-se ao AlloyDB Omni em contêineres 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 comando postgres=#.

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

      Substitua as seguintes variáveis:

      • NEW_PASSWORD: a senha a ser atribuída ao novo usuário postgres do contêiner após a criação.
      • IMAGE_TAG: use 16.3.0 para a imagem mais recente do Debian ou 16.3.0-ubi para a imagem mais recente do UBI.

    2. Conecte-se ao AlloyDB Omni em contêineres 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 comando 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