快速开始部署文档中台

本文介绍如何使用 mdp-installer 安装器，完成文档中台全新环境的快速部署。

本文按 Kubernetes 单节点、在线安装 场景编写，适合首次安装、功能验证和部署流程演练。完成本文后，可以获得文档中台访问地址和 MDP 运维平台地址。

页面中的 IP 地址、安装包名称、版本号和目录均为示例。实际部署时，请以当前环境和交付物料为准。

一、部署流程概览

整个过程可以分为以下 7 步：

步骤	需要完成的操作	完成标志
1. 准备服务器和安装物料	确认服务器、安装器和文档中台发行包可用	可以登录服务器并找到安装文件
2. 启动安装器	在安装节点运行 `mdp-installer`	终端显示安装器访问地址
3. 上传发行包	在浏览器中选择文档中台发行包	页面提示发行包校验通过
4. 配置部署环境	填写节点、SSH、命名空间和数据目录	节点验证通过并可进入部署概览
5. 执行环境检查	等待安装器检查服务器和外部服务	没有阻塞安装的失败项
6. 开始安装	确认检查结果并执行部署	页面显示安装已完成
7. 保存交付信息	保存访问地址和账号信息	可以访问业务页面和 MDP 运维平台

二、部署前准备

1. 准备一台安装节点

安装节点用于运行安装器，并作为本次单节点部署的目标服务器。

开始前请确认：

已获得服务器 IP 地址。

可以通过 SSH 登录服务器。

SSH 用户为 root，或具备执行部署任务所需的权限。

服务器 CPU 架构与安装器、发行包一致，例如均为 amd64。

数据盘空间满足当前部署规格，并已确定数据目录，例如 /data。

服务器时间和时区正确。

浏览器所在电脑可以访问安装节点的 18080/TCP 端口。

如使用外部数据库或其他中间件，相关服务已准备完成，并可从安装节点访问。

正式部署前，建议先阅读“资源规划建议”，按照实际并发量、文件规模和可用性要求确定服务器规格。

2. 准备安装物料

将以下文件上传到安装节点：

文件	说明
`mdp-installer` 安装器	根据服务器架构选择对应文件，例如 `mdp-installer-amd64`。
文档中台发行包	文件名通常包含 `sdk`，并以 `.tar.gz` 结尾。具体名称以实际交付为准。

建议把文件放在同一个工作目录中，便于后续查找和保留安装资料。

三、启动安装器

1. 登录安装节点

通过 SSH 登录安装节点，进入安装器所在目录。

2. 添加执行权限

如果安装器还没有执行权限，运行：

命令中的文件名需要替换为实际安装器名称。

3. 启动 Web 安装页面

运行：

启动成功后，终端会显示两个地址：

Local：仅安装节点本机使用。

Network：同一网络中的其他电脑可访问。

在浏览器中打开终端显示的 Network 地址，例如：

http://<安装节点IP>:18080/

执行安装期间请保持安装器进程运行，不要关闭当前终端或停止进程。

四、上传文档中台发行包

1. 选择发行包

进入安装页面后：

单击“选择发行包”。

选择本次部署使用的文档中台 .tar.gz 发行包。

等待文件上传和校验完成。

2. 确认校验结果

校验通过后，页面会显示发行包名称和部署模式。

确认以下信息无误：

发行包名称与本次交付版本一致。

发行包属于文档中台产品。

部署模式显示为 Kubernetes。

确认后单击继续。

如果校验未通过，请重新确认发行包是否完整、文件类型是否正确，以及发行包是否与服务器 CPU 架构匹配。

五、配置部署环境

1. 确认网络地址

检查页面识别出的主机名或 IP 地址。该地址应为其他服务器和使用方可以正常访问的安装节点地址。

不要填写 127.0.0.1，也不要使用仅当前电脑能够访问的临时地址。

2. 选择单节点模式

在“目标环境”中选择 单节点。

单节点场景下，同一台服务器同时承担控制节点和工作节点角色，适合快速部署、功能验证及已完成单节点规划的环境。

3. 配置节点 SSH

安装器通过 SSH 连接目标节点并执行部署任务。请填写：

节点 IP 地址。

SSH 用户。

SSH 端口，默认通常为 22。

密码或私钥认证信息。

填写完成后，单击验证，确认 SSH 连接成功。

SSH 凭证只应在受控环境中使用和保管，不要把密码或私钥写入公开文档、截图或聊天记录。

4. 设置命名空间和数据目录

配置项	说明
Kubernetes 命名空间	没有既定规划时可使用页面默认值；已有命名规范时按实际规划填写。
节点数据目录	用于存放部署数据，例如 `/data`。请确认目录所在磁盘空间充足且具备读写权限。

如没有镜像仓库或外部中间件等特殊配置要求，可以先保留“高级配置”中的发行包默认值。

检查完成后，单击页面底部的 初始化部署。

六、确认部署概览

部署概览用于在正式检查前核对本次安装配置。

请重点确认：

部署模式为 Kubernetes。

发行包版本正确。

应用产品为文档中台。

节点 IP 和 SSH 用户正确。

节点角色符合单节点规划。

Kubernetes 命名空间正确。

数据目录正确。

镜像仓库配置符合当前环境。

已启用的外部中间件及其连接信息符合部署规划。

如果概览中出现数据库连接串、账号或其他凭证，只需在安装页面中核对，不要复制到公开文档或普通聊天工具中。

确认无误后单击继续，进入环境检查。

七、执行环境检查

安装器会检查节点和部署环境。检查过程可能需要几分钟，请保持页面打开。

1. 查看节点概览

节点概览会展示 SSH 连通性、系统与性能、存储与磁盘、环境等检查进度。

如需查看某个节点的详细结果，单击 查看本节点完整检查结果。

2. 查看详细检查结果

详细结果通常包含：

SSH 连通性。

执行用户权限。

操作系统兼容性。

CPU 架构、指令集和核心数。

内存容量。

时区和时间同步。

磁盘空间、目录权限和磁盘 IO。

镜像仓库连通性。

外部中间件连通性。

Kubernetes 环境残留或配置残留。

3. 理解检查状态

状态	含义	下一步操作
成功	当前检查项满足部署要求	继续等待其他项目完成
警告	不会直接阻止部署，但需要确认是否符合当前规划	打开详情，确认风险可以接受后继续
失败	当前问题会影响安装或产品运行	先修复问题，再重新扫描
运行中	安装器正在执行检查	等待检查完成，不要重复操作

检查过程中，如果某个项目长时间停留在“运行中”，可以先等待当前磁盘或远程检查完成，再决定是否重新扫描。

4. 处理警告和失败项

如果页面显示警告：

打开对应检查项的详细说明。

确认警告是否符合当前部署规划。

无法判断时，先保留页面和安装器日志，再联系实施或运维人员确认。

如果页面显示失败：

按提示修复 SSH、权限、资源、磁盘、网络或中间件问题。

单击 重新扫描。

确认失败项已经消失。

没有阻塞部署的失败项，并已确认所有警告后，单击继续。

八、开始安装

进入执行阶段后，安装器会依次完成基础设施、镜像、Kubernetes 集群、中间件和文档中台应用的部署。

页面会同时展示：

当前执行阶段和任务状态。

CPU、内存、磁盘 IO 和网络带宽。

实时执行日志。

已完成、运行中和等待中的任务。

安装过程中请注意：

不要关闭安装器进程。

不要重启安装节点。

不要刷新、后退或重复提交安装任务。

如任务失败，先查看对应任务日志中的第一条错误，再根据提示处理。

当页面显示 安装已完成 或 部署交付 时，表示安装任务已经结束。

九、保存交付信息

安装完成页面会展示：

文档中台业务访问地址。

MDP 运维平台访问地址。

初始登录账号及临时密码。

部署模式、节点数量、版本和工作目录。

“导出交付信息”和“运行检查”等操作入口。

请立即完成以下操作：

单击 导出交付信息，把文件保存到受控位置。

分别记录业务访问地址和 MDP 运维平台地址。

使用初始账号完成首次登录。

首次登录后立即修改初始密码。

单击 运行检查，确认所有服务可以正常工作。

交付信息中包含访问地址和初始凭证。不要截屏传播，不要上传到公开知识库，也不要通过非受控渠道发送。

确认交付信息已经安全保存后，可以关闭安装器。关闭安装器只会停止当前安装页面服务，不会停止已经部署的文档中台。

十、检查部署结果

完成安装后，建议按以下顺序验收：

浏览器可以打开文档中台业务访问地址。

浏览器可以打开 MDP 运维平台地址。

初始账号可以正常登录，且已完成密码修改。

安装完成页面中的“运行检查”执行通过。

MDP 运维平台可以显示当前文档中台版本和服务状态。

可以进入“授权管理”，获取机器码并完成许可证激活。

授权完成后，可以进入“应用管理”创建接入应用。

文档中台安装完成后，还需要完成许可证激活和应用配置，才能进入正式的业务接入与验证阶段。

十一、常见问题

1. 浏览器无法打开安装页面

依次检查：

安装器进程是否仍在运行。

访问地址是否使用安装节点的实际 IP。

18080/TCP 端口是否已经放通。

浏览器所在电脑与安装节点之间的网络是否连通。

2. 发行包校验失败

检查：

上传的文件是否为完整的 .tar.gz 发行包。

文件名是否属于文档中台产品。

发行包与服务器 CPU 架构是否匹配。

文件在上传或传输过程中是否损坏。

3. SSH 验证失败

检查：

节点 IP 和 SSH 端口是否正确。

SSH 用户、密码或私钥是否正确。

SSH 用户是否具备部署所需权限。

防火墙或安全组是否允许 SSH 连接。

4. 环境检查出现警告

警告不会直接阻止部署，但需要打开详情确认影响。如果涉及磁盘性能、时间同步、配置残留或外部中间件，请先确认是否符合本次部署规划，再决定是否继续。

5. 环境检查出现失败

失败项需要先修复。不要直接绕过检查开始安装。修复后单击“重新扫描”，确认失败项已经通过。

6. 安装任务失败

打开失败任务的执行日志。

找到最先出现的错误信息。

保存安装器日志、失败任务名称和发生时间。

处理对应的网络、磁盘、镜像、中间件或 Kubernetes 问题后，再按实际恢复方式继续。

一、部署流程概览#

二、部署前准备#

1. 准备一台安装节点#

2. 准备安装物料#

三、启动安装器#

1. 登录安装节点#

2. 添加执行权限#

3. 启动 Web 安装页面#

四、上传文档中台发行包#

1. 选择发行包#

2. 确认校验结果#

五、配置部署环境#

1. 确认网络地址#

2. 选择单节点模式#

3. 配置节点 SSH#

4. 设置命名空间和数据目录#

六、确认部署概览#

七、执行环境检查#

1. 查看节点概览#

2. 查看详细检查结果#

3. 理解检查状态#

4. 处理警告和失败项#

八、开始安装#

九、保存交付信息#

十、检查部署结果#

十一、常见问题#

1. 浏览器无法打开安装页面#

2. 发行包校验失败#

3. SSH 验证失败#

4. 环境检查出现警告#

5. 环境检查出现失败#

6. 安装任务失败#