Installer AlloyDB Omni

Sélectionnez une version de la documentation :

Ce démarrage rapide vous explique comment installer AlloyDB Omni, qui peut s'exécuter dans n'importe quel environnement basé sur UNIX compatible avec les environnements d'exécution 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 respecter 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 matérielles et logicielles minimales suivantes :

OS/Plate-forme Configuration matérielle minimale Logiciel minimal
Linux
  • Processeur x86-64 ou Arm (*) compatible avec AVX2
  • 2 Go de RAM
  • 10 Go d'espace disque
    		•
  • OS basé sur Debian (Ubuntu, etc.), RHEL 8 ou 9
  • Kernel Linux 5.3 ou version ultérieure
  • 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 version preview.

    Vérifier que cgroupsv2 est activé

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

    grep cgroup /proc/filesystems

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

    nodev cgroup
nodev cgroupsv2

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

    nodev cgroup

    Installer un environnement d'exécution de conteneurs

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

    Installer AlloyDB Omni à l'aide de Docker

    L'accès racine n'est pas requis 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 du nouveau conteneur après sa création.postgres

      • 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 en conteneur à 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 du nouveau conteneur après sa création.postgres

      • 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 en conteneur à 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éé lors de ce 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 à des fins de production, consultez la page Personnaliser votre installation AlloyDB Omni.

    Étape suivante