备份与恢复
为 HA 集群建立一致的恢复点,在异地导入并验收,通过后再接入业务流量。
1. 导出控制状态并校验副本
HA 集群随包提供 systemd 定时器,每小时从共享集群配置导出模型、已发布版本、角色等控制状态。在指定备份主机安装发行包,配置同一份集群配置及读取控制状态的凭据。使用 catalog 本地表时,备份服务的 GRAPHLAKE_BACKUP_CATALOG_DIR 应指向实际 catalog。
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将完整恢复点及相关文件同步到独立站点,按照含凭据的数据保护备份。在异地对完成同步的副本执行校验,确认归档可读。
/opt/graphlake/current/bin/graphlake-admin backup verify \
--file /srv/graphlake-replica/checkpoint-001/control.json2. 绑定同一业务时点的数据
当恢复点包含外部来源时,在同一业务时点暂停控制状态与来源数据写入。导出控制备份,使用 PostgreSQL 时执行 pg_dump -Fc,并复制模型引用的确切 Parquet 文件。对清单中的每张 PostgreSQL 表使用下方命令计算内容摘要。
/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,记录至少一条验收查询及恢复后应返回的完整结果。
{
"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 地址核对就绪状态,通过验收且就绪后再切流。在验收和切流完成前保持来源写入暂停。
恢复后按身份目录重新分配成员权限,为应用签发新凭据。旧用户及服务账号访问会停用,历史会话会清空。验证旧凭据无法访问、新权限正常,以及已启用协议和监控探测通过生产入口恢复。