部署与运维
选择部署方式,并在接入业务流量前验证服务健康、访问权限和恢复流程。
选择部署方式
- 单机服务
- 安装一个 graphlake-admin 进程,提供浏览器、HTTP 及可选的 Bolt、Gremlin 入口。
- 分布式服务
- 使用 Coordinator 和私有 Worker 执行受支持的分布式操作。各节点保持相同构建版本,并能访问映射数据。
- Coordinator 故障接管
- 使用 etcd 选主、S3 兼容存储共享控制状态,在 TLS 入口探测当选的 Coordinator。
配置、启动、HA 和验收步骤见集群安装指南。
配置入口与权限
多人使用浏览器时,配置 HTTPS 反向代理,把 --public-url 设置为浏览器使用的确切源地址。按模型分配查询、导出、建模、发布和审计权限。应用驱动使用角色化服务账号,AI 客户端使用受权限约束的个人令牌。
数据库凭据保存在服务端环境配置。代理请求头和各协议的配置见服务与客户端参考。
检查健康与数据访问
通过 /healthz 查看运行构建,使用 /readyz 检查就绪状态。在运行健康界面探测已发布模型的来源和 Worker,并通过业务入口运行结果已知的查询。按需采集 Prometheus 指标、审计事件和 OpenTelemetry 信号。
探测及遥测配置见监控指南。
升级、回退与恢复
备份 catalog 和凭据配置,保留旧程序。停止单机服务,把新发行包解压到独立目录,按需切换 current 与 systemd 单元后启动。检查运行版本、模型版本和已知查询;回退时切回旧程序,必要时恢复配套的 catalog。
异地恢复点应绑定控制状态、PostgreSQL 和 Parquet 快照及预期查询结果。在目标站点的 /recovery 页面导入恢复点,通过验收后再接入流量。保留控制归档引用的本地表文件。单机部署另行备份 catalog。