Instale o AlloyDB Omni para Linux

Pré-visualização

Esta funcionalidade está sujeita aos "Termos das Ofertas de Pré-DG" na secção Termos Gerais de Serviço dos Termos Específicos do Serviço. As funcionalidades de pré-DG estão disponíveis "tal como estão" e podem ter apoio técnico limitado. Para mais informações, consulte as descrições das fases de lançamento.

Para informações sobre o acesso a esta versão, consulte a página de solicitação de acesso.

Selecione uma versão da documentação: 17.5.0

• Atual (17.5.0)
• 17.5.0

Pode fazer instalações de instância única do AlloyDB Omni em qualquer máquina Linux ou servidor bare metal que suporte runtimes do RHEL 9.

Para começar a usar este modelo de implementação, envie este formulário para pedir acesso.

Antes de começar

Antes de instalar o AlloyDB Omni, leia o artigo Planeie a instalação do AlloyDB Omni.

Crie um diretório onde o AlloyDB Omni armazena dados

Se estiver a usar um sistema de armazenamento que execute o AlloyDB Omni juntamente com outras aplicações, pode criar o diretório do AlloyDB Omni no sistema de ficheiros existente do seu dispositivo. Caso contrário, pode criar um novo sistema de ficheiros no seu dispositivo dedicado.

Sistema de ficheiros existente

Para criar um diretório num sistema de ficheiros existente, execute o seguinte comando:

mkdir -p DATA_DIR

Substitua a seguinte variável:

• DATA_DIR: o caminho do diretório anfitrião onde os seus dados estão armazenados.

Dispositivo dedicado

Para criar um diretório num sistema de ficheiros dedicado, siga estes passos:

1. Crie um diretório no anfitrião onde o disco vai ser montado.

   mkdir -p MOUNT_POINT

   Substitua a seguinte variável:

   • MOUNT_POINT: caminho do diretório de nível superior que deve conter a sua instância do AlloyDB Omni.

2. Crie uma gpt tabela de partições e um sistema de ficheiros, e monte o dispositivo de disco.

   EXT4

   parted -s DEVICE_PATH mklabel gpt
   parted -s DEVICE_PATH mkpart primary 0% 100%
   mkfs.ext4 -q -m 1 -L FS_LABEL -F PARTITION_PATH
   echo -e "LABEL=FS_LABEL\tMOUNT_POINT\text4\tdefaults\t0 0" | tee -a /etc/fstab
   mount MOUNT_POINT

   Substitua as seguintes variáveis:

   • DEVICE_PATH: caminho atribuído pelo sistema operativo ao dispositivo de disco.
   • FS_LABEL: etiqueta para o sistema de ficheiros. O comprimento máximo é de 12 carateres para xfs.
   • PARTITION_PATH: caminho para a partição do disco usada para armazenar os dados do sistema de ficheiros.

   XFS

   parted -s DEVICE_PATH mklabel gpt
   parted -s DEVICE_PATH mkpart primary 0% 100%
   dnf install xfsprogs
   mkfs.xfs -L FS_LABEL -f PARTITION_PATH
   echo -e "LABEL=FS_LABEL\tMOUNT_POINT\txfs\tdefaults\t0 0" | tee -a /etc/fstab
   mount MOUNT_POINT

   Substitua as seguintes variáveis:

   • DEVICE_PATH: caminho atribuído pelo sistema operativo ao dispositivo de disco.
   • FS_LABEL: etiqueta para o sistema de ficheiros. O comprimento máximo é de 16 carateres para ext4.
   • PARTITION_PATH: caminho para a partição do disco usada para armazenar os dados do sistema de ficheiros.

3. Crie um diretório de dados neste sistema de ficheiros. Recomendamos que crie DATA_DIR como um subdiretório no ponto de montagem, por exemplo, MOUNT_POINT/17.

   mkdir -p DATA_DIR

   Substitua DATA_DIR pelo caminho do diretório do anfitrião para armazenar dados relacionados com a base de dados, por exemplo, MOUNT_POINT/17.

Configure a política SELinux

Instale o pacote policycoreutils-python-utils necessário para que a política SELinux seja configurada para permitir o serviço de base de dados AlloyDB Omni durante a instalação do pacote RPM do AlloyDB Omni.

Instale o AlloyDB Omni

1. Configure o repositório YUM no seu diretório local.

   sudo tee -a /etc/yum.repos.d/alloydbomni.repo << EOF
   [alloydbomni]
   name=alloydbomni
   baseurl=ALLOYDB_OMNI_URL
   enabled=1
   repo_gpgcheck=0
   gpgcheck=1
   gpgkey=https://dl.google.com/linux/linux_signing_key.pub
   EOF
   

   sudo yum makecache
   

   Substitua ALLOYDB_OMNI_URL pelo URL do AlloyDB Omni que recebe depois de se inscrever para aceder.

   Nota: para a versão de pré-visualização, a integridade do pacote é validada ao nível do RPM individual. Configure o repo_gpgcheck=0 para continuar com a configuração do repositório YUM.

2. Instale o pacote RPM do AlloyDB Omni.

   sudo dnf install alloydbomni17

3. Inicialize e configure a base de dados do AlloyDB Omni.

   sudo PGPASSWORD=POSTGRES_PASSWORD PGDATA=DATA_DIR /usr/lib/postgresql/17/bin/alloydbomni17-setup initdb

   Opcionalmente, pode transmitir opções initdb padrão como uma única string na variável POSTGRES_INITDB_ARGS.

4. Se estiver a usar um diretório de dados personalizado, execute os seguintes comandos para configurar o SELinux de modo a permitir que o serviço AlloyDB Omni leia e escreva dados nesse diretório. Este passo requer que o pacote policycoreutils-python-utils esteja instalado.

   /usr/sbin/semanage fcontext -a -t postgresql_db_t "DATA_DIR(/.*)?"
   

   /sbin/restorecon -R -F DATA_DIR
   

5. Prepare a base de dados AlloyDB Omni.

   sudo PGPASSWORD=POSTGRES_PASSWORD /usr/lib/postgresql/17/bin/alloydbomni17-setup preparedb

6. Opcional. Para uma execução otimizada do serviço AlloyDB Omni, execute o seguinte comando.

   sudo /usr/lib/postgresql/17/bin/alloydbomni17-setup-host

   A execução do comando anterior define as seguintes configurações do sistema para os respetivos valores recomendados:

   Definição do sistema	Valor recomendado
   /sys/kernel/mm/transparent_hugepage/shmem_enabled	within_size
   /sys/kernel/mm/transparent_hugepage/khugepaged/max_ptes_swap	511
   /sys/kernel/mm/transparent_hugepage/khugepaged/max_ptes_shared	511
   /proc/sys/vm/nr_overcommit_hugepages	valor igual ao tamanho de MemTotal em MB
   /proc/sys/vm/max_map_count	1073741824

   Para transmitir valores personalizados para estas configurações, inclua argumentos no formato <system_setting>=<value> no comando alloydbomni17-setup-host, como no exemplo seguinte:

   sudo /usr/lib/postgresql/17/bin/alloydbomni17-setup-host /proc/sys/vm/max_map_count=2097152 /proc/sys/vm/nr_overcommit_hugepages=524288
   

7. Inicie o serviço systemd do AlloyDB Omni.

   sudo systemctl enable alloydbomni17
   

   sudo systemctl start alloydbomni17
   

8. Verifique se o serviço AlloyDB Omni está a ser executado com êxito.

   sudo systemctl status alloydbomni17

   Segue-se um exemplo de resposta. Verifique se o estado está ativo (em execução).

       Loaded: loaded (/usr/lib/systemd/system/alloydbomni17.service; enabled; preset: disabled)
      Drop-In: /etc/systemd/system/alloydbomni17.service.d
        Active: active (running) since Wed 2025-11-19 07:37:31 UTC; 1 day 6h ago "
      Process: 120228 ExecStartPre=/usr/lib/postgresql/17/bin/alloydbomni17-check-db-dir ${PGDATA} (code=exited, status=0 SUCCESS)
     Main PID: 120231 (postgres)
        Tasks: 19 (limit: 203438)
       Memory: 161.7M (peak: 170.0M)
          CPU: 28min 10.149s
       CGroup: /system.slice/alloydbomni17.service
               ├─120231 /usr/lib/postgresql/17/bin/postgres -D /var/lib/postgresql/17/data
               ├─120232 "postgres: alloydb internal logger "
               ├─120233 "postgres: checkpointer "
               ├─120234 "postgres: background writer "
               ├─120237 "postgres: walwriter "
               ├─120243 "postgres: lux wal preallocator "
               ├─120244 "postgres: autovacuum launcher "
               ├─120246 "postgres: free buffer manager "
               ├─120247 "postgres: buffer control "
   

O que se segue?

• Execute e ligue-se ao AlloyDB Omni.