Installa AlloyDB Omni

Questa guida rapida mostra come installare AlloyDB Omni che può essere eseguito in qualsiasi ambiente basato su UNIX che supporta i runtime dei container.

Per una panoramica di AlloyDB Omni, consulta Panoramica di AlloyDB Omni.

Prima di iniziare

Prima di installare AlloyDB Omni, assicurati di soddisfare i seguenti requisiti.

Scegliere un'opzione di download o installazione

Media	Percorsi di download e guide all'installazione	Deployment in
Immagine Debian	DockerHub (tag)	Docker, Podman. Puoi eseguire questi strumenti di containerizzazione come container in qualsiasi macchina virtuale (VM). Google Cloud Marketplace AWS Marketplace Azure Marketplace
Immagine UBI (Red Hat)	Catalogo dell'ecosistema Red Hat	ambiente Red Hat. Esegui questo comando come container. Red Hat Marketplace (UBI)

Soddisfare i requisiti hardware e software

Assicurati di soddisfare i seguenti requisiti minimi hardware e software:

Sistema operativo/piattaforma	Requisiti hardware minimi	Software minimo
Linux	CPU x86-64 o Arm (*) con supporto AVX2 2 GB di RAM 10 GB di spazio su disco	Sistema operativo basato su Debian (Ubuntu e così via), RHEL 8 o 9 Kernel Linux versione 5.3 o successive Cgroupsv2 abilitato Docker Engine 20.10+ o Podman 4.2.0+
macOS	CPU Intel con supporto AVX2 o chip M 2 GB di RAM 10 GB di spazio su disco	Docker Desktop 4.20 o versioni successive
(*) Il supporto di ARM è in anteprima.

Nota: AlloyDB Omni supporta Arm (anteprima).

Verifica che cgroupsv2 sia abilitato

Per determinare se cgroupsv2 è abilitato sul tuo computer, esegui questo comando:

grep cgroup /proc/filesystems

Se la tua macchina supporta cgroupsv2, vedrai il seguente output:

nodev cgroup
nodev cgroupsv2

Se la tua macchina non supporta cgroupsv2, viene visualizzato il seguente output:

nodev cgroup

Installa un runtime container

Installa un runtime del container come Docker o Podman. AlloyDB Omni viene eseguito in un container.

Nota: AlloyDB Omni viene compilato per essere eseguito direttamente sui sistemi Linux. L'esecuzione di AlloyDB Omni in un container Docker su macOS utilizza il livello di compatibilità di Docker, il che può comportare una riduzione delle prestazioni rispetto all'esecuzione diretta su Linux.

Installa AlloyDB Omni utilizzando Docker

L'accesso root non è necessario per installare AlloyDB Omni.

Nota: se vuoi eseguire il deployment di AlloyDB Omni nel tuo ambiente di produzione, consulta Eseguire AlloyDB Omni in produzione.

Docker

1. Utilizza il comando docker run per creare un nuovo container con AlloyDB Omni denominato my-omni:

     docker run --name my-omni \
       -e POSTGRES_PASSWORD=NEW_PASSWORD \
        -d google/alloydbomni:IMAGE_TAG

   Sostituisci le seguenti variabili:

   • NEW_PASSWORD: la password per assegnare il nuovo utente postgres del contenitore dopo la sua creazione.

   • IMAGE_TAG: utilizza 16.8.0 per l'ultima immagine Debian o 16.8.0-ubi per l'ultima immagine UBI.

     Nota :per impostazione predefinita, AlloyDB Omni archivia i dati sul container stesso e non sul file system host. La directory dei dati viene eliminata quando elimini il container AlloyDB Omni. Per montare una directory di dati archiviata nel file system host, consulta le istruzioni in Personalizza l'installazione di AlloyDB Omni.

2. Connettiti ad AlloyDB Omni in container utilizzando psql:

     docker exec -it my-omni psql -h localhost -U postgres

   La finestra del terminale mostra il testo di accesso psql che termina con un prompt postgres=#.

Podman

1. Utilizza il comando docker run per creare un nuovo container con AlloyDB Omni denominato my-omni:

     podman run --name my-omni \
       -e POSTGRES_PASSWORD=NEW_PASSWORD \
       -d google/alloydbomni:IMAGE_TAG

   Sostituisci le seguenti variabili:

   • NEW_PASSWORD: la password per assegnare il nuovo utente postgres del contenitore dopo la sua creazione.

   • IMAGE_TAG: utilizza 16.3.0 per l'ultima immagine Debian o 16.3.0-ubi per l'ultima immagine UBI.

     Nota :per impostazione predefinita, AlloyDB Omni archivia i dati sul container stesso e non sul file system host. La directory dei dati viene eliminata quando elimini il container AlloyDB Omni. Per montare una directory di dati archiviata nel file system host, consulta le istruzioni in Personalizza l'installazione di AlloyDB Omni.

2. Connettiti ad AlloyDB Omni in container utilizzando psql:

   podman exec -it my-omni psql -h localhost -U postgres

   La finestra del terminale mostra il testo di accesso psql che termina con un prompt postgres=#.

Esegui la pulizia

Per pulire il container AlloyDB Omni che hai creato durante questa guida rapida, segui questi passaggi:

Docker

1. Arresta il container AlloyDB Omni denominato my-omni:

     docker container stop my-omni

2. Elimina il container AlloyDB Omni denominato my-omni:

     docker container rm my-omni

Podman

1. Arresta il container AlloyDB Omni denominato my-omni:

     podman container stop my-omni

2. Elimina il container AlloyDB Omni denominato my-omni:

     podman container rm my-omni

Per istruzioni su come installare AlloyDB Omni in un nuovo container per l'utilizzo in produzione, vai alla pagina Personalizza l'installazione di AlloyDB Omni.

Passaggi successivi

• Esegui e connettiti ad AlloyDB Omni

• Personalizza l'installazione di AlloyDB Omni

• Configura AlloyDB Omni per la produzione