Personalize a instalação do AlloyDB Omni

Selecione uma versão da documentação:

Esta página mostra como transferir, instalar e estabelecer ligação ao AlloyDB Omni. Para começar rapidamente a usar o AlloyDB Omni com a configuração predefinida, consulte o artigo Instale o AlloyDB Omni no Debian ou Ubuntu.

Neste documento, também fica a saber como fazer o seguinte:

  • Crie uma nova partição do disco para otimizar o armazenamento de dados.
  • Configure o servidor.
  • Garanta a compatibilidade com o Debian, o Ubuntu e o RHEL.

Antes de começar

Requisitos de sistema

Debian

  • Uma máquina virtual ou física com um SO baseado em Debian, como o Debian ou o Ubuntu.
  • Um mínimo de 2 CPUs com arquitetura x86/AMD64.
  • Um mínimo de 2 GB de RAM. Para um desempenho ideal, recomendamos que alocar 8 GB de RAM para cada CPU.
  • Pelo menos, 20 GB de armazenamento disponível.
  • Acesso root sem restrições no SO.
  • Docker versão 20.10 ou superior.
  • Versão 4.18 ou superior do kernel do Linux. Recomendamos a versão do kernel 5.3 ou superior para o melhor desempenho.
  • O cgroup v2 do Linux está ativado.

    Por predefinição, o cgroup v2 está ativado na maioria dos sistemas Linux modernos. Para verificar se o cgroup v2 está ativado, execute stat -fc %T /sys/fs/cgroup/ numa shell. Se o cgroup v2 estiver ativado, o resultado do comando mostra cgroup2fs.

  • Se quiser fazer a integração com o Vertex AI, precisa da CLI do Google Cloud disponível no seu ambiente.

  • Para instalar o AlloyDB Omni numa plataforma de nuvem, recomendamos que use os seguintes tipos de instâncias:
    • No Google Cloud, recomendamos n2-highmem instâncias.
    • Nos Amazon Web Services, recomendamos instâncias R6i.
    • No Microsoft Azure, recomendamos instâncias Ebsv5.
  • Recomendamos que use um dispositivo de armazenamento SSD dedicado para armazenar os seus dados. Se usar um dispositivo físico para este fim, recomendamos que o ligue diretamente à máquina anfitriã.

RHEL

  • Uma máquina virtual ou física com uma versão 8 ou posterior do Red Hat Enterprise Linux (RHEL). Para permitir que as funcionalidades de gestão de memória automática do AlloyDB Omni funcionem, use a versão 9 ou posterior do RHEL.
  • Um mínimo de 2 CPUs com arquitetura x86/AMD64.
  • Um mínimo de 2 GB de RAM. Para um desempenho ideal, recomendamos que alocar 8 GB de RAM para cada CPU.
  • Pelo menos, 20 GB de armazenamento disponível.
  • Acesso root sem restrições no SO.
  • Docker versão 20.10 ou superior.
  • Versão 4.18 ou superior do kernel do Linux. Recomendamos a versão 5.3 ou superior do kernel para o melhor desempenho.
  • O cgroup v2 do Linux está ativado.

    Por predefinição, o cgroup v2 está ativado na maioria dos sistemas Linux modernos. Para verificar se o cgroup v2 está ativado, execute stat -fc %T /sys/fs/cgroup/ numa shell. Se o cgroup v2 estiver ativado, o resultado do comando mostra cgroup2fs.

  • Se quiser fazer a integração com o Vertex AI, precisa da CLI do Google Cloud disponível no seu ambiente.

  • Para instalar o AlloyDB Omni numa plataforma de nuvem, recomendamos que use os seguintes tipos de instâncias:
    • No Google Cloud, recomendamos n2-highmem instâncias.
    • Nos Amazon Web Services, recomendamos instâncias R6i.
    • No Microsoft Azure, recomendamos instâncias Ebsv5.
  • Recomendamos que use um dispositivo de armazenamento SSD dedicado para armazenar os seus dados. Se usar um dispositivo físico para este fim, recomendamos que o ligue diretamente à máquina anfitriã.

Transfira e instale o AlloyDB Omni

  1. Instale a CLI AlloyDB Omni.

  2. Use a CLI do AlloyDB Omni para confirmar que a sua máquina Linux está pronta para instalar o AlloyDB Omni:

    sudo alloydb system-check

    Se necessário, modifique o seu sistema até que o resultado do comando system-check retorne uma verificação bem-sucedida.

  3. Opcional: para criar uma nova partição do disco para o AlloyDB Omni usar para o armazenamento de dados, recomendamos que use um sistema de ficheiros ext4 para um desempenho ideal.

    1. Para criar um sistema de ficheiros ext4, use o seguinte comando:

      mkfs.ext4 -m 1 -F "$disk_path"

    2. Para montar o disco, use o seguinte comando:

      mount --make-shared -o noatime,discard,errors=panic "$disk_path" "$disk_mountpoint"

  4. Instale o software do servidor através de uma das seguintes opções:

    • Para configurar o servidor como uma instância principal, execute o seguinte comando:

      sudo alloydb database-server install --data-dir=$(realpath DATA_DIR)

      Substitua DATA_DIR pelo diretório no seu sistema de ficheiros local onde quer que o AlloyDB Omni armazene os respetivos dados, metadados e ficheiros de configuração. O AlloyDB Omni tenta criar este diretório se ainda não existir. Se não especificar este valor, o AlloyDB Omni usa /var/alloydb/main/ por predefinição.

      Para que o AlloyDB Omni ouça ligações numa porta TCP que não seja a predefinição 5432, inclua a flag --pg-port:

      sudo alloydb database-server install \
    --data-dir=$(realpath DATA_DIR) \
    --pg-port=PORT

      Substitua PORT pela porta TCP na qual quer que o AlloyDB Omni aceite ligações.

    • Para configurar o servidor como uma réplica de leitura, inclua as flags --replica-source-ip e --replica-source-port:

      sudo alloydb database-server install \
    --data-dir=$(realpath DATA_DIR) \
    --replica-source-ip=SOURCE_IP \
    --replica-source-port=SOURCE_PORT

      Substitua o seguinte:

      • DATA_DIR: o diretório no seu sistema de ficheiros local onde quer que o AlloyDB Omni armazene os respetivos dados, metadados e ficheiros de configuração. O AlloyDB Omni tenta criar este diretório se ainda não existir. Se não especificar este valor, o AlloyDB Omni usa /var/alloydb/main/ por predefinição.

      • SOURCE_IP: o endereço IP da instância primária do AlloyDB Omni a partir da qual replicar.

      • SOURCE_PORT: a porta TCP da instância primária do AlloyDB Omni a partir da qual replicar. Se não fornecer este valor, o AlloyDB Omni aplica um valor predefinido de 5432.

      Para mais informações sobre as réplicas de leitura do AlloyDB Omni, consulte o artigo Crie uma réplica só de leitura.

  5. Se o seu sistema executar o Red Hat Enterprise Linux, atualize o ficheiro /usr/lib/tuned/virtual-guest/tuned.conf com o seguinte:

    vm.swappiness=1

Estabeleça ligação e use o servidor de base de dados

Ligue-se ao AlloyDB Omni através de psql:

sudo docker exec -it pg-service psql -h localhost -U postgres

A janela de terminal apresenta o texto de início de sessão psql que termina com um comando postgres=#.