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 virtuellen Maschine (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

Prüfen Sie, ob Sie 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 Festplattenspeicher
  • 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 Festplattenspeicher
  • Docker Desktop 4.20 oder höher
  • Prüfen, ob cgroupsv2 aktiviert ist

    Führen Sie den folgenden Befehl aus, um zu prüfen, 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

    Root-Zugriff ist für die Installation von AlloyDB Omni nicht 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 die folgenden Variablen:

      • NEW_PASSWORD: Das Passwort, das dem Container's postgres Nutzer nach der Erstellung zugewiesen werden soll.
      • IMAGE_TAG: Verwenden Sie 16.3.0 für das neueste Debian Image oder16.3.0-ubi für das neueste UBI Image.

    2. Stellen Sie mit psql eine Verbindung zu containerisiertem AlloyDB Omni her:

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

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

    Podman

    1. Verwenden Sie den Befehl docker 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 die folgenden Variablen:

      • NEW_PASSWORD: Das Passwort, das dem Container's postgres Nutzer nach der Erstellung zugewiesen werden soll.
      • IMAGE_TAG: Verwenden Sie 16.3.0 für das neueste Debian Image oder16.3.0-ubi für das neueste UBI Image.

    2. Stellen Sie mit psql eine Verbindung zu containerisiertem AlloyDB Omni 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 Ihren AlloyDB Omni-Container namens my-omni:

        docker container stop my-omni
    2. Löschen Sie Ihren AlloyDB Omni-Container namens my-omni:

        docker container rm my-omni

    Podman

    1. Beenden Sie Ihren AlloyDB Omni-Container namens my-omni:

        podman container stop my-omni
    2. Löschen Sie Ihren AlloyDB Omni-Container namens my-omni:

        podman container rm my-omni

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

    Nächste Schritte