Installer AlloyDB Omni

Ce guide de démarrage rapide 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 conteneur.

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 remplir les conditions requises suivantes.

  • Disposer de la configuration matérielle et logicielle minimale requise:

    OS/Plate-forme Configuration matérielle minimale Logiciels minimum
    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
  • Noyau Linux version 5.3 ou ultérieure
  • 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 disponible en preview.

    Déterminer si cgroupsv2 est activé sur votre machine

    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 est la suivante:

      nodev cgroup
  nodev cgroupsv2

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

    nodev cgroup

  • 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

Docker

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

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

    Remplacez NEW_PASSWORD par un mot de passe pour attribuer l'utilisateur postgres du nouveau conteneur après sa création.

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

Podman

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

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

    Remplacez NEW_PASSWORD par un mot de passe pour attribuer l'utilisateur postgres du nouveau conteneur après sa création.

  2. Se connecter à 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 se terminant 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 à des fins de production, consultez la page Personnaliser votre installation d'AlloyDB Omni.

Étape suivante