安装 AlloyDB Omni

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

如需简要了解 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 或更高版本
  • 已启用 cgroupv2
  • 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
  • 安装 DockerPodman 等容器运行时。AlloyDB Omni 在容器中运行。

使用 Docker 安装 AlloyDB Omni

Docker

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

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

    NEW_PASSWORD 替换为密码,以便在创建新容器后为其分配 postgres 用户。

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

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

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

Podman

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

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

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

后续步骤