安装 AlloyDB Omni

选择文档版本：

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

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

准备工作

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

选择下载或安装选项

媒体 下载位置及安装指南 部署目标
Debian 映像 DockerHub（标记）
  • Docker、Podman。您可以在任何虚拟机 (VM) 中以容器形式运行这些容器化工具。
UBI 映像 (Red Hat) Red Hat 生态系统目录
  • Red Hat 环境；将其作为容器运行。

满足硬件和软件要求

请确保您至少满足以下最低硬件和软件要求：

操作系统/平台 硬件最低要求 最低软件要求
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

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

    grep cgroup /proc/filesystems

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

    nodev cgroup
nodev cgroupsv2

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

    nodev cgroup

    安装容器运行时

    安装容器运行时，例如 Docker 或 Podman。AlloyDB Omni 在容器中运行。

    使用 Docker 安装 AlloyDB Omni

    安装 AlloyDB Omni 不需要根访问权限。

    Docker

    1. 使用 docker run 命令创建一个具有 AlloyDB Omni 的名为 my-omni 的新容器：

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

      执行以下变量替换操作：

      • NEW_PASSWORD：在创建新容器后为新容器的 postgres 用户分配的密码。

      • IMAGE_TAG：使用 16.8.0 表示最新的 Debian 映像，使用 16.8.0-ubi 表示最新的 UBI 映像。

    2. 使用 psql 连接到容器化 AlloyDB Omni：

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

      终端窗口会显示以 postgres=# 提示符结尾的 psql 登录文本。

    Podman

    1. 使用 docker run 命令创建一个具有 AlloyDB Omni 的名为 my-omni 的新容器：

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

      执行以下变量替换操作：

      • NEW_PASSWORD：在创建新容器后为新容器的 postgres 用户分配的密码。

      • IMAGE_TAG：使用 16.3.0 表示最新的 Debian 映像，使用 16.3.0-ubi 表示最新的 UBI 映像。

    2. 使用 psql 连接到容器化 AlloyDB Omni：

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

      终端窗口会显示以 postgres=# 提示符结尾的 psql 登录文本。

    清理

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

    Docker

    1. 停止名为 my-omni 的 AlloyDB Omni 容器：

        docker container stop my-omni

    2. 删除名为 my-omni 的 AlloyDB Omni 容器：

        docker container rm my-omni

    Podman

    1. 停止名为 my-omni 的 AlloyDB Omni 容器：

        podman container stop my-omni

    2. 删除名为 my-omni 的 AlloyDB Omni 容器：

        podman container rm my-omni

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

    后续步骤