Personnaliser votre installation AlloyDB Omni

Sélectionnez une version de la documentation :

AlloyDB Omni est déployé via une image de conteneur, ce qui permet différentes formes de personnalisation. Cette page présente quelques personnalisations courantes.

Monter un répertoire de données externe

Par défaut, la commande de la section Démarrage rapide : Installer AlloyDB Omni stocke les données de la base de données dans une zone gérée par Docker et Podman. Cette méthode est pratique pour commencer, mais elle rend difficile la recherche et l'utilisation du répertoire de données. Vous pouvez configurer un montage de liaison pour mapper le répertoire de données à un emplacement connu sur votre disque.

Docker

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

Docker

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

Podman

podman run -d --name CONTAINER_NAME \
-e POSTGRES_PASSWORD=NEW_PASSWORD \
-v DATA_DIR:/var/lib/postgresql/data \
-p HOST_PORT:5432 \
--restart=always \
docker.io/google/alloydbomni:latest

Podman

podman run -d --name CONTAINER_NAME \
-e POSTGRES_PASSWORD=NEW_PASSWORD \
-v DATA_DIR:/var/lib/postgresql/data \
-p HOST_PORT:5432 \
--restart=always \
docker.io/google/alloydbomni:latest

Remplacez les variables suivantes :

  • CONTAINER_NAME : nom que vous avez utilisé pour votre conteneur. Exemple : my-omni-1.
  • NEW_PASSWORD: mot de passe attribué à l'utilisateur postgres du nouveau conteneur après sa création.
  • DATA_DIR : chemin d'accès au répertoire hôte dans lequel vos données sont stockées.
  • HOST_PORT : port TCP sur la machine hôte sur lequel le conteneur doit publier son propre port 5432. Pour utiliser également le port PostgreSQL par défaut sur la machine hôte, spécifiez 5432.

Activer les ulimits

Les paramètres ulimit spécifient les limites de processus que le conteneur Docker ou Podman peut utiliser. Pour des performances optimales, nous vous recommandons de définir les ulimits suivants :

  • nice=-20:-20: AlloyDB Omni ajuste les priorités des processus pour permettre aux processus PostgreSQL critiques de s'exécuter avec une priorité plus élevée. La priorité plus élevée alloue davantage de processeurs disponibles aux processus. Pour ajuster les priorités des processus, spécifiez --ulimit=nice=-20:-20, ce qui supprime les limites du conteneur AlloyDB Omni.

  • memlock=-1:-1 : AlloyDB Omni effectue une gestion automatique de la mémoire. La définition de --ulimit=memlock=-1:-1 permet à la base de données de mieux contrôler la manière dont les pages de mémoire sont échangées, ce qui peut améliorer les performances.

Docker

docker run -d --name CONTAINER_NAME \
-e POSTGRES_PASSWORD=NEW_PASSWORD \
--ulimit=nice=-20:-20 --ulimit=memlock=-1:-1 \
-p HOST_PORT:5432 \
--restart=always \
google/alloydbomni:latest

Docker

docker run -d --name CONTAINER_NAME \
-e POSTGRES_PASSWORD=NEW_PASSWORD \
--ulimit=nice=-20:-20 --ulimit=memlock=-1:-1 \
-p HOST_PORT:5432 \
--restart=always \
google/alloydbomni:latest

Podman

podman run -d --name CONTAINER_NAME \
-e POSTGRES_PASSWORD=NEW_PASSWORD \
--ulimit=nice=-20:-20 --ulimit=memlock=-1:-1 \
-p HOST_PORT:5432 \
--restart=always \
docker.io/google/alloydbomni:latest

Podman

podman run -d --name CONTAINER_NAME \
-e POSTGRES_PASSWORD=NEW_PASSWORD \
--ulimit=nice=-20:-20 --ulimit=memlock=-1:-1 \
-p HOST_PORT:5432 \
--restart=always \
docker.io/google/alloydbomni:latest

Remplacez les variables suivantes :

  • CONTAINER_NAME : nom que vous avez utilisé pour votre conteneur. Exemple : my-omni-1.
  • NEW_PASSWORD: mot de passe attribué à l'utilisateur postgres du nouveau conteneur après sa création.
  • HOST_PORT: port TCP sur la machine hôte sur lequel le conteneur doit publier son propre port 5432. Pour utiliser également le port PostgreSQL par défaut sur la machine hôte, spécifiez 5432.

Spécifier un pilote de journalisation

Par défaut, Docker et Podman n'effectuent pas de rotation des journaux. Cela peut utiliser beaucoup d'espace disque et, à terme, entraîner une saturation de l'espace disque. Pour utiliser un autre pilote de journalisation, vous pouvez spécifier le champ --log-driver. Par exemple, pour consigner dans journald :

Docker

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

Docker

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

Podman

podman run -d --name CONTAINER_NAME \
-e POSTGRES_PASSWORD=NEW_PASSWORD \
--log-driver=journald \
-p HOST_PORT:5432 \
--restart=always \
docker.io/google/alloydbomni:latest

Podman

podman run -d --name CONTAINER_NAME \
-e POSTGRES_PASSWORD=NEW_PASSWORD \
--log-driver=journald \
-p HOST_PORT:5432 \
--restart=always \
docker.io/google/alloydbomni:latest

Remplacez les variables suivantes :

  • CONTAINER_NAME : nom que vous avez utilisé pour votre conteneur. Exemple : my-omni-1.
  • NEW_PASSWORD: mot de passe attribué à l'utilisateur postgres du nouveau conteneur après sa création.
  • HOST_PORT: port TCP sur la machine hôte sur lequel le conteneur doit publier son propre port 5432. Pour utiliser également le port PostgreSQL par défaut sur la machine hôte, spécifiez 5432.

Pour en savoir plus sur les pilotes de journalisation, consultez la documentation Configurer les pilotes de journalisation de Docker et podman-run de Podman.

Vous pouvez également configurer la journalisation à l'aide de PostgreSQL. Pour en savoir plus, consultez Configurer la rotation des journaux AlloyDB Omni.

Monter un volume de mémoire partagée

Si vous prévoyez d'utiliser le moteur de données en colonnes AlloyDB avec AlloyDB Omni, nous vous recommandons de mettre de la mémoire partagée à la disposition du conteneur AlloyDB Omni. La méthode à suivre varie en fonction de votre système d'exploitation hôte, comme illustré dans les exemples suivants.

Linux

Pour mettre de la mémoire partagée à la disposition du conteneur, montez /dev/shm :

Docker

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

Docker

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

Podman

podman run -d --name CONTAINER_NAME \
-e POSTGRES_PASSWORD=NEW_PASSWORD \
-v /dev/shm:/dev/shm \
-p HOST_PORT:5432 \
--restart=always \
docker.io/google/alloydbomni:latest

Podman

podman run -d --name CONTAINER_NAME \
-e POSTGRES_PASSWORD=NEW_PASSWORD \
-v /dev/shm:/dev/shm \
-p HOST_PORT:5432 \
--restart=always \
docker.io/google/alloydbomni:latest

Remplacez les variables suivantes :

  • CONTAINER_NAME : nom que vous avez utilisé pour votre conteneur. Exemple : my-omni-1.
  • NEW_PASSWORD: mot de passe attribué à l'utilisateur postgres du nouveau conteneur après sa création.
  • HOST_PORT: port TCP sur la machine hôte sur lequel le conteneur doit publier son propre port 5432. Pour utiliser également le port PostgreSQL par défaut sur la machine hôte, spécifiez 5432.

macOS

Pour mettre de la mémoire partagée à la disposition du conteneur, incluez l'option --shm-size :

Docker

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

Docker

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

Podman

podman run -d --name CONTAINER_NAME \
-e POSTGRES_PASSWORD=NEW_PASSWORD \
--shm-size=SHARED_MEMORY_SIZE \
-p HOST_PORT:5432 \
--restart=always \
docker.io/google/alloydbomni:latest

Podman

podman run -d --name CONTAINER_NAME \
-e POSTGRES_PASSWORD=NEW_PASSWORD \
--shm-size=SHARED_MEMORY_SIZE \
-p HOST_PORT:5432 \
--restart=always \
docker.io/google/alloydbomni:latest

Remplacez les variables suivantes :

  • CONTAINER_NAME : nom que vous avez utilisé pour votre conteneur. Exemple : my-omni-1.
  • NEW_PASSWORD: mot de passe attribué à l'utilisateur postgres du nouveau conteneur après sa création.
  • SHARED_MEMORY_SIZE : taille à définir pour /dev/shm sur le conteneur, au format décrit dans Exécuter des conteneurs. Par exemple, pour spécifier un gigaoctet, utilisez la valeur 1g.
  • HOST_PORT: port TCP sur la machine hôte sur lequel le conteneur doit publier son propre port 5432. Pour utiliser également le port PostgreSQL par défaut sur la machine hôte, spécifiez 5432.

Nous vous recommandons de définir la taille de la mémoire partagée sur un nombre de mégaoctets égal à au moins la valeur de l'option google_job_scheduler.max_parallel_workers_per_job de votre base de données, multipliée par 250. Pour en savoir plus sur le moteur de données en colonnes, consultez Configurer le moteur de données en colonnes dans AlloyDB Omni.

Par exemple, si l'option de base de données google_job_scheduler.max_parallel_workers_per_job est définie sur sa valeur par défaut 2, envisagez d'ajouter une option --shm-size=500m ou supérieure lorsque vous démarrez votre serveur de base de données.

Pour en savoir plus sur l'option --shm-size, consultez Exécuter des conteneurs.

Activer les extensions

La liste des extensions disponibles dans AlloyDB Omni est disponible dans Extensions de base de données compatibles. Bien que PostGIS et Orafce ne soient pas inclus dans AlloyDB Omni, vous pouvez les installer en suivant les instructions ci-dessous :

Les extensions installées sont activées à l'aide des CREATE EXTENSION instructions PostgreSQL standards, comme décrit dans Activer une extension.