在虚拟机上安装 AlloyDB Omni

选择文档版本：

本页面介绍了如何在支持容器运行时的任何 Linux 虚拟机上执行 AlloyDB Omni 的单实例安装。如果您需要 AlloyDB Omni 的多实例配置，请参阅高可用性和数据弹性。

准备工作

在将 AlloyDB Omni 安装到虚拟机之前，请执行以下操作：

  1. 请参阅规划在虚拟机上安装 AlloyDB Omni。
  2. 请参阅以有根或无根方式运行 AlloyDB Omni，并根据您选择的环境完成有根或无根方式所需的所有步骤。

以有根或无根方式运行 AlloyDB Omni

您可以使用 Docker 或 Podman 运行 AlloyDB Omni。这两种容器引擎都可以以有根或无根方式运行。有根方式是指以根用户身份运行 Docker 或 Podman，而无根方式是指以非根用户或无特权用户身份运行 Docker 或 Podman。

您选择的模式取决于您对环境的要求和偏好。如果简易性十分重要，那么有根方式可能适合您。如果您需要无特权用户的安全性，那么无根方式可能是您的理想之选。

如果您决定运行有根环境，则需要决定如何管理容器与宿主机之间的用户映射。在实践中，AlloyDB Omni 以 postgres 用户身份运行进程，该用户的 UID 和 GID 为 999。这意味着，您可以通过以下两种方式管理用户映射：

  • 不执行任何操作。postgres 将继续不映射到宿主机上的任何用户。
  • 创建一个 UID 和 GID 均为 999 的用户和用户群组，以便 postgres 映射到该用户和用户群组。

对于无根环境，postgres 会映射到主机用户和用户群组有权访问的子 UID 和子 GID（在 /etc/subuid 和 /etc/subgid 文件中定义）。这意味着您无需管理用户映射。

（无根方式）配置子 UID 和子 GID 范围

如果您的 Linux 映像尚未为无特权用户配置子 UID 和子 GID 范围，则您必须配置它们才能以无根方式运行 AlloyDB Omni。

  1. 如果您使用的是 Debian 系统，请安装 newuidmap 和 newgidmap 二进制文件。

    apt-get install -y uidmap

  2. 为无根用户添加 subuid 条目。

    echo "ROOTLESS_USER:SUB_UID_RANGE_START:SUB_UID_RANGE_COUNT" >> /etc/subuid

    执行以下变量替换操作：

    • ROOTLESS_USER：您要以其身份运行 AlloyDB Omni 的用户。
    • SUB_UID_RANGE_START：您要为用户注册的子 UID 范围的起始编号。
    • SUB_UID_RANGE_COUNT：您要为用户注册的子 UID 数量。此值必须至少为 999。

  3. 为无根用户添加 subgid 条目。

    echo "ROOTLESS_USER:SUB_GID_RANGE_START:SUB_GID_RANGE_COUNT" >> /etc/subgid

    执行以下变量替换操作：

    • ROOTLESS_USER：您要以其身份运行 AlloyDB Omni 的用户。
    • SUB_GID_RANGE_START：您要为用户注册的子 GID 范围的起始编号。
    • SUB_GID_RANGE_COUNT：您要为用户注册的子 GID 数量。此值必须至少为 999。

  4. 如果您希望在用户未登录时运行 AlloyDB Omni 实例，请运行以下命令。

    loginctl enable-linger ROOTLESS_USER

    执行以下变量替换操作：

    • ROOTLESS_USER：您要以其身份运行 AlloyDB Omni 的用户。

  5. 如果您使用的是 Docker，请以 ROOTLESS_USER 身份运行以下命令。

    /usr/bin/dockerd-rootless-setuptool.sh install

  6. 打开一个新的 shell，以使子 UID 和子 GID 更改生效。

创建 AlloyDB Omni 存储数据的目录

如果您使用的存储系统不仅仅是运行 AlloyDB Omni，您可以在设备的现有文件系统上创建 AlloyDB Omni 目录。否则，您可以在专用设备上创建新的文件系统。

现有文件系统

Docker

mkdir -p DATA_DIR

Docker

mkdir -p DATA_DIR

Podman

mkdir -p DATA_DIR

Podman

mkdir -p DATA_DIR

执行以下变量替换操作：

  • DATA_DIR：存储数据的主机目录路径。

专用设备

  1. 在将装载磁盘的主机上创建一个目录。

    mkdir -p MOUNT_POINT

    执行以下变量替换操作：

    • MOUNT_POINT：应包含 AlloyDB Omni 实例的顶层目录路径。

  2. 在磁盘设备上创建包含单个分区的 gpt 分区表。

    parted -s DEVICE_PATH mklabel gpt
parted -s DEVICE_PATH mkpart primary 0% 100%

    执行以下变量替换操作：

    • DEVICE_PATH：操作系统为磁盘设备分配的路径。

  3. 在磁盘设备上创建文件系统。我们建议为 AlloyDB Omni 使用 ext4 文件系统。

    mkfs.ext4 -q -m 1 -L FS_LABEL -F PARTITION_PATH

    执行以下变量替换操作：

    • FS_LABEL：文件系统的标签。ext4 文件系统标签的长度上限为 16 个字符。
    • PARTITION_PATH：用于存储容器数据的磁盘分区的路径。

  4. 装载设备并在 /etc/fstab 文件中创建条目，以便在重启后装载磁盘。

    echo -e "LABEL=FS_LABEL\tMOUNT_POINT\text4\tdefaults\t0 0" | tee -a /etc/fstab
systemctl daemon-reload
mount MOUNT_POINT

    执行以下变量替换操作：

    • FS_LABEL：文件系统的标签。ext4 文件系统标签的长度上限为 16 个字符。
    • MOUNT_POINT：应包含 AlloyDB Omni 实例的顶层目录路径。

  5. 在特定于容器的文件系统中创建数据目录。

    有根方式

    mkdir -p DATA_DIR

    无根方式

    mkdir -p DATA_DIR
chown ROOTLESS_USER:ROOTLESS_GROUP DATA_DIR

    执行以下变量替换操作：

    • DATA_DIR：存储数据的主机目录路径。
    • ROOTLESS_USER：如果您使用的是无根环境，则这是您希望拥有相应目录的用户。
    • ROOTLESS_GROUP：如果您使用的是无根环境，则这是您希望拥有相应目录的群组。

创建容器

Docker

docker run -d --name CONTAINER_NAME \
-e POSTGRES_PASSWORD=NEW_PASSWORD \
-v DATA_DIR:/var/lib/postgresql/data \
-p HOST_PORT:5432 \
--restart=always \
google/alloydbomni:latest

Docker

docker run -d --name CONTAINER_NAME \
-e POSTGRES_PASSWORD=NEW_PASSWORD \
-v DATA_DIR:/var/lib/postgresql/data \
-p HOST_PORT:5432 \
--restart=always \
google/alloydbomni:latest

Podman

podman run -d --name CONTAINER_NAME \
-e POSTGRES_PASSWORD=NEW_PASSWORD \
-v DATA_DIR:/var/lib/postgresql/data \
-p HOST_PORT:5432 \
--restart=always \
docker.io/google/alloydbomni:latest

Podman

podman run -d --name CONTAINER_NAME \
-e POSTGRES_PASSWORD=NEW_PASSWORD \
-v DATA_DIR:/var/lib/postgresql/data \
-p HOST_PORT:5432 \
--restart=always \
docker.io/google/alloydbomni:latest

执行以下变量替换操作：

  • CONTAINER_NAME：您在创建 AlloyDB Omni 存储数据的目录中为相应目录使用的名称。
  • NEW_PASSWORD：在创建后向新容器的 postgres 用户分配的密码。
  • DATA_DIR：存储数据的主机目录路径。
  • HOST_PORT：容器应将自己的端口 5432 发布到的宿主机上的 TCP 端口。如需也在宿主机上使用 PostgreSQL 默认端口，请指定 5432。

连接到您的实例

根据您的环境，您可以在本地或远程连接到 AlloyDB Omni 实例。

在本地连接

Docker

docker exec -it CONTAINER_NAME psql -U postgres

Docker

docker exec -it CONTAINER_NAME psql -U postgres

Podman

podman exec -it CONTAINER_NAME psql -U postgres

Podman

podman exec -it CONTAINER_NAME psql -U postgres

执行以下变量替换操作：

远程连接

psql -U postgres -p HOST_PORT -h IP_ADDRESS_OR_FQDN

执行以下变量替换操作：

  • HOST_PORT：您在创建容器中使用的 TCP 端口。
  • IP_ADDRESS_OR_FQDN：运行 AlloyDB Omni 的主机的 IP 地址或完全限定域名。

运行此命令后，系统会要求您输入 postgres 账号的密码。输入您在创建容器中使用的密码。

后续步骤