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

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 de ecossistemas do Red Hat
  • 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 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 mais recente
    		•
    (*) 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 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:IMAGE_TAG

      Substitua as seguintes variáveis:

      • NEW_PASSWORD: a senha a ser atribuída ao novo usuário do contêiner após a criação.postgres

      • IMAGE_TAG: use 16.8.0 para a imagem mais recente do Debian ou 16.8.0-ubi para a imagem UBI mais recente.

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

      Substitua as seguintes variáveis:

      • NEW_PASSWORD: a senha a ser atribuída ao novo usuário do contêiner após a criação.postgres

      • IMAGE_TAG: use 16.3.0 para a imagem mais recente do Debian ou 16.3.0-ubi para a imagem UBI mais recente.

    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