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

O Google usa tecnologia de IA na tradução de conteúdos para seu idioma de preferência. As traduções com IA podem ter erros.

Personalizar a instalação do AlloyDB Omni

Selecione uma versão da documentação:

Esta página mostra 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 aprende a fazer o seguinte:

Criar uma nova partição de disco para otimizar o repositório de dados.
Configurar o servidor.
Garantir 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.
Um mínimo de 2 CPUs, com arquitetura x86/AMD64.
Um 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.
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 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 resposta ao comando vai mostrar cgroup2fs.
Se você quiser fazer a integração com a Vertex AI, precisará ter a Google Cloud CLI disponível no seu ambiente.
Para instalar o AlloyDB Omni em uma plataforma de nuvem, recomendamos o uso dos 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 o uso de um dispositivo de armazenamento SSD dedicado para armazenar seus dados. Se você usar um dispositivo físico para essa finalidade, recomendamos anexá-lo diretamente à máquina host.

RHEL

Uma máquina virtual ou física que executa 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 a versão 9 ou mais recente 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 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.
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 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 resposta ao comando vai mostrar cgroup2fs.
Se você quiser fazer a integração com a Vertex AI, precisará ter a Google Cloud CLI disponível no seu ambiente.
Para instalar o AlloyDB Omni em uma plataforma de nuvem, recomendamos o uso dos 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 o uso de um dispositivo de armazenamento SSD dedicado para armazenar seus dados. Se você usar um dispositivo físico para essa finalidade, recomendamos anexá-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 o AlloyDB Omni usar 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 servidor usando uma das seguintes opções:

**Observação** :para instalar o AlloyDB Omni com as funções de machine learning (ML) ativadas, incluindo a capacidade de consultar modelos de linguagem grandes (LLMs), consulte Instalar o AlloyDB Omni com a IA do AlloyDB.
- 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/ como 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 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/ como 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 as 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 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 um prompt postgres=#.