Personnaliser votre installation d'AlloyDB Omni

Sélectionnez une version de la documentation :

Cette page vous explique comment télécharger, installer et vous connecter à AlloyDB Omni. Pour commencer rapidement à utiliser AlloyDB Omni avec la configuration par défaut, consultez Installer AlloyDB Omni sur Debian ou Ubuntu.

Dans ce document, vous apprendrez également à effectuer les opérations suivantes :

  • Créez une partition de disque pour optimiser le stockage des données.
  • Configurez votre serveur.
  • Assurez la compatibilité avec Debian, Ubuntu et RHEL.

Avant de commencer

Configuration requise

Debian

  • Une machine virtuelle ou physique exécutant un OS basé sur Debian, tel que Debian ou Ubuntu.
  • Au moins deux processeurs avec une architecture x86/AMD64.
  • Au moins 2 Go de mémoire RAM Pour des performances optimales, nous vous recommandons d'allouer 8 Go de RAM par processeur.
  • Au moins 20 Go d'espace de stockage disponible.
  • Accès root illimité dans l'OS.
  • Docker version 20.10 ou ultérieure
  • Version 4.18 ou ultérieure du noyau Linux. Pour des performances optimales, nous vous recommandons d'utiliser la version 5.3 ou ultérieure du noyau.
  • Linux cgroup v2 est activé.

    Par défaut, cgroup v2 est activé sur la plupart des systèmes Linux modernes. Pour vérifier si cgroup v2 est activé, exécutez stat -fc %T /sys/fs/cgroup/ dans un shell. Si cgroup v2 est activé, le résultat de la commande affiche cgroup2fs.

  • Si vous souhaitez intégrer Vertex AI, vous avez besoin de la Google Cloud CLI disponible dans votre environnement.

  • Pour installer AlloyDB Omni sur une plate-forme cloud, nous vous recommandons d'utiliser les types d'instances suivants :
    • Sur Google Cloud, nous recommandons n2-highmem instances.
    • Sur Amazon Web Services, nous vous recommandons les instances R6i.
    • Sur Microsoft Azure, nous recommandons les instances Ebsv5.
  • Nous vous recommandons d'utiliser un périphérique de stockage SSD dédié pour stocker vos données. Si vous utilisez un appareil physique à cette fin, nous vous recommandons de le connecter directement à la machine hôte.

RHEL

  • Une machine virtuelle ou physique exécutant Red Hat Enterprise Linux (RHEL) version 8 ou ultérieure. Pour que les fonctionnalités de gestion automatique de la mémoire d'AlloyDB Omni fonctionnent, utilisez RHEL version 9 ou ultérieure.
  • Au moins deux processeurs avec une architecture x86/AMD64.
  • Au moins 2 Go de mémoire RAM Pour des performances optimales, nous vous recommandons d'allouer 8 Go de RAM par processeur.
  • Au moins 20 Go d'espace de stockage disponible.
  • Accès root illimité dans l'OS.
  • Docker version 20.10 ou ultérieure
  • Version 4.18 ou ultérieure du noyau Linux. Pour des performances optimales, nous vous recommandons d'utiliser la version 5.3 du noyau ou une version ultérieure.
  • Linux cgroup v2 est activé.

    Par défaut, cgroup v2 est activé sur la plupart des systèmes Linux modernes. Pour vérifier si cgroup v2 est activé, exécutez stat -fc %T /sys/fs/cgroup/ dans un shell. Si cgroup v2 est activé, le résultat de la commande affiche cgroup2fs.

  • Si vous souhaitez intégrer Vertex AI, vous avez besoin de la Google Cloud CLI disponible dans votre environnement.

  • Pour installer AlloyDB Omni sur une plate-forme cloud, nous vous recommandons d'utiliser les types d'instances suivants :
    • Sur Google Cloud, nous recommandons n2-highmem instances.
    • Sur Amazon Web Services, nous vous recommandons les instances R6i.
    • Sur Microsoft Azure, nous recommandons les instances Ebsv5.
  • Nous vous recommandons d'utiliser un périphérique de stockage SSD dédié pour stocker vos données. Si vous utilisez un appareil physique à cette fin, nous vous recommandons de le connecter directement à la machine hôte.

Télécharger et installer AlloyDB Omni

  1. Installez la CLI AlloyDB Omni.

  2. Utilisez la CLI AlloyDB Omni pour vérifier que votre machine Linux est prête à installer AlloyDB Omni :

    sudo alloydb system-check

    Si nécessaire, modifiez votre système jusqu'à ce que le résultat de la commande system-check indique que la vérification a réussi.

  3. Facultatif : Pour créer une partition de disque qu'AlloyDB Omni utilisera pour le stockage des données, nous vous recommandons d'utiliser un système de fichiers ext4 pour des performances optimales.

    1. Pour créer un système de fichiers ext4, utilisez la commande suivante :

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

    2. Pour installer votre disque, utilisez la commande suivante :

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

  4. Installez le logiciel du serveur à l'aide de l'une des options suivantes :

    • Pour configurer le serveur en tant qu'instance principale, exécutez la commande suivante :

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

      Remplacez DATA_DIR par le répertoire de votre système de fichiers local dans lequel vous souhaitez qu'AlloyDB Omni stocke ses données, métadonnées et fichiers de configuration. AlloyDB Omni tente de créer ce répertoire s'il n'existe pas déjà. Si vous ne spécifiez pas cette valeur, AlloyDB Omni utilise /var/alloydb/main/ par défaut.

      Pour qu'AlloyDB Omni écoute les connexions sur un port TCP autre que le port 5432 par défaut, incluez l'indicateur --pg-port :

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

      Remplacez PORT par le port TCP sur lequel vous souhaitez qu'AlloyDB Omni accepte les connexions.

    • Pour configurer le serveur en tant qu'instance répliquée avec accès en lecture, incluez les indicateurs --replica-source-ip et --replica-source-port :

      sudo alloydb database-server install \
    --data-dir=$(realpath DATA_DIR) \
    --replica-source-ip=SOURCE_IP \
    --replica-source-port=SOURCE_PORT

      Remplacez les éléments suivants :

      • DATA_DIR : répertoire de votre système de fichiers local dans lequel vous souhaitez qu'AlloyDB Omni stocke ses données, ses métadonnées et ses fichiers de configuration. AlloyDB Omni tente de créer ce répertoire s'il n'existe pas déjà. Si vous ne spécifiez pas cette valeur, AlloyDB Omni utilise /var/alloydb/main/ par défaut.

      • SOURCE_IP : adresse IP de l'instance principale AlloyDB Omni à partir de laquelle effectuer la réplication.

      • SOURCE_PORT : port TCP de l'instance principale AlloyDB Omni à partir de laquelle effectuer la réplication. Si vous ne fournissez pas cette valeur, AlloyDB Omni applique la valeur par défaut 5432.

      Pour en savoir plus sur les instances répliquées avec accès en lecture AlloyDB Omni, consultez Créer une instance répliquée avec accès en lecture.

  5. Si votre système exécute Red Hat Enterprise Linux, mettez à jour le fichier /usr/lib/tuned/virtual-guest/tuned.conf avec les éléments suivants :

    vm.swappiness=1

Se connecter au serveur de base de données et l'utiliser

Connectez-vous à AlloyDB Omni à l'aide de psql :

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

La fenêtre du terminal affiche le texte de connexion psql qui se termine par une invite postgres=#.