自定义 AlloyDB Omni 安装

选择文档版本：

本页面介绍如何下载、安装和连接到 AlloyDB Omni。如需使用默认配置快速开始使用 AlloyDB Omni，请参阅在 Debian 或 Ubuntu 上安装 AlloyDB Omni。

在本文档中，您还将了解如何执行以下操作：

  • 创建新的磁盘分区以优化数据存储。
  • 配置服务器。
  • 确保与 Debian、Ubuntu 和 RHEL 兼容。

准备工作

系统要求

Debian

  • 运行基于 Debian 的操作系统（例如 Debian 或 Ubuntu）的虚拟机或实体机器。
  • 至少 2 个 CPU，采用 x86/AMD64 架构。
  • 至少 2 GB RAM。为了获得最佳性能，我们建议为每个 CPU 分配 8 GB 的 RAM。
  • 至少有 20 GB 的可用存储空间。
  • 在操作系统中拥有不受限制的根访问权限。
  • Docker 20.10 版或更高版本。
  • Linux 内核版本为 4.18 或更高版本。为了获得最佳性能，我们建议使用内核版本 5.3 或更高版本。
  • 启用了 Linux cgroup v2。

    默认情况下，大多数现代 Linux 系统上都已启用 cgroup v2。 如需检查是否启用了 cgroup v2，请在 shell 中运行 stat -fc %T /sys/fs/cgroup/。如果启用了 cgroup v2，则命令输出会显示 cgroup2fs。

  • 如果您想与 Vertex AI 集成，则需要在环境中安装 Google Cloud CLI。

  • 如需在云平台上安装 AlloyDB Omni，我们建议您使用以下实例类型：
    • 在 Google Cloud上，我们建议使用 n2-highmem 实例。
    • 在 Amazon Web Services 上，我们建议使用 R6i 实例。
    • 在 Microsoft Azure 上，我们建议使用 Ebsv5 实例。
  • 我们建议您使用专用的 SSD 存储设备来存储数据。如果您将实体设备用于此用途，我们建议您将其直接挂接到宿主机。

RHEL

  • 运行 Red Hat Enterprise Linux (RHEL) 8 版或更高版本的虚拟机或实体机器。如要让 AlloyDB Omni 的自动内存管理功能可以正常使用，您需要使用 RHEL 9 版或更高版本。
  • 至少 2 个 CPU，采用 x86/AMD64 架构。
  • 至少 2 GB RAM。为了获得最佳性能，我们建议为每个 CPU 分配 8 GB 的 RAM。
  • 至少有 20 GB 的可用存储空间。
  • 在操作系统中拥有不受限制的根访问权限。
  • Docker 20.10 版或更高版本。
  • Linux 内核版本为 4.18 或更高版本。为了获得最佳性能，我们建议使用内核版本 5.3 或更高版本。
  • 启用了 Linux cgroup v2。

    默认情况下，大多数现代 Linux 系统上都已启用 cgroup v2。 如需检查是否启用了 cgroup v2，请在 shell 中运行 stat -fc %T /sys/fs/cgroup/。如果启用了 cgroup v2，则命令输出会显示 cgroup2fs。

  • 如果您想与 Vertex AI 集成，则需要在环境中安装 Google Cloud CLI。

  • 如需在云平台上安装 AlloyDB Omni，我们建议您使用以下实例类型：
    • 在 Google Cloud上，我们建议使用 n2-highmem 实例。
    • 在 Amazon Web Services 上，我们建议使用 R6i 实例。
    • 在 Microsoft Azure 上，我们建议使用 Ebsv5 实例。
  • 我们建议您使用专用的 SSD 存储设备来存储数据。如果您将实体设备用于此用途，我们建议您将其直接挂接到宿主机。

下载并安装 AlloyDB Omni

  1. 安装 AlloyDB Omni CLI。

  2. 使用 AlloyDB Omni CLI 确认您的 Linux 机器已准备好安装 AlloyDB Omni：

    sudo alloydb system-check

    如有必要，请修改系统，直到 system-check 命令的输出返回成功检查结果。

  3. 可选：如需为 AlloyDB Omni 创建一个用于数据存储的新磁盘分区，我们建议您使用 ext4 文件系统，以实现最佳性能。

    1. 如需创建 ext4 文件系统，请使用以下命令：

      mkfs.ext4 -m 1 -F "$disk_path"

    2. 如需装载磁盘，请使用以下命令：

      mount --make-shared -o noatime,discard,errors=panic "$disk_path" "$disk_mountpoint"

  4. 使用以下选项之一安装服务器软件：

    • 如需将服务器配置为主实例，请运行以下命令：

      sudo alloydb database-server install --data-dir=$(realpath DATA_DIR)

      将 DATA_DIR 替换为本地文件系统上您想要 AlloyDB Omni 在其中存储其数据、元数据和配置文件的目录。如果该目录尚不存在，AlloyDB Omni 会尝试创建该目录。如果您未指定此值，则 AlloyDB Omni 默认会使用 /var/alloydb/main/。

      如需让 AlloyDB Omni 监听默认 5432 以外的 TCP 端口上的连接，请添加 --pg-port 标志：

      sudo alloydb database-server install \
    --data-dir=$(realpath DATA_DIR) \
    --pg-port=PORT

      将 PORT 替换为您想要 AlloyDB Omni 在其上接受连接的 TCP 端口。

    • 如需将服务器配置为读取副本，请添加 --replica-source-ip 和 --replica-source-port 标志：

      sudo alloydb database-server install \
    --data-dir=$(realpath DATA_DIR) \
    --replica-source-ip=SOURCE_IP \
    --replica-source-port=SOURCE_PORT

      替换以下内容：

      • DATA_DIR：本地文件系统上您想要 AlloyDB Omni 在其中存储其数据、元数据和配置文件的目录。如果该目录尚不存在，AlloyDB Omni 会尝试创建该目录。如果您未指定此值，则 AlloyDB Omni 默认会使用 /var/alloydb/main/。

      • SOURCE_IP：要从中复制的 AlloyDB Omni 主实例的 IP 地址。

      • SOURCE_PORT：要从中复制的 AlloyDB Omni 主实例的 TCP 端口。如果您未提供此值，AlloyDB Omni 会应用默认值 5432。

      如需详细了解 AlloyDB Omni 读取副本，请参阅创建只读副本。

  5. 如果您的系统运行的是 Red Hat Enterprise Linux，请使用以下内容更新 /usr/lib/tuned/virtual-guest/tuned.conf 文件：

    vm.swappiness=1

连接并使用数据库服务器

使用 psql 连接到 AlloyDB Omni：

sudo docker exec -it pg-service psql -h localhost -U postgres

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