Personalizzare l'installazione di AlloyDB Omni

Questa pagina mostra come scaricare, installare e connettersi a AlloyDB Omni. Per iniziare rapidamente con AlloyDB Omni utilizzando la configurazione predefinita, consulta Installare AlloyDB Omni su Debian o Ubuntu.

In questo documento scoprirai anche come:

  • Crea una nuova partizione del disco per ottimizzare lo spazio di archiviazione dei dati.
  • Configura il server.
  • Assicurati la compatibilità con Debian, Ubuntu e RHEL.

Prima di iniziare

Requisiti di sistema

Debian

  • Una macchina virtuale o fisica che esegue un sistema operativo basato su Debian, come Debian o Ubuntu.
  • Almeno 2 CPU con architettura x86/AMD64.
  • Almeno 2 GB di RAM. Per prestazioni ottimali, consigliamo di allocare 8 GB di RAM per ogni CPU.
  • Almeno 20 GB di spazio di archiviazione disponibile.
  • Accesso root illimitato all'interno del sistema operativo.
  • Docker versione 20.10 o successive.
  • Kernel Linux 4.18 o versioni successive. Per ottenere prestazioni ottimali, consigliamo la versione del kernel 5.3 o successiva.
  • Cgroup v2 di Linux abilitato.

    Per impostazione predefinita, cgroup v2 è abilitato sulla maggior parte dei sistemi Linux moderni. Per verificare se cgroup v2 è abilitato, esegui stat -fc %T /sys/fs/cgroup/ in una shell. Se cgroup v2 è abilitato, l'output del comando mostra cgroup2fs.

  • Se vuoi eseguire l'integrazione con Vertex AI, devi avere Google Cloud CLI disponibile nel tuo ambiente.

  • Per installare AlloyDB Omni su una piattaforma cloud, consigliamo di utilizzare i seguenti tipi di istanze:
    • Su Google Cloud, consigliamo n2-highmem istanze.
    • Su Amazon Web Services, consigliamo le istanze R6i.
    • Su Microsoft Azure, consigliamo le istanze Ebsv5.
  • Ti consigliamo di utilizzare un dispositivo di archiviazione SSD dedicato per memorizzare i tuoi dati. Se utilizzi un dispositivo fisico a questo scopo, ti consigliamo di collegarlo direttamente alla macchina host.

RHEL

  • Una macchina virtuale o fisica che esegue Red Hat Enterprise Linux (RHEL) versione 8 o successive. Per consentire il funzionamento delle funzionalità di gestione automatica della memoria di AlloyDB Omni, utilizza RHEL versione 9 o successive.
  • Almeno 2 CPU con architettura x86/AMD64.
  • Almeno 2 GB di RAM. Per prestazioni ottimali, consigliamo di allocare 8 GB di RAM per ogni CPU.
  • Almeno 20 GB di spazio di archiviazione disponibile.
  • Accesso root illimitato all'interno del sistema operativo.
  • Docker versione 20.10 o successive.
  • Kernel Linux 4.18 o versioni successive. Per ottenere prestazioni ottimali, consigliamo la versione 5.3 o superiore del kernel.
  • Cgroup v2 di Linux abilitato.

    Per impostazione predefinita, cgroup v2 è abilitato sulla maggior parte dei sistemi Linux moderni. Per verificare se cgroup v2 è abilitato, esegui stat -fc %T /sys/fs/cgroup/ in una shell. Se cgroup v2 è abilitato, l'output del comando mostra cgroup2fs.

  • Se vuoi eseguire l'integrazione con Vertex AI, devi avere Google Cloud CLI disponibile nel tuo ambiente.

  • Per installare AlloyDB Omni su una piattaforma cloud, consigliamo di utilizzare i seguenti tipi di istanze:
    • Su Google Cloud, consigliamo n2-highmem istanze.
    • Su Amazon Web Services, consigliamo le istanze R6i.
    • Su Microsoft Azure, consigliamo le istanze Ebsv5.
  • Ti consigliamo di utilizzare un dispositivo di archiviazione SSD dedicato per memorizzare i tuoi dati. Se utilizzi un dispositivo fisico a questo scopo, ti consigliamo di collegarlo direttamente alla macchina host.

Scarica e installa AlloyDB Omni

  1. Installa la CLI AlloyDB Omni.

  2. Utilizza l'interfaccia a riga di comando AlloyDB Omni per verificare che la tua macchina Linux sia pronta per l'installazione di AlloyDB Omni:

    sudo alloydb system-check

    Se necessario, modifica il sistema finché l'output del comando system-check non restituisce un controllo riuscito.

  3. (Facoltativo) Per creare una nuova partizione del disco da utilizzare da AlloyDB Omni per lo stoccaggio dei dati, ti consigliamo di utilizzare un file system ext4 per prestazioni ottimali.

    1. Per creare un file system ext4, utilizza il seguente comando:

      mkfs.ext4 -m 1 -F "$disk_path"

    2. Per montare il disco, utilizza il comando seguente:

      mount --make-shared -o noatime,discard,errors=panic "$disk_path" "$disk_mountpoint"

  4. Installa il software del server utilizzando una delle seguenti opzioni:

    • Per configurare il server come istanza principale, esegui il seguente comando:

      sudo alloydb database-server install --data-dir=$(realpath DATA_DIR)

      Sostituisci DATA_DIR con la directory nel file system locale in cui vuoi che AlloyDB Omni archivi i propri dati, i metadati e i file di configurazione. AlloyDB Omni tenta di creare questa directory se non esiste già. Se non specifichi questo valore, il valore predefinito di AlloyDB Omni è /var/alloydb/main/.

      Per fare in modo che AlloyDB Omni ascolti le connessioni su una porta TCP diversa da quella predefinita 5432, includi il flag --pg-port:

      sudo alloydb database-server install \
    --data-dir=$(realpath DATA_DIR) \
    --pg-port=PORT

      Sostituisci PORT con la porta TCP su cui vuoi che AlloyDB Omni accetti le connessioni.

    • Per configurare il server come replica di lettura, includi i flag --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

      Sostituisci quanto segue:

      • DATA_DIR: la directory nel file system locale dove vuoi che AlloyDB Omni memorizzi i dati, i metadati e i file di configurazione. AlloyDB Omni tenta di creare questa directory se non esiste già. Se non specifichi questo valore, il valore predefinito di AlloyDB Omni è /var/alloydb/main/.

      • SOURCE_IP: l'indirizzo IP dell'istanza principale di AlloyDB Omni da cui eseguire la replica.

      • SOURCE_PORT: la porta TCP dell'istanza principale di AlloyDB Omni da cui eseguire la replica. Se non fornisci questo valore, AlloyDB Omni applica un valore predefinito di 5432.

      Per ulteriori informazioni sulle repliche di lettura di AlloyDB Omni, consulta Creare una replica di sola lettura.

  5. Se il sistema esegue Red Hat Enterprise Linux, aggiorna il file /usr/lib/tuned/virtual-guest/tuned.conf con quanto segue:

    vm.swappiness=1

Connettiti al server di database e utilizzalo

Connettiti ad AlloyDB Omni utilizzando psql:

sudo docker exec -it pg-service psql -h localhost -U postgres

Nella finestra del terminale viene visualizzato il testo di accesso psql che termina con un prompt postgres=#.