Personnaliser votre installation 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.

Ce document vous explique également comment effectuer les opérations suivantes :

  • Créer une partition de disque pour optimiser le stockage des données
  • Configurer votre serveur
  • Assurer la compatibilité avec Debian, Ubuntu et RHEL

Avant de commencer

Configuration système requise

Debian

  • Une machine virtuelle ou physique exécutant un système d'exploitation basé sur Debian, tel que Debian ou Ubuntu.
  • Au moins deux processeurs avec une architecture x86/AMD64.
  • Au moins 2 Go de 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é au sein du système d'exploitation.
  • Docker version 20.10 ou ultérieure.
  • Version de noyau Linux 4.18 ou ultérieure. Pour des performances optimales, nous vous recommandons d'utiliser la version 5.3 ou ultérieure du kernel.
  • cgroup v2 de Linux 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 devez disposer de Google Cloud CLI 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 vous recommandons les instances n2-highmem.
    • Sur Amazon Web Services, nous vous recommandons les instances R6i.
    • Sur Microsoft Azure, nous vous 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 à cet effet, 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 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é au sein du système d'exploitation.
  • Docker version 20.10 ou ultérieure.
  • Version de noyau Linux 4.18 ou ultérieure. Pour des performances optimales, nous vous recommandons d'utiliser la version 5.3 ou ultérieure du noyau.
  • cgroup v2 de Linux 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 devez disposer de Google Cloud CLI 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 vous recommandons les instances n2-highmem.
    • Sur Amazon Web Services, nous vous recommandons les instances R6i.
    • Sur Microsoft Azure, nous vous 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 à cet effet, nous vous recommandons de le connecter directement à la machine hôte.

Télécharger et installer AlloyDB Omni

  1. Installez l'interface de ligne de commande AlloyDB Omni.

  2. Utilisez l'interface de ligne de commande 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 renvoie une vérification réussie.

  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 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, 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.

      Pour qu'AlloyDB Omni écoute les connexions sur un port TCP autre que le port par défaut 5432, incluez l'option --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 dupliquée avec accès en lecture, incluez les options --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 AlloyDB Omni principale à partir de laquelle effectuer la réplication.

      • SOURCE_PORT: port TCP de l'instance AlloyDB Omni principale à 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 dupliquées avec accès en lecture d'AlloyDB Omni, consultez Créer une instance dupliquée en lecture seule.

  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=#.