单机部署【k3s】

1. 适用场景

文档中台 K3s 单机部署适合轻量级小团队、200 QPS以下小规模使用、PoC、功能验证和短期测试。

这篇文档按 1 台服务器说明。这台服务器同时承担安装节点、K3s 主节点和业务工作节点，整体可用性取决于这台服务器的稳定性。

2. 部署前准备

2.1 先准备这些信息

信息	示例	说明
网络环境	在线 / 离线	支持公网访问选在线；内网或离线环境选离线
安装节点 IP	`<安装节点IP>`	这台服务器就是唯一部署节点
执行用户	`root`	安装命令使用 `root` 执行
访问协议	HTTP / HTTPS	测试环境可用 HTTP；正式或对外访问建议 HTTPS
访问域名	`<访问域名>`	访问文档中台 Demo 页和接口服务的地址
数据目录	`/data`	建议挂载独立数据盘
安装工具	`mdp-installer`	石墨提供的安装器
产品安装包	文档中台安装包	以实际交付文件名为准
离线镜像包	`*.tar.gz`	仅离线安装需要
外部中间件	有 / 无	有外部中间件时，提前准备地址、端口、账号、密码

2.2 服务器最低要求

项目	要求
服务器数量	1 台
CPU	16 Core 以上
内存	32 GB 以上
系统盘	根 `/` 分区 100 GB 以上
数据盘	独立挂载 `/data`，可用空间 300 GB 以上
离线安装	数据盘建议额外预留 100 GB 以上

注意：

/root、/var、/tmp 建议放在根分区下统一管理。

数据目录统一放到 /data。

安装前确认服务器时间同步正常。

可先执行：

3. 上传安装工具和安装包

注意根据实际情况修改命令中的文件名称，例如安装器包名在x86架构环境为 mdp-installer-amd64。

根据实际场景选择适合的上传方式，本文以scp命令行说明，亦可使用其它图形化ssh工具上传。

在本地电脑执行下面命令，把安装器传到服务器：

离线安装还要上传离线镜像包：

登录服务器：

给安装器加执行权限：

启动安装器 Web 页面：

浏览器访问：

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

4. 通过 Web 页面安装

4.1 上传产品安装包

打开 http://<安装节点IP>:18080。

点击 GET STARTED。

上传文档中台安装包。

上传完成后点击 CONTINUE。

4.2 配置访问域名和容器网段

填写访问文档中台的方式：

配置项	怎么填
协议	HTTP 或 HTTPS
访问域名 / IP	`<访问域名>` 或 `<安装节点IP>`
Service CIDR	默认 `10.43.0.0/16`
Pod CIDR	默认 `10.42.0.0/16`

Pod CIDR 和 Service CIDR 需避开现网、办公网、VPN、IDC 网段。发现网段重合时，先调整网段，再继续部署。

4.3 配置 K8s 节点

单机部署只添加 1 个节点。

配置项	怎么选
部署模式	`Single Node Mode`
节点 IP	`<安装节点IP>`
SSH 端口	通常为 `22`
SSH 密码	`root` 用户密码
节点类型	`master`
namespace	按项目约定填写；没有约定可使用默认值
数据目录	`/data`

单机模式下，这 1 个节点同时作为 master 和 worker 使用。

4.4 选择中间件

使用内置中间件时，保持默认勾选，由安装器部署组件。

文档中台常用组件包括：

MySQL

Redis

MongoDB

MinIO

Kafka

ClickHouse

如果页面出现 Elasticsearch，按交付配置确认是否需要；未使用时可取消勾选。

如果使用外部中间件，就取消对应组件勾选，并在后续页面填写连接信息。

4.5 在线安装

服务器可以访问公网时，使用在线安装。按页面默认配置继续即可。

4.6 离线安装

服务器处于内网或离线环境时，使用离线安装。

操作步骤：

勾选 Enable Offline Installation Mode。

点击 Browse files，选择前面上传到服务器的离线镜像包。

填写私有镜像仓库地址、用户名和密码。

如未填写私有镜像仓库信息，安装器会默认在部署节点上启动一套私有镜像仓库。

离线安装前再确认两件事：

离线镜像包和产品安装包版本匹配。

/data 空间足够存放镜像包和临时解压文件。

4.7 填写外部中间件信息

使用外部中间件时，按页面要求填写对应组件的连接信息，包括：

地址。

端口。

账号。

密码。

数据库名或 Bucket 等资源名。

填写完成后点击 CONTINUE。

4.8 检查配置并开始安装

配置完成后点击 INITIALIZE DEPLOYMENT。

在配置预览页检查域名、节点、网段、数据目录、中间件选择。

点击 CONTINUE，等待安装器检查服务器环境。

所有检查项通过后，再点击 CONTINUE。

查看安装计划，确认无误后点击 BEGIN DEPLOYMENT。

安装过程中可以点开组件查看日志。安装期间保持安装器进程运行。

4.9 安装完成

看到以下结果表示安装完成：

所有组件显示绿色对勾。

页面打印 All tasks completed successfully。

安装完成后访问 Demo 页：

http://<访问域名>/sdk/demo

5. 安装后验收

5.1 检查 K8s 状态

在服务器上执行：

节点状态应为 Ready。

继续检查服务：

正常状态：

Running：服务正在运行。

Completed：任务执行完成。

如果出现 CrashLoopBackOff、ImagePullBackOff、Error、Pending，先查看日志并处理对应组件。

5.2 停止安装器

安装完成并验收通过后，可以停止安装器进程：

5.3 检查管理后台和 License

确认：

管理后台可以访问。

管理员可以登录。

License 页面可以打开。

机器信息可以查看。

可以在管理后台申请或更新 License 授权。

License 更新按《License 更新指南》执行。

5.4 检查 Demo 页和业务功能

访问文档中台 Demo 页：

http://<访问域名>/sdk/demo

在 Demo 页注册测试账号并登录。

至少验证这些功能：

可以创建文档、表格、幻灯片。

文档可以编辑、保存、协作。

文件导入导出正常。

完成接口接入后，可以验证文档创建和编辑链路。

5.5 检查集成能力

如果项目涉及集成，还要验证：

域名和证书正常。

接口调用正常。

创建、打开、编辑、保存链路正常。

6. 安装后保留资料

部署完成后，建议保留：

服务器 IP、域名、访问协议。

产品安装包版本。

离线镜像包版本。

安装配置截图或配置文件。

kubectl get node、kubectl get pod -A 检查结果。

License 授权记录。

Demo 页和接口链路验收结果。

已知问题和待处理事项。

1. 适用场景#

2. 部署前准备#

2.1 先准备这些信息#

2.2 服务器最低要求#

3. 上传安装工具和安装包#

4. 通过 Web 页面安装#

4.1 上传产品安装包#

4.2 配置访问域名和容器网段#

4.3 配置 K8s 节点#

4.4 选择中间件#

4.5 在线安装#

4.6 离线安装#

4.7 填写外部中间件信息#

4.8 检查配置并开始安装#

4.9 安装完成#

5. 安装后验收#

5.1 检查 K8s 状态#

5.2 停止安装器#

5.3 检查管理后台和 License#

5.4 检查 Demo 页和业务功能#

5.5 检查集成能力#

6. 安装后保留资料#

1. 适用场景

2. 部署前准备

2.1 先准备这些信息

2.2 服务器最低要求

3. 上传安装工具和安装包

4. 通过 Web 页面安装

4.1 上传产品安装包

4.2 配置访问域名和容器网段

4.3 配置 K8s 节点

4.4 选择中间件

4.5 在线安装

4.6 离线安装

4.7 填写外部中间件信息

4.8 检查配置并开始安装

4.9 安装完成

5. 安装后验收

5.1 检查 K8s 状态

5.2 停止安装器

5.3 检查管理后台和 License

5.4 检查 Demo 页和业务功能

5.5 检查集成能力

6. 安装后保留资料