AlloyDB Omni installieren

Wählen Sie eine Dokumentationsversion aus:

In dieser Kurzanleitung erfahren Sie, wie Sie AlloyDB Omni installieren, das in jeder UNIX-basierten Umgebung ausgeführt werden kann, die Containerlaufzeiten unterstützt.

Eine Übersicht über AlloyDB Omni finden Sie unter AlloyDB Omni – Übersicht.

Hinweis

Prüfen Sie vor der Installation von AlloyDB Omni, ob Sie die folgenden Anforderungen erfüllen.

Download- oder Installationsoption auswählen

Medien Downloadorte und Installationsanleitungen Bereitstellung für
Debian-Image DockerHub (Tags)
  • Docker, Podman. Sie können diese Containerisierungstools als Container auf jeder VM ausführen.
UBI-Image (Red Hat) Red Hat Ecosystem Catalog
  • Red Hat-Umgebung. Führen Sie das als Container aus.

Hardware- und Softwareanforderungen erfüllen

Die folgenden Mindestanforderungen an Hardware und Software müssen erfüllt sein:

Betriebssystem/Plattform Mindesthardware Mindestsoftware
Linux
  • x86-64- oder Arm-CPU (*) mit AVX2-Unterstützung
  • 2 GB RAM
  • 10 GB Speicherplatz
  • Debian-basiertes Betriebssystem (Ubuntu usw.), RHEL 8 oder 9
  • Linux-Kernel-Version 5.3 oder höher
  • Cgroupsv2 aktiviert
  • Docker Engine 20.10 oder höher oder Podman 4.2.0 oder höher
  • macOS
  • Intel-CPU mit AVX2-Unterstützung oder M-Chip
  • 2 GB RAM
  • 10 GB Speicherplatz
  • Docker Desktop 4.20 oder höher
  • (*) Die Unterstützung für Arm befindet sich in der Vorabversion.

    Prüfen, ob cgroupsv2 aktiviert ist

    Führen Sie den folgenden Befehl aus, um festzustellen, ob cgroupsv2 auf Ihrem Computer aktiviert ist:

    grep cgroup /proc/filesystems
    

    Wenn Ihr Computer cgroupsv2 unterstützt, wird die folgende Ausgabe angezeigt:

    nodev cgroup
    nodev cgroupsv2
    

    Wenn Ihr Computer cgroupsv2 nicht unterstützt, wird die folgende Ausgabe angezeigt:

    nodev cgroup
    

    Containerlaufzeit installieren

    Installieren Sie eine Containerlaufzeit wie Docker oder Podman. AlloyDB Omni wird in einem Container ausgeführt.

    AlloyDB Omni mit Docker installieren

    Für die Installation von AlloyDB Omni ist kein Root-Zugriff erforderlich.

    Docker

    1. Verwenden Sie den Befehl docker run, um einen neuen Container mit AlloyDB Omni namens my-omni zu erstellen:

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

      Ersetzen Sie Folgendes:

      • NEW_PASSWORD: Ein Passwort, das dem postgres-Nutzer des neu erstellten Containers zugewiesen werden soll.

      • IMAGE_TAG: das Image-Tag, z. B. 18.3.0 für das neueste Debian-Image oder 18.3.0-ubi9 für das neueste UBI-Image.

    2. Stellen Sie mit psql eine Verbindung zur containerisierten AlloyDB Omni-Instanz her:

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

      Im Terminalfenster wird der psql-Anmeldetext angezeigt, der mit dem Prompt postgres=# endet.

    Podman

    1. Verwenden Sie den Befehl podman run, um einen neuen Container mit AlloyDB Omni namens my-omni zu erstellen:

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

      Ersetzen Sie Folgendes:

      • NEW_PASSWORD: Ein Passwort, das dem postgres-Nutzer des neu erstellten Containers zugewiesen werden soll.

      • IMAGE_TAG: das Image-Tag, z. B. 18.3.0 für das neueste Debian-Image oder 18.3.0-ubi9 für das neueste UBI-Image.

    2. Stellen Sie mit psql eine Verbindung zur containerisierten AlloyDB Omni-Instanz her:

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

      Im Terminalfenster wird der psql-Anmeldetext angezeigt, der mit dem Prompt postgres=# endet.

    Bereinigen

    So bereinigen Sie den AlloyDB Omni-Container, den Sie in dieser Kurzanleitung erstellt haben:

    Docker

    1. Beenden Sie den AlloyDB Omni-Container mit dem Namen my-omni:

        docker container stop my-omni
    2. Löschen Sie den AlloyDB Omni-Container mit dem Namen my-omni:

        docker container rm my-omni

    Podman

    1. Beenden Sie den AlloyDB Omni-Container mit dem Namen my-omni:

        podman container stop my-omni
    2. Löschen Sie den AlloyDB Omni-Container mit dem Namen my-omni:

        podman container rm my-omni

    Eine Anleitung zum Installieren von AlloyDB Omni in einem neuen Container für die Produktion finden Sie auf der Seite AlloyDB Omni-Installation anpassen.

    Nächste Schritte