备份与恢复

为 HA 集群建立一致的恢复点,在异地导入并验收,通过后再接入业务流量。

本页目录

1. 导出控制状态并校验副本

HA 集群随包提供 systemd 定时器,每小时从共享集群配置导出模型、已发布版本、角色等控制状态。在指定备份主机安装发行包,配置同一份集群配置及读取控制状态的凭据。使用 catalog 本地表时,备份服务的 GRAPHLAKE_BACKUP_CATALOG_DIR 应指向实际 catalog。

Shell
sudo install -m 0644 /opt/graphlake/current/graphlake-backup.service /etc/systemd/system/
sudo install -m 0644 /opt/graphlake/current/graphlake-backup.timer /etc/systemd/system/
sudo systemctl daemon-reload
sudo systemctl start graphlake-backup.service
sudo systemctl enable --now graphlake-backup.timer
sudo systemctl list-timers graphlake-backup.timer

将完整恢复点及相关文件同步到独立站点,按照含凭据的数据保护备份。在异地对完成同步的副本执行校验,确认归档可读。

Shell
/opt/graphlake/current/bin/graphlake-admin backup verify \
  --file /srv/graphlake-replica/checkpoint-001/control.json

2. 绑定同一业务时点的数据

当恢复点包含外部来源时,在同一业务时点暂停控制状态与来源数据写入。导出控制备份,使用 PostgreSQL 时执行 pg_dump -Fc,并复制模型引用的确切 Parquet 文件。对清单中的每张 PostgreSQL 表使用下方命令计算内容摘要。

Shell
/opt/graphlake/current/bin/graphlake-admin backup fingerprint-postgres \
  --dsn-env LEDGER_DSN --relation ledger.accounts --relation ledger.transfers

把 manifest.json 与 control.json 放在同一目录。清单引用 PostgreSQL 时放入 postgres.dump,Parquet 使用相对于恢复点的路径。本地表导出的 local-<id> 目录也放在同级。填入真实的小写 SHA-256 与发布版本 active_revision,记录至少一条验收查询及恢复后应返回的完整结果。

JSON
{
  "format": 1,
  "control_sha256": "<control.json sha256 field>",
  "postgres": {
    "dump_sha256": "<postgres.dump SHA-256>",
    "dsn_env": "LEDGER_DSN",
    "relations": {
      "ledger.accounts": "<accounts fingerprint>",
      "ledger.transfers": "<transfers fingerprint>"
    }
  },
  "parquet": {
    "payments.parquet": "<payments.parquet SHA-256>"
  },
  "canaries": [
    {
      "model": "ledger",
      "revision": "<published active_revision>",
      "language": "cypher",
      "query": "MATCH (:Account)-[:Transfer]->(:Account) RETURN count(*) AS transfers",
      "expected_rows": [
        [
          "4"
        ]
      ]
    }
  ]
}

没有对应外部源时,可省略 postgres 或 parquet 项。只使用本地副本的模型可从控制归档取得本地表文件清单。详细约定见恢复清单参考。

3. 在目标站导入

目标站使用新的集群名和 S3 前缀,独立初始化管理员凭据。备用 Coordinator 采用相同的恢复配置。将 GRAPHLAKE_RESTORE_INBOX 指向可信的只读目录,每个恢复点占一个子目录。准备可写的来源目录,按需准备版本兼容的空 PostgreSQL 数据库。GRAPHLAKE_RESTORE_POSTGRES_DSN_ENV 填写清单指定的目标站 DSN 变量名。

为目标站各 Coordinator 配置同一个恢复专用 GRAPHLAKE_RECOVERY_TOKEN,启动目标集群与 TLS 恢复路由。通过可信客户端访问目标 HTTPS 的 /recovery,输入令牌、选择恢复点并执行检查和导入。开始写入后若中断,使用同一个恢复点重试。

4. 通过验收后接入流量

在目标站 /recovery 执行验收,核对恢复点、目标数据、已发布模型版本和查询结果。通过真实业务 HTTPS 地址核对就绪状态,通过验收且就绪后再切流。在验收和切流完成前保持来源写入暂停。

恢复后按身份目录重新分配成员权限,为应用签发新凭据。旧用户及服务账号访问会停用,历史会话会清空。验证旧凭据无法访问、新权限正常,以及已启用协议和监控探测通过生产入口恢复。