Personalizzare l'installazione di AlloyDB Omni

Nota: L'utilizzo di AlloyDB Omni è soggetto al contratto tra te e Google che regola le offerte. Google Cloud Se non disponi di un Google Cloud account o non hai stipulato un contratto con Google che regola le offerte Google Cloud , non procedere o scaricare questo software finché non lo avrai fatto. Per creare un Google Cloud account, visita la Google Cloud home page.

AlloyDB Omni viene implementato tramite un'immagine Docker, che consente diverse forme di personalizzazione. Questa pagina mostra alcune delle personalizzazioni più comuni utilizzate.

Per iniziare rapidamente con AlloyDB Omni utilizzando la configurazione predefinita, consulta la guida rapida AlloyDB Omni.

Prima di iniziare

La tabella seguente elenca la configurazione hardware e software consigliata per AlloyDB Omni.

Sistema operativo/piattaforma	Configurazione hardware consigliata	Configurazione software consigliata
Linux	CPU x86-64 o ARM (*) con supporto AVX2 8 GB di RAM per ogni CPU allocata ad AlloyDB Omni Più di 20 GB di spazio su disco	Sistema operativo basato su Debian (Ubuntu e così via) o RHEL 9 Kernel Linux versione 6.1 o successive o qualsiasi versione del kernel Linux precedente alla 5.3 che supporti le direttive MADV_COLLAPSE e MADV_POPULATE_WRITE Cgroupsv2 abilitato Docker Engine 25.0.0 o versioni successive o Podman 5.0.0 o versioni successive
macOS	CPU Intel con supporto AVX2 o chip M 8 GB di RAM per ogni CPU allocata ad AlloyDB Omni Più di 20 GB di spazio su disco	Docker Desktop 4.30 o versioni successive
(*) Il supporto per ARM è in anteprima.

AlloyDB Omni viene eseguito in un contenitore. Prima di installare AlloyDB Omni, installa un runtime del contenitore come Docker o Podman sulla tua macchina.

Single-server

Montare una directory di dati esterna

Per impostazione predefinita, il comando nella Guida rapida: installa AlloyDB Omni archivia i dati del database in un'area gestita da Docker. Questa opzione è comoda per iniziare, ma rende difficile trovare e utilizzare la directory dei dati. In alternativa, puoi configurare un montaggio di unione per mappare la directory dei dati a una posizione nota sul disco.

docker run --name CONTAINER_NAME \
-e POSTGRES_PASSWORD=NEW_PASSWORD \
-v DATA_DIR:/var/lib/postgresql/data \
-p HOST_PORT:5432 -d google/alloydbomni:15.5.4

Sostituisci quanto segue:

• CONTAINER_NAME: il nome da assegnare a questo nuovo contenitore AlloyDB Omni nel registry dei contenitori della macchina host, ad esempio my-omni.

• NEW_PASSWORD: la password assegnata all'utente postgres del nuovo contenitore dopo la sua creazione.

• DATA_DIR: il percorso del file system che vuoi che AlloyDB Omni utilizzi per la sua directory di dati.

• HOST_PORT: la porta TCP sulla macchina host su cui il contenitore deve pubblicare la propria porta 5432. Per utilizzare anche la porta predefinita di PostgreSQL sulla macchina host, specifica 5432.

Attiva ulimits

I parametri ulimit specificano vari limiti di processo che il contenitore Docker può utilizzare. Per prestazioni ottimali, AlloyDB Omni regola le priorità dei processi per consentire l'esecuzione dei processi PostgreSQL critici con una priorità più elevata, ovvero ricevono una maggiore allocazione delle CPU disponibili. Per consentire questa operazione, specifica -20:-20, che rimuove le limitazioni per il contenitore AlloyDB Omni.

docker run --name CONTAINER_NAME \
-e POSTGRES_PASSWORD=NEW_PASSWORD \
--ulimit=nice=-20:-20 \
-p HOST_PORT:5432 -d google/alloydbomni:15.5.4

Specifica un driver di logging

Per impostazione predefinita, Docker non esegue la rotazione dei log. Ciò può occupare molto spazio su disco e, alla fine, portare all'esaurimento dello spazio su disco. Puoi configurare Docker per utilizzare un driver di logging diverso. Ad esempio, per eseguire il logging in journald:

docker run --name CONTAINER_NAME \
-e POSTGRES_PASSWORD=NEW_PASSWORD \
--log-driver=journald \
-p HOST_PORT:5432 -d google/alloydbomni:15.5.4

Per ulteriori informazioni su Docker e sui driver di logging, consulta la documentazione di Docker Configurare i driver di logging.

Puoi anche configurare la registrazione utilizzando PostgreSQL. Per ulteriori informazioni, consulta la sezione Report sugli errori e registrazione della documentazione di PostgreSQL.

Montare un volume di memoria condivisa

Se prevedi di utilizzare l'engine a colonne di AlloyDB con AlloyDB Omni, ti consigliamo di rendere disponibile la memoria condivisa per il contenitore AlloyDB Omni. Il metodo per eseguire questa operazione varia a seconda del sistema operativo host, come mostrato negli esempi riportati di seguito.

Linux

Per rendere disponibile la memoria condivisa al contenitore, monta /dev/shm:

   docker run --name CONTAINER_NAME \
     -e POSTGRES_PASSWORD=NEW_PASSWORD \
     -p HOST_PORT:5432 \
     -v /dev/shm:/dev/shm \
     -d google/alloydbomni:15.5.4

macOS

Per rendere disponibile la memoria condivisa per il contenitore, includi il flag --shm-size:

 docker run --name CONTAINER_NAME \
    -e POSTGRES_PASSWORD=NEW_PASSWORD \
    -p HOST_PORT:5432 \
    --shm-size=SHARED_MEMORY_SIZE \
    -d google/alloydbomni:15.5.4

Sostituisci SHARED_MEMORY_SIZE con la dimensione da impostare per /dev/shm sul contenutore, nel formato descritto in Eseguire i container. Ad esempio, per specificare un gigabyte, utilizza il valore 1g.

Ti consigliamo di impostare la dimensione della memoria condivisa su un numero di megabyte uguale almeno al valore del flag google_job_scheduler.max_parallel_workers_per_job del database moltiplicato per 250. Per ulteriori informazioni sul motore a colonne, consulta Configurare il motore a colonne in AlloyDB Omni.

Ad esempio, se il flag del database google_job_scheduler.max_parallel_workers_per_job è impostato sul valore predefinito 2, ti consigliamo di aggiungere un flag di --shm-size=500m o superiore all'avvio del server di database.

Per ulteriori informazioni sul flag --shm-size, consulta Eseguire i contenitori.