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.
In der folgenden Tabelle sind die Mindestanforderungen an Hardware und Software für AlloyDB Omni aufgeführt.
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.) oder RHEL 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.
AlloyDB Omni wird in einem Container ausgeführt. Installieren Sie eine Container-Laufzeit wie Docker oder Podman auf Ihrem Computer, bevor Sie AlloyDB Omni installieren.
AlloyDB Omni mit Docker installieren
Verwenden Sie den Befehl docker run, um einen neuen Container mit AlloyDB Omni mit dem Namen my-omni zu erstellen:
Ersetzen Sie NEW_PASSWORD durch ein Passwort, das dem postgres-Nutzer des neuen Containers nach der Erstellung zugewiesen werden soll.
So stellen Sie eine Verbindung zu containerisiertem AlloyDB Omni mit psql her:
dockerexec-itmy-omnipsql-hlocalhost-Upostgres
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:
Beenden Sie den AlloyDB Omni-Container mit dem Namen my-omni:
dockercontainerstopmy-omni
Löschen Sie den AlloyDB Omni-Container mit dem Namen my-omni:
dockercontainerrmmy-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.
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Schwer verständlich","hardToUnderstand","thumb-down"],["Informationen oder Beispielcode falsch","incorrectInformationOrSampleCode","thumb-down"],["Benötigte Informationen/Beispiele nicht gefunden","missingTheInformationSamplesINeed","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 2025-08-17 (UTC)."],[[["\u003cp\u003eAlloyDB Omni can be installed in any UNIX-based environment that supports container runtimes, requiring minimum hardware like an x86-64 or Arm CPU with AVX2 support, 2 GB of RAM, and 10 GB of disk space.\u003c/p\u003e\n"],["\u003cp\u003eA container runtime such as Docker or Podman needs to be installed before you can install AlloyDB Omni, which will then run within a container.\u003c/p\u003e\n"],["\u003cp\u003eInstallation is done by using the \u003ccode\u003edocker run\u003c/code\u003e command, which creates a new container and allows you to set a password for the container's \u003ccode\u003epostgres\u003c/code\u003e user.\u003c/p\u003e\n"],["\u003cp\u003eYou can connect to your containerized AlloyDB Omni instance using \u003ccode\u003epsql\u003c/code\u003e via the command \u003ccode\u003edocker exec -it my-omni psql -h localhost -U postgres\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe container's data directory is deleted when the AlloyDB Omni container is removed unless you mount a data directory on your host file system, which would require customization.\u003c/p\u003e\n"]]],[],null,["# Install AlloyDB Omni\n\nSelect a documentation version: 15.5.4keyboard_arrow_down\n\n- [Current (16.8.0)](/alloydb/omni/current/docs/quickstart)\n- [16.8.0](/alloydb/omni/16.8.0/docs/quickstart)\n- [16.3.0](/alloydb/omni/16.3.0/docs/quickstart)\n- [15.12.0](/alloydb/omni/15.12.0/docs/quickstart)\n- [15.7.1](/alloydb/omni/15.7.1/docs/quickstart)\n- [15.7.0](/alloydb/omni/15.7.0/docs/quickstart)\n- [15.5.5](/alloydb/omni/15.5.5/docs/quickstart)\n- [15.5.4](/alloydb/omni/15.5.4/docs/quickstart)\n- [15.5.2](/alloydb/omni/15.5.2/docs/quickstart)\n\n\u003cbr /\u003e\n\n| **Note:** Your use of AlloyDB Omni is subject to the agreement between you and Google that governs Google Cloud offerings. If you do not have a Google Cloud account, or have not otherwise entered into an agreement with Google that governs Google Cloud offerings, please do not proceed or download this software until you have done so. To create a Google Cloud account, see [the Google Cloud homepage](/docs/get-started).\n\n\u003cbr /\u003e\n\nThis quickstart shows you how to install AlloyDB Omni that can run\nin any UNIX-based environment which supports container runtimes.\n\nFor an overview of AlloyDB Omni, see [AlloyDB Omni overview](/alloydb/omni/15.5.4/docs).\n\nBefore you begin\n----------------\n\nThe following table lists minimum hardware and software requirements for AlloyDB Omni.\n\nAlloyDB Omni runs in a container. Install a container runtime like [Docker](https://docs.docker.com/engine/install/) or [Podman](https://podman.io/docs/installation) on your machine before installing AlloyDB Omni.\n\nInstall AlloyDB Omni using Docker\n---------------------------------\n\n| **Note:** [Root access](https://docs.docker.com/engine/install/linux-postinstall/#manage-docker-as-a-non-root-user) is not required for installing AlloyDB Omni.\n\n1. Use the `docker run` command to create a new container with AlloyDB Omni named `my-omni`:\n\n docker run --name my-omni \\\n -e POSTGRES_PASSWORD=\u003cvar translate=\"no\"\u003eNEW_PASSWORD\u003c/var\u003e \\\n -d google/alloydbomni:15.5.4\n\n Replace \u003cvar translate=\"no\"\u003eNEW_PASSWORD\u003c/var\u003e with a password to assign the new container's `postgres` user after its creation.\n\n| **Note:** By default, AlloyDB Omni stores your data on the container itself, and not on your host file system. The data directory is deleted once you delete your AlloyDB Omni container. To mount a data directory stored on your host file system, see instructions in [Customize your AlloyDB Omni installation](/alloydb/omni/15.5.4/docs/install).\n\n1. Connect to containerized AlloyDB Omni using `psql`:\n\n docker exec -it my-omni psql -h localhost -U postgres\n\n The terminal window displays `psql` login text that ends with a\n `postgres=#` prompt.\n\nClean up\n--------\n\nTo clean up the AlloyDB Omni container you created during this quickstart, use these steps:\n\n1. Stop your AlloyDB Omni container named `my-omni`:\n\n docker container stop my-omni\n\n2. Delete your AlloyDB Omni container named `my-omni`:\n\n docker container rm my-omni\n\nFor instructions how to install AlloyDB Omni in a new container for production usage, go to the [Customize your AlloyDB Omni installation](/alloydb/omni/15.5.4/docs/install) page.\n\nWhat's next\n-----------\n\n- [Run and connect to AlloyDB Omni](/alloydb/omni/15.5.4/docs/run-connect)\n\n- [Customize your AlloyDB Omni installation](/alloydb/omni/15.5.4/docs/install)\n\n- [Set up your AlloyDB Omni for production](/alloydb/omni/15.5.4/docs/configure-omni)"]]