Esta página mostra a documentação da versão 15.5.2 do AlloyDB Omni. Para conferir a documentação da versão mais recente do AlloyDB Omni, clique aqui.

Esta página foi traduzida pela API Cloud Translation.

Personalizar a instalação do AlloyDB Omni

Esta página mostra como fazer o download, instalar e se conectar ao AlloyDB Omni. Para começar rapidamente a usar o AlloyDB Omni com a configuração padrão, consulte Instalar o AlloyDB Omni no Debian ou Ubuntu.

Neste documento, você também vai aprender a:

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

Antes de começar

Requisitos do sistema

Debian

Uma máquina virtual ou física que executa um SO baseado em Debian, como o Debian ou Ubuntu.
No mínimo duas CPUs com arquitetura x86/AMD64.
Mínimo de 2 GB de RAM. Para um desempenho ideal, recomendamos alocar 8 GB de RAM para cada CPU.
Pelo menos 20 GB de armazenamento disponível.
Acesso irrestrito ao root no SO.
Docker versão 20.10 ou mais recente.
Kernel do Linux versão 4.18 ou mais recente. Recomendamos a versão 5.3 ou mais recente do kernel para melhor desempenho.
Cgroup v2 do Linux ativado.
Por padrão, o cgroup v2 é ativado na maioria dos sistemas Linux modernos. Para verificar se o cgroup v2 está ativado, execute stat -fc %T /sys/fs/cgroup/ em um shell. Se o cgroup v2 estiver ativado, a resposta ao comando vai mostrar cgroup2fs.
Se você quiser fazer a integração com a Vertex AI, é necessário ter a Google Cloud CLI disponível no seu ambiente.
Para instalar o AlloyDB Omni em uma plataforma de nuvem, recomendamos usar os seguintes tipos de instância:
- No Google Cloud, recomendamos instâncias n2-highmem.
- Na Amazon Web Services, recomendamos instâncias R6i.
- No Microsoft Azure, recomendamos instâncias Ebsv5.
Recomendamos que você use um dispositivo de armazenamento SSD dedicado para armazenar seus dados. Se você usar um dispositivo físico para esse fim, recomendamos conectá-lo diretamente à máquina host.

RHEL

Uma máquina virtual ou física com uma versão 8 ou mais recente do Red Hat Enterprise Linux (RHEL). Para permitir que os recursos de gerenciamento automático de memória do AlloyDB Omni funcionem, use o RHEL versão 9 ou mais recente.
No mínimo duas CPUs com arquitetura x86/AMD64.
Mínimo de 2 GB de RAM. Para um desempenho ideal, recomendamos alocar 8 GB de RAM para cada CPU.
Pelo menos 20 GB de armazenamento disponível.
Acesso irrestrito ao root no SO.
Docker versão 20.10 ou mais recente.
Kernel do Linux versão 4.18 ou mais recente. Recomendamos a versão 5.3 ou mais recente do kernel para melhor desempenho.
Cgroup v2 do Linux ativado.
Por padrão, o cgroup v2 é ativado na maioria dos sistemas Linux modernos. Para verificar se o cgroup v2 está ativado, execute stat -fc %T /sys/fs/cgroup/ em um shell. Se o cgroup v2 estiver ativado, a resposta ao comando vai mostrar cgroup2fs.
Se você quiser fazer a integração com a Vertex AI, é necessário ter a Google Cloud CLI disponível no seu ambiente.
Para instalar o AlloyDB Omni em uma plataforma de nuvem, recomendamos usar os seguintes tipos de instância:
- No Google Cloud, recomendamos instâncias n2-highmem.
- Na Amazon Web Services, recomendamos instâncias R6i.
- No Microsoft Azure, recomendamos instâncias Ebsv5.
Recomendamos que você use um dispositivo de armazenamento SSD dedicado para armazenar seus dados. Se você usar um dispositivo físico para esse fim, recomendamos conectá-lo diretamente à máquina host.

Fazer o download e instalar o AlloyDB Omni

Instale a CLI do AlloyDB Omni.
Use a CLI do AlloyDB Omni para confirmar se a máquina Linux está pronta para instalar o AlloyDB Omni:
```
sudo alloydb system-check
```
Se necessário, modifique o sistema até que a saída do comando system-check retorne uma verificação bem-sucedida.
Opcional: para criar uma nova partição de disco para que o AlloyDB Omni use para armazenamento de dados, recomendamos o uso de um sistema de arquivos ext4 para um desempenho ideal.
1. Para criar um sistema de arquivos 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"
```
Instale o software do servidor usando uma das seguintes opções:

Observação: para instalar o AlloyDB Omni com funções de aprendizado de máquina (ML) ativadas, incluindo a capacidade de consultar modelos de linguagem grandes (LLMs, na sigla em inglês), consulte Instalar o AlloyDB Omni com o AlloyDB AI.
- 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 sistema de arquivos local em que você quer que o AlloyDB Omni armazene dados, metadados e arquivos de configuração. O AlloyDB Omni tenta criar esse diretório se ele ainda não existir. Se você não especificar esse valor, o padrão do AlloyDB Omni será /var/alloydb/main/.
  
  Para que o AlloyDB Omni detecte conexões em uma porta TCP diferente da 5432 padrão, inclua a flag --pg-port:
```
sudo alloydb database-server install \
    --data-dir=$(realpath DATA_DIR) \
    --pg-port=PORT
```
  Substitua PORT pela porta TCP em que você quer que o AlloyDB Omni aceite conexõ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:
  - DATA_DIR: o diretório no sistema de arquivos local em que você quer que o AlloyDB Omni armazene dados, metadados e arquivos de configuração. O AlloyDB Omni tenta criar esse diretório se ele ainda não existir. Se você não especificar esse valor, o padrão do AlloyDB Omni será /var/alloydb/main/.
  - SOURCE_IP: o endereço IP da instância principal do AlloyDB Omni a ser replicada.
  - SOURCE_PORT: a porta TCP da instância principal do AlloyDB Omni a ser replicada. Se você não informar esse valor, o AlloyDB Omni vai aplicar um valor padrão de 5432.
  Para mais informações sobre as réplicas de leitura do AlloyDB Omni, consulte Criar uma réplica somente leitura.
Se o sistema estiver executando o Red Hat Enterprise Linux, atualize o arquivo /usr/lib/tuned/virtual-guest/tuned.conf com o seguinte:
```
vm.swappiness=1
```

Conectar-se ao servidor de banco de dados e usá-lo

Conecte-se ao AlloyDB Omni usando psql:

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

A janela do terminal mostra o texto de login psql que termina com uma instrução postgres=#.