自定义 AlloyDB Omni 安装

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

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

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

准备工作

下载并安装 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 登录文本。