安装 AlloyDB Omni

选择文档版本:

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

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

准备工作

选择下载或安装选项

媒体 下载位置及安装指南 部署目标
Debian 映像 DockerHub(标记)
  • DockerPodman。您可以在任何虚拟机 (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 或更高版本
  • (*) AlloyDB Omni 支持 Arm(预览版)。

    验证是否已启用 cgroupsv2

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

    grep cgroup /proc/filesystems
    

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

    nodev cgroup
    nodev cgroupsv2
    

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

    nodev cgroup
    

    安装容器运行时

    安装容器运行时,例如 DockerPodman。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:15

      NEW_PASSWORD 替换为创建新容器后为新容器的 postgres 用户分配的密码。

    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:15

      NEW_PASSWORD 替换为创建新容器后为新容器的 postgres 用户分配的密码。

    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 安装页面。

    后续步骤