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
Docker
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:
podmanexec-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:
Docker
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
Podman
Beenden Sie den AlloyDB Omni-Container mit dem Namen my-omni:
podmancontainerstopmy-omni
Löschen Sie den AlloyDB Omni-Container mit dem Namen my-omni:
podmancontainerrmmy-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, provided you have an agreement with Google governing Google Cloud offerings.\u003c/p\u003e\n"],["\u003cp\u003eThe minimum requirements for running AlloyDB Omni include either an x86-64 or Arm CPU with AVX2 support, 2 GB of RAM, 10 GB of disk space, and a compatible operating system like Linux or macOS, and a supported container runtime like Docker or Podman.\u003c/p\u003e\n"],["\u003cp\u003eInstallation involves using either the \u003ccode\u003edocker run\u003c/code\u003e or \u003ccode\u003epodman run\u003c/code\u003e command to create a new container, naming it \u003ccode\u003emy-omni\u003c/code\u003e, setting a \u003ccode\u003ePOSTGRES_PASSWORD\u003c/code\u003e, and using the \u003ccode\u003egoogle/alloydbomni:15.5.5\u003c/code\u003e image.\u003c/p\u003e\n"],["\u003cp\u003eYou can connect to the containerized AlloyDB Omni using \u003ccode\u003epsql\u003c/code\u003e with either \u003ccode\u003edocker exec\u003c/code\u003e or \u003ccode\u003epodman exec\u003c/code\u003e, logging in as the \u003ccode\u003epostgres\u003c/code\u003e user.\u003c/p\u003e\n"],["\u003cp\u003eTo clean up, stop and then delete the \u003ccode\u003emy-omni\u003c/code\u003e container using either \u003ccode\u003edocker container stop/rm\u003c/code\u003e or \u003ccode\u003epodman container stop/rm\u003c/code\u003e commands.\u003c/p\u003e\n"]]],[],null,["# Install AlloyDB Omni\n\nSelect a documentation version: 15.5.5keyboard_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.5/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\n### Docker\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.5\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 | **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.5/docs/install).\n2. 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\n### Podman\n\n1. Use the `docker run` command to create a new container with AlloyDB Omni named `my-omni`:\n\n podman run --name my-omni \\\n -e POSTGRES_PASSWORD=\u003cvar translate=\"no\"\u003eNEW_PASSWORD\u003c/var\u003e \\\n -d google/alloydbomni:15.5.5\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 | **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.5/docs/install).\n2. Connect to containerized AlloyDB Omni using `psql`:\n\n podman 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\n### Docker\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\n### Podman\n\n1. Stop your AlloyDB Omni container named `my-omni`:\n\n podman container stop my-omni\n\n2. Delete your AlloyDB Omni container named `my-omni`:\n\n podman 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.5/docs/install) page.\n\nWhat's next\n-----------\n\n- [Run and connect to AlloyDB Omni](/alloydb/omni/15.5.5/docs/run-connect)\n\n- [Customize your AlloyDB Omni installation](/alloydb/omni/15.5.5/docs/install)\n\n- [Set up your AlloyDB Omni for production](/alloydb/omni/15.5.5/docs/configure-omni)"]]