本页面介绍了 AlloyDB Omni 版本 16.3.0。选择适用于其他版本的文档。

安装 AlloyDB Omni

本快速入门介绍了如何安装可在任何支持容器运行时的基于 UNIX 的环境中运行的 AlloyDB Omni。

如需大致了解 AlloyDB Omni，请参阅 AlloyDB Omni 概览。

准备工作

在安装 AlloyDB Omni 之前，请确保您满足以下要求。

满足以下最低硬件和软件要求：

操作系统/平台	硬件最低要求	最低软件要求
Linux	支持 AVX2 的 x86-64 或 Arm (*) CPU 2 GB RAM 10 GB 磁盘可用空间	基于 Debian 的操作系统（Ubuntu 等）、RHEL 8 或 9 Linux 内核版本 5.3 或更高版本启用了 Cgroupsv2 Docker Engine 20.10+ 或 Podman 4.2.0+
macOS	支持 AVX2 的 Intel CPU 或 M 芯片 2 GB RAM 10 GB 磁盘可用空间	Docker Desktop 4.20 或更高版本
(*) Arm 支持处于预览版阶段。

如需确定您的机器上是否启用了 cgroupsv2，请运行以下命令：

grep cgroup /proc/filesystems

如果您的机器支持 cgroupsv2，您会看到以下输出：

  nodev cgroup
  nodev cgroupsv2

如果您的机器不支持 cgroupsv2，您会看到以下输出：

nodev cgroup

使用 docker run 命令创建一个具有 AlloyDB Omni 的名为 my-omni 的新容器：
```
  docker run --name my-omni \
    -e POSTGRES_PASSWORD=NEW_PASSWORD \
    -d google/alloydbomni:16
```
将 NEW_PASSWORD 替换为创建新容器后为新容器的 postgres 用户分配的密码。

注意：默认情况下，AlloyDB Omni 会将数据存储在容器本身，而不是主机文件系统中。删除 AlloyDB Omni 容器后，系统会删除数据目录。如需装载存储在主机文件系统中的数据目录，请参阅自定义 AlloyDB Omni 安装中的说明。
使用 psql 连接到容器化 AlloyDB Omni：
```
  docker exec -it my-omni psql -h localhost -U postgres
```
终端窗口会显示以 postgres=# 提示符结尾的 psql 登录文本。

使用 docker run 命令创建一个具有 AlloyDB Omni 的名为 my-omni 的新容器：
```
  podman run --name my-omni \
    -e POSTGRES_PASSWORD=NEW_PASSWORD \
    -d google/alloydbomni:16
```
将 NEW_PASSWORD 替换为创建新容器后为新容器的 postgres 用户分配的密码。

注意：默认情况下，AlloyDB Omni 会将数据存储在容器本身，而不是主机文件系统中。删除 AlloyDB Omni 容器后，系统会删除数据目录。如需装载存储在主机文件系统中的数据目录，请参阅自定义 AlloyDB Omni 安装中的说明。
使用 psql 连接到容器化 AlloyDB Omni：
```
podman exec -it my-omni psql -h localhost -U postgres
```
终端窗口会显示以 postgres=# 提示符结尾的 psql 登录文本。

如需清理您在本快速入门中创建的 AlloyDB Omni 容器，请按照以下步骤操作：

如需了解如何在新容器中安装 AlloyDB Omni 以供生产使用，请前往自定义 AlloyDB Omni 安装页面。