Esta página documenta a versão 15.5.2 do AlloyDB Omni usando a opção de implantação do Kubernetes. Escolha outra opção de implantação.

Esta página foi traduzida pela API Cloud Translation.

Personalizar a instalação do AlloyDB Omni

Selecione uma versão da documentação:

Nesta página, mostramos como fazer o download, instalar e se conectar ao AlloyDB Omni. Para começar a usar o AlloyDB Omni rapidamente 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 o 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 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 root irrestrito no SO.
Docker versão 20.10 ou mais recente.
Versão 4.18 ou mais recente do kernel do Linux. Recomendamos a versão 5.3 ou mais recente do kernel para ter o melhor desempenho.
O cgroup v2 do Linux está ativado.
Por padrã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/ em um shell. Se o cgroup v2 estiver ativado, a saída do comando vai mostrar cgroup2fs.
Se você quiser fazer a integração com a Vertex AI, precisará da CLI do Google Cloud 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 n2-highmem instâncias.
- 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 essa finalidade, recomendamos conectá-lo diretamente à máquina host.

RHEL

Uma máquina virtual ou física executando uma versão do Red Hat Enterprise Linux (RHEL) 8 ou mais recente. 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 root irrestrito no SO.
Docker versão 20.10 ou mais recente.
Versão 4.18 ou mais recente do kernel do Linux. Recomendamos a versão 5.3 ou mais recente do kernel para ter o melhor desempenho.
O cgroup v2 do Linux está ativado.
Por padrã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/ em um shell. Se o cgroup v2 estiver ativado, a saída do comando vai mostrar cgroup2fs.
Se você quiser fazer a integração com a Vertex AI, precisará da CLI do Google Cloud 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 n2-highmem instâncias.
- 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 essa finalidade, recomendamos conectá-lo diretamente à máquina host.

Baixar 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 o AlloyDB Omni usar no armazenamento de dados, recomendamos usar 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 ativar 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), 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 os 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 AlloyDB Omni vai usar /var/alloydb/main/ por padrão.
  
  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 AlloyDB Omni vai usar /var/alloydb/main/ por padrão.
  - SOURCE_IP: o endereço IP da instância primária do AlloyDB Omni da qual será feita a replicação.
  - SOURCE_PORT: a porta TCP da instância primária do AlloyDB Omni da qual será feita a replicação. Se você não fornecer esse valor, o AlloyDB Omni vai aplicar o valor padrão 5432.
  Para mais informações sobre réplicas de leitura do AlloyDB Omni, consulte Criar uma réplica somente leitura.
Se o sistema executar o Red Hat Enterprise Linux, atualize o arquivo /usr/lib/tuned/virtual-guest/tuned.conf com o seguinte:
```
vm.swappiness=1
```

Conectar-se e usar o servidor de banco de dados

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 um comando postgres=#.