Personnaliser votre installation d'AlloyDB Omni

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 allez également apprendre à effectuer les tâches suivantes:

  • Créez une partition de disque pour optimiser le stockage des données.
  • Configurez votre serveur.
  • Assurez-vous de 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, comme Debian ou Ubuntu.
  • Deux processeurs minimum, avec architecture x86/AMD64
  • Au moins 2 Go de RAM Pour des performances optimales, nous vous recommandons d'allouer 8 Go de RAM à chaque processeur.
  • Au moins 20 Go d'espace de stockage disponible
  • Accès racine illimité dans l'OS.
  • Docker version 20.10 ou ultérieure
  • Noyau Linux version 4.18 ou ultérieure Pour des performances optimales, nous vous recommandons d'utiliser la version 5.3 ou ultérieure du kernel.
  • Linux cgroup v2 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 la 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 d'utiliser des instances n2-highmem.
    • Sur Amazon Web Services, nous vous recommandons d'utiliser des instances R6i.
    • Sur Microsoft Azure, nous vous recommandons d'utiliser des instances Ebsv5.
  • Nous vous recommandons d'utiliser un appareil de stockage SSD dédié pour stocker vos données. Si vous utilisez un appareil physique à cette fin, nous vous recommandons de l'associer 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 9 ou version ultérieure.
  • Deux processeurs minimum, avec architecture x86/AMD64
  • Au moins 2 Go de RAM Pour des performances optimales, nous vous recommandons d'allouer 8 Go de RAM à chaque processeur.
  • Au moins 20 Go d'espace de stockage disponible
  • Accès racine illimité dans l'OS.
  • Docker version 20.10 ou ultérieure
  • Noyau Linux version 4.18 ou ultérieure Pour des performances optimales, nous vous recommandons d'utiliser la version 5.3 ou ultérieure du kernel.
  • Linux cgroup v2 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 la 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 d'utiliser des instances n2-highmem.
    • Sur Amazon Web Services, nous vous recommandons d'utiliser des instances R6i.
    • Sur Microsoft Azure, nous vous recommandons d'utiliser des instances Ebsv5.
  • Nous vous recommandons d'utiliser un appareil de stockage SSD dédié pour stocker vos données. Si vous utilisez un appareil physique à cette fin, nous vous recommandons de l'associer 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 la sortie de la commande system-check renvoie une vérification réussie.

  3. Facultatif: Pour créer une partition de disque à utiliser par AlloyDB Omni pour le stockage de 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, exécutez 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 que 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 que AlloyDB Omni écoute les connexions sur un port TCP autre que le 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 AlloyDB Omni doit accepter 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 que 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 une valeur par défaut de 5432.

      Pour en savoir plus sur les instances dupliquées avec accès en lecture AlloyDB Omni, consultez la section 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

Se connecter à 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 se terminant par une invite postgres=#.