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 Container-Laufzeiten unterstützt.

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

Hinweise

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

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

Sie müssen die folgenden Mindestanforderungen an Hardware und Software erfüllen:

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 Podman 4.2.0+
  • macOS
  • Intel-CPU mit AVX2-Unterstützung oder M-Chip
  • 2 GB RAM
  • 10 GB Speicherplatz
  • Docker Desktop 4.20 oder höher
  • (*) Die Arm-Unterstützung befindet sich in der Vorschau.

    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 Container-Laufzeit 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 Root-Zugriff nicht erforderlich.

    Docker

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

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

      Ersetzen Sie die folgenden Variablen:

      • NEW_PASSWORD: Das Passwort, das dem postgres-Nutzer des neuen Containers nach der Erstellung zugewiesen werden soll.
      • IMAGE_TAG: Verwenden Sie 16.8.0 für das neueste Debian-Image oder 16.8.0-ubi für das neueste UBI-Image.

    2. So stellen Sie eine Verbindung zu containerisiertem AlloyDB Omni mit psql 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 docker run, um einen neuen Container mit AlloyDB Omni mit dem Namen my-omni zu erstellen:

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

      Ersetzen Sie die folgenden Variablen:

      • NEW_PASSWORD: Das Passwort, das dem postgres-Nutzer des neuen Containers nach der Erstellung zugewiesen werden soll.
      • IMAGE_TAG: Verwenden Sie 16.3.0 für das neueste Debian-Image oder 16.3.0-ubi für das neueste UBI-Image.

    2. So stellen Sie eine Verbindung zu containerisiertem AlloyDB Omni mit psql 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 zur Installation von AlloyDB Omni in einem neuen Container für die Produktion finden Sie auf der Seite AlloyDB Omni-Installation anpassen.

    Nächste Schritte