Installer AlloyDB Omni

Sélectionnez une version de la documentation :

Ce guide de démarrage rapide vous explique comment installer AlloyDB Omni, qui peut s'exécuter dans n'importe quel environnement UNIX compatible avec les runtimes de conteneurs.

Pour obtenir une présentation d'AlloyDB Omni, consultez Présentation d'AlloyDB Omni.

Avant de commencer

Avant d'installer AlloyDB Omni, assurez-vous de remplir les conditions suivantes.

Choisir une option de téléchargement ou d'installation

Médias Emplacements de téléchargement et guides d'installation Déploiement vers
Image Debian DockerHub (tags)
  • Docker, Podman Vous pouvez exécuter ces outils de conteneurisation en tant que conteneur dans n'importe quelle machine virtuelle (VM).
Image UBI (Red Hat) Catalogue de l'écosystème Red Hat
  • environnement Red Hat. Exécutez-le en tant que conteneur.

Répondre aux exigences matérielles et logicielles

Assurez-vous de respecter les exigences minimales suivantes en termes de matériel et de logiciel :

OS/Plate-forme Configuration matérielle minimale Logiciel minimum
Linux
  • Processeur x86-64 ou Arm (*) avec prise en charge AVX2
  • 2 Go de RAM
  • 10 Go d'espace disque
  • OS basé sur Debian (Ubuntu, etc.) RHEL 8 ou 9
  • Version 5.3 ou ultérieure du noyau Linux
  • Cgroupsv2 activé
  • Docker Engine 20.10+ ou Podman 4.2.0+
  • macOS
  • Processeur Intel compatible avec AVX2 ou puce M
  • 2 Go de RAM
  • 10 Go d'espace disque
  • Docker Desktop 4.20 ou version ultérieure
  • (*) La compatibilité avec Arm est disponible en preview.

    Vérifier que cgroupsv2 est activé

    Pour déterminer si cgroupsv2 est activé sur votre machine, exécutez la commande suivante :

    grep cgroup /proc/filesystems
    

    Si votre machine est compatible avec cgroupsv2, la sortie suivante s'affiche :

    nodev cgroup
    nodev cgroupsv2
    

    Si votre machine n'est pas compatible avec cgroupsv2, la sortie suivante s'affiche :

    nodev cgroup
    

    Installer un environnement d'exécution de conteneur

    Installez un environnement d'exécution de conteneur tel que Docker ou Podman. AlloyDB Omni s'exécute dans un conteneur.

    Installer AlloyDB Omni à l'aide de Docker

    L'accès root n'est pas nécessaire pour installer AlloyDB Omni.

    Docker

    1. Utilisez la commande docker run pour créer un conteneur avec AlloyDB Omni nommé my-omni :

        docker run --name my-omni \
          -e POSTGRES_PASSWORD=NEW_PASSWORD \
           -d google/alloydbomni:IMAGE_TAG

      Remplacez les variables suivantes :

      • NEW_PASSWORD : mot de passe à attribuer à l'utilisateur postgres du nouveau conteneur après sa création.
      • IMAGE_TAG : utilisez 16.8.0 pour la dernière image Debian ou 16.8.0-ubi pour la dernière image UBI.

    2. Connectez-vous à AlloyDB Omni conteneurisé à l'aide de psql :

        docker exec -it my-omni psql -h localhost -U postgres

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

    Podman

    1. Utilisez la commande docker run pour créer un conteneur avec AlloyDB Omni nommé my-omni :

        podman run --name my-omni \
          -e POSTGRES_PASSWORD=NEW_PASSWORD \
          -d google/alloydbomni:IMAGE_TAG

      Remplacez les variables suivantes :

      • NEW_PASSWORD : mot de passe à attribuer à l'utilisateur postgres du nouveau conteneur après sa création.
      • IMAGE_TAG : utilisez 16.3.0 pour la dernière image Debian ou 16.3.0-ubi pour la dernière image UBI.

    2. Connectez-vous à AlloyDB Omni conteneurisé à l'aide de psql :

      podman exec -it my-omni psql -h localhost -U postgres

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

    Effectuer un nettoyage

    Pour nettoyer le conteneur AlloyDB Omni que vous avez créé dans ce guide de démarrage rapide, procédez comme suit :

    Docker

    1. Arrêtez votre conteneur AlloyDB Omni nommé my-omni :

        docker container stop my-omni
    2. Supprimez votre conteneur AlloyDB Omni nommé my-omni :

        docker container rm my-omni

    Podman

    1. Arrêtez votre conteneur AlloyDB Omni nommé my-omni :

        podman container stop my-omni
    2. Supprimez votre conteneur AlloyDB Omni nommé my-omni :

        podman container rm my-omni

    Pour savoir comment installer AlloyDB Omni dans un nouveau conteneur pour une utilisation en production, consultez la page Personnaliser votre installation AlloyDB Omni.

    Étapes suivantes