SQLink 部署准备与运行检查
本页供实施和运维人员准备部署、核对配置并验收服务。具体安装包、组件组合、资源大小及启动脚本使用项目交付清单；部署成功后再进行元数据采集和链路建设。
准备部署清单
部署前将以下内容落实到具体机器和负责人。
| 项目 | 应准备的内容 | 检查方法 |
|---|---|---|
| 部署形态 | 独立部署或与 DAM 集成，实际服务及节点分布 | 对照交付架构逐项登记，不混用两套拓扑 |
| 主机与存储 | 主机名、地址、部署用户、安装目录、数据及日志目录 | 部署用户可读写所需目录，容量满足项目计划 |
| 数据库 | 数据库实例、字符与大小写配置、应用账号、备份位置 | 使用应用账号验证连接及初始化所需权限 |
| 服务配置 | Nacos 地址、命名空间、各应用配置和注册地址 | 核对客户端实际可达的地址，不填容器内部不可达地址 |
| 网络 | 浏览器入口、服务间通信、采集源连接 | 按实际配置逐段检查，不仅检查首页端口 |
| 许可 | 项目要求的许可文件及关联机器信息 | 由管理员核对许可内容与部署机器 |
| 安装材料 | 组件包、服务包、前端资源、配置模板、启动脚本 | 归档交付清单，避免混用不匹配的包 |
部署用户与运行目录应保持一致。不要因为参考脚本使用某目录，就在现有生产机器上覆盖同名目录。
组件与服务职责
| 组件或服务 | 职责 | 重点检查 |
|---|---|---|
| 关系数据库 | 保存后台业务数据 | 实例、账号、库名及大小写行为 |
| Nacos | 服务注册与配置管理 | 命名空间、配置内容和服务注册状态 |
| Redis | 缓存 | 连接地址、认证及运行用户 |
| Elasticsearch | 全文搜索 | 索引服务状态、运行权限及资源限制 |
| Nebula | 图数据存储 | 图服务、存储节点注册及节点可用状态 |
| Kafka | 消息处理 | 服务连接与配置一致性 |
| 用户、基础服务 | 用户身份与公共能力 | 数据库和配置中心连接 |
| 元数据、调度、SQLink 服务 | 元数据、任务执行和血缘功能 | 服务启动日志、注册与相互调用 |
| 应用网关、Nginx | 后端路由及前端入口 | 转发目标、静态资源目录及访问路径 |
这里的“应用网关”承担平台服务路由，与 DDS 中执行动态脱敏的“安全网关”不同。数据标准等共享服务是否部署，按所采用的集成方案处理。
按顺序安装与配置
- 准备数据库实例及部署账号，核对应用初始化所需权限。
- 先安装交付清单中的基础组件，逐个确认启动成功。Nebula 还需检查存储节点已注册且可用。
- 将各微服务包展开至约定目录，核对应用包与启动脚本匹配。
- 配置启动脚本中的本机注册地址、服务端口和 Nacos 地址，按实际资源设置 JVM 内存。
- 在 Nacos 对应命名空间编辑并发布配置，逐项核对数据库、组件及服务连接。
- 以约定运行用户启动用户管理、基础服务及所需业务服务。每启动一项，就检查进程、监听、日志及注册状态。
- 部署前端静态资源，配置 Nginx 的静态目录与服务转发；核对 SQLink 入口与 API 路由。
- 进入产品，完成许可、角色、数据源等初始化，再执行下述验收。
配置中心中常见应用配置包括 datablau_usermgmt.yaml、datablau_base.yaml、datablau_metadata.yaml、datablau_sqlink.yaml 和 datablau_gateway.yaml。使用安装包实际提供的配置名称和命名空间，不凭名称相似另建一份导致服务读不到配置。
分层验收
| 层次 | 验收动作 | 成功判据 |
|---|---|---|
| 进程 | 检查各组件和微服务 | 持续运行，没有启动后退出或反复重启 |
| 注册 | 检查 Nacos 服务状态 | 注册实例地址、端口正确，应用可互相访问 |
| 入口 | 登录并打开 SQLink | 页面和静态资源正常，业务请求可返回 |
| 元数据 | 用受控数据源执行小范围采集 | 任务成功，能找到预期 Schema、表和字段 |
| 血缘 | 创建测试任务并解析已知脚本 | 报告可查看，关键上下游与脚本一致 |
| 调度 | 配置一个受控计划并检查历史 | 在预定时间触发并保留结果 |
| 权限 | 使用实际业务角色查看对象与入口 | 可见范围和操作符合授权 |
首页可打开只证明入口可用；不能替代采集、解析与调度验收。验收时保留环境配置摘要、任务标识、时间、输入样本和检查结论。
备份与恢复准备
部署资料要求定期备份数据库。实施时还应清点当前方案中的图数据、上传文件、服务配置及前端资源，将备份范围、周期、保留时间和恢复顺序纳入运维方案。不能把单个数据库备份成功理解为整个系统已可恢复。
恢复演练先在隔离环境执行，再检查登录、对象数量、关键链路和任务配置。恢复后先核对调度状态，避免原定任务立即访问不正确的数据源。
常见启动问题
| 现象 | 排查顺序 |
|---|---|
| Elasticsearch 提示不能使用 root 启动 | 改用交付方案约定的普通运行用户，检查目录归属 |
| 配置文件 AccessDeniedException | 核对运行用户对配置与数据目录的权限，不直接放开所有目录权限 |
| 文件描述符或虚拟内存映射限制不足 | 由运维按错误消息及组件要求调整系统限制，重新验证 |
| 微服务未注册或调用失败 | 检查 Nacos 地址、命名空间、注册地址、端口与网络 |
| 前端正常但接口报错 | 检查 Nginx 转发、应用网关和目标微服务日志 |
| 采集正常但血缘无法展示 | 检查 SQLink 与图服务、任务解析结果及命名空间关联 |