为 AlloyDB Omni 设置 Barman

选择文档版本：

本页面介绍了如何通过将 AlloyDB Omni 配置为与开源数据库备份服务器 Barman 配合使用，来保护数据。

您可以使用与 PostgreSQL 兼容的任何数据库备份技术来保护 AlloyDB Omni 数据。例如，您可以将 AlloyDB Omni 配置为允许从您控制的 Barman 服务器进行连接。这使 Barman 服务器可以对存储在 AlloyDB Omni 服务器中的数据执行持续备份。

将 Barman 和 AlloyDB Omni 服务器配置为协同工作后，您可以随后运行 Barman 命令来完成各种数据保护和灾难恢复任务，包括以下这些：

  • 创建数据的按需备份。
  • 设置同步 WAL 流式传输，以将数据更改传输到备份服务器。
  • 从特定备份恢复。
  • 执行时间点恢复。

如需详细了解 Barman 的操作，请参阅 Barman 手册。

准备工作

在将 AlloyDB Omni 配置为与 Barman 配合使用之前，您需要满足以下条件：

将 AlloyDB Omni 配置为与 Barman 配合使用

如需准备好 AlloyDB Omni 服务器以便与 Barman 配合使用，请在安装了 AlloyDB Omni 的服务器上运行以下命令。

  1. 创建具有适当权限的 barman 数据库用户：

    Docker 

    docker exec CONTAINER_NAME psql -h localhost -U postgres -c "
CREATE USER barman;
GRANT EXECUTE ON FUNCTION pg_backup_start(text, boolean) to barman;
GRANT EXECUTE ON FUNCTION pg_backup_stop(boolean) to barman;
GRANT EXECUTE ON FUNCTION pg_switch_wal() to barman;
GRANT EXECUTE ON FUNCTION pg_create_restore_point(text) to barman;
GRANT pg_read_all_settings TO barman;
GRANT pg_read_all_stats TO barman;
CREATE USER streaming_barman WITH REPLICATION;
"

    将 CONTAINER_NAME 替换为您在安装 AlloyDB Omni 容器时为其分配的名称。

    Podman

    podman exec CONTAINER_NAME psql -h localhost -U postgres -c "
CREATE USER barman;
GRANT EXECUTE ON FUNCTION pg_backup_start(text, boolean) to barman;
GRANT EXECUTE ON FUNCTION pg_backup_stop(boolean) to barman;
GRANT EXECUTE ON FUNCTION pg_switch_wal() to barman;
GRANT EXECUTE ON FUNCTION pg_create_restore_point(text) to barman;
GRANT pg_read_all_settings TO barman;
GRANT pg_read_all_stats TO barman;
CREATE USER streaming_barman WITH REPLICATION;
"

    将 CONTAINER_NAME 替换为您在安装 AlloyDB Omni 容器时为其分配的名称。

  2. 在 DATA_DIR/pg_hba.conf 文件中，将以下代码行添加到文件中存在的 host all all all scram-sha-256 行之前：

    host all barman BARMAN_IP/32 AUTHN_METHOD
host replication streaming_barman BARMAN_IP/32 AUTHN_METHOD

    替换以下内容：

    • DATA_DIR：用于 AlloyDB Omni 数据目录的文件系统路径。

    • BARMAN_IP：Barman 服务器的 IP 地址。

    • AUTHN_METHOD：AlloyDB for PostgreSQL 服务器期望从 Barman 服务器实现的 PostgreSQL 身份验证方法。我们建议使用以下值之一：

      • 如需允许 Barman 服务器在不使用密码的情况下进行身份验证，请使用 trust。

      • 如需要求 Barman 服务器提供密码，请使用 scram-sha-256。

  3. 将以下代码行添加到 DATA_DIR/postgresql.conf 文件中：

    archive_command='/bin/true'
archive_mode=on
listen_addresses='*'
wal_level='replica'

  4. 重启 AlloyDB Omni 服务：

    Docker 

    docker restart CONTAINER_NAME

    Podman

    podman restart CONTAINER_NAME

    将 CONTAINER_NAME 替换为您在安装 AlloyDB Omni 容器时为其分配的名称。

  5. 通过运行以下命令，确认所有必要参数均已正确设置：

    Docker 

    docker exec CONTAINER_NAME psql -h localhost -U postgres -c "
SELECT name, setting
   FROM pg_catalog.pg_settings
   WHERE name IN ('archive_command',
                  'archive_mode',
                  'listen_addresses',
                  'wal_level')
   ORDER BY name;"

    Podman

    podman exec CONTAINER_NAME psql -h localhost -U postgres -c "
SELECT name, setting
   FROM pg_catalog.pg_settings
   WHERE name IN ('archive_command',
                  'archive_mode',
                  'listen_addresses',
                  'wal_level')
   ORDER BY name;"

    输出如下所示：

       name          |  setting
------------------|-----------
archive_command   | /bin/true
archive_mode      | on
listen_addresses  | *
wal_level         | replica
(4 rows)

设置 Barman 备份服务器

如需设置和配置 Barman 以与 AlloyDB Omni 服务器配合使用，请在 Barman 服务器上运行以下命令。

  1. 验证流式传输复制连接是否正常工作：

    psql -h DATABASE_IP -U streaming_barman -c "IDENTIFY_SYSTEM" replication=1

    输出类似于以下内容：

          systemid       | timeline |  xlogpos   | dbname
---------------------+----------+------------+--------
 7265722823667040273 |        1 | 0/1F0AFCD0 |
(1 row)

  2. 确保 Barman 可以以 barman 数据库用户身份连接到 AlloyDB Omni 服务器。

    psql -t -h DATABASE_IP -U barman -d postgres -c "SELECT 'Connected as: '||current_user"

    将 DATABASE_IP 替换为 AlloyDB Omni 服务器的 IP 地址。

    输出类似于以下内容：

    Connected as: barman

  3. 根据自己的需求和偏好配置 Barman 备份服务器。

    配置必须包含以下设置：

    • 设置 conninfo，以便以 barman 用户身份连接到 AlloyDB Omni postgres 数据库。
    • 将 streaming_conninfo 设置为使用 streaming_barman 用户。
    • 按照 Barman 文档的说明，配置启用 WAL 流式传输所需的其他指令。

    以下很小但完整的示例修改了 Barman 文档中的流式传输配置示例：

    [CONFIGURATION_TAG]
description = "Backup settings for my AlloyDB Omni server"
conninfo = host=DATABASE_IP user=barman dbname=postgres
streaming_conninfo = host=DATABASE_IP user=streaming_barman
backup_method = postgres
streaming_archiver = on
slot_name = barman

    替换以下内容：

    • CONFIGURATION_TAG：在运行 barman 命令时用于标识此服务器配置的简短标记，例如 omni。

    • DATABASE_IP：AlloyDB Omni 服务器的 IP 地址。

  4. 切换到 barman 用户。

    sudo su - barman

  5. 使用 barman receive-wal 命令创建复制槽，然后开始从数据库服务器接收 WAL 流：

    barman receive-wal --create-slot CONFIGURATION_TAG
barman receive-wal CONFIGURATION_TAG &

    将 CONFIGURATION_TAG 替换为您在上一步中选择的配置标记。

Barman 现已配置为与 AlloyDB Omni 服务器配合使用。如需检查复制状态、创建手动备份和执行其他任务，请参阅常规命令。

例如，如需创建手动备份，请运行 barman backup 命令。

后续步骤