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

Instale a CLI AlloyDB Omni.
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.
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"
```
Instale o software do servidor através de uma das seguintes opções:

Nota: para instalar o AlloyDB Omni com funções de aprendizagem automática (AA) ativadas, incluindo a capacidade de consultar modelos de linguagem (conteúdo extenso) (MDIs/CEs), consulte o artigo Instale 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 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.
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=#.