自定义 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 的可用存储空间。
在操作系统内拥有不受限制的 root 访问权限。
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 的可用存储空间。
在操作系统内拥有不受限制的 root 访问权限。
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

安装 AlloyDB Omni CLI。
使用 AlloyDB Omni CLI 确认您的 Linux 机器是否已准备好安装 AlloyDB Omni：
```
sudo alloydb system-check
```
如有必要，请修改您的系统，直到 system-check 命令的输出返回成功检查结果。
可选：如需为 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"
```
使用以下选项之一安装服务器软件：

注意：如需安装启用了机器学习 (ML) 功能（包括查询大语言模型 [LLM] 的功能）的 AlloyDB Omni，请参阅安装启用了 AlloyDB AI 的 AlloyDB Omni。
- 如需将服务器配置为主实例，请运行以下命令：
```
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 读取副本，请参阅创建只读副本。
如果您的系统运行的是 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 登录文本。