Instale o AlloyDB Omni para Linux

Selecione uma versão da documentação:

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 que é 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 que é 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.

  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. Prepare a base de dados do AlloyDB Omni.

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

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

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

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

    sudo systemctl enable alloydbomni17
$ sudo systemctl start alloydbomni17

  7. 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?