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 environnements d'exécution de conteneurs.

Pour en savoir plus sur AlloyDB Omni, consultez la 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 disposer de la configuration matérielle et logicielle minimale requise :

OS/Plate-forme Configuration matérielle minimale Configuration logicielle minimale
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
  • Version 5.3 ou ultérieure du noyau Linux
  • Cgroupsv2 activé
  • Docker Engine 20.10 ou version ultérieure, ou Podman 4.2.0 ou version ultérieure
    		•
    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 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, le résultat suivant s'affiche :

    nodev cgroup
nodev cgroupsv2

    Si votre machine n'est pas compatible avec cgroupsv2, le résultat suivant 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 racine n'est pas requis pour installer AlloyDB Omni.

    Docker

    1. Dans un terminal sur votre machine hôte, exécutez 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 éléments suivants :

      • NEW_PASSWORD : mot de passe à attribuer à l'utilisateur postgres du conteneur nouvellement créé.

      • IMAGE_TAG : tag d'image (par exemple, 18.4.0 pour la dernière image Debian ou 18.4.0-ubi9 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 de terminal affiche le texte de connexion psql qui se termine par une invite postgres=#.

    Podman

    1. Dans un terminal sur votre machine hôte, exécutez la commande podman 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 éléments suivants :

      • NEW_PASSWORD : mot de passe à attribuer à l'utilisateur postgres du conteneur nouvellement créé.

      • IMAGE_TAG : tag d'image (par exemple, 18.4.0 pour la dernière image Debian ou 18.4.0-ubi9 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 de 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 pour une utilisation en production, consultez la page Personnaliser votre installation AlloyDB Omni.

    Étapes suivantes