集群高可用部署【k8s】

1. 适用场景

K8s 集群部署适合正式环境。相比单机部署，集群部署更适合长期运行、扩容和高可用场景。

生产环境建议使用 3 master + N worker。

最低也应准备 3 台服务器，3 台都作为 master，worker 可先复用 master 节点，后续再按规模增加 worker。

2. 部署前准备

2.1 先准备这些信息

信息	示例	说明
网络环境	在线 / 离线	支持公网访问选在线；内网或离线环境选离线
安装节点 IP	`<安装节点IP>`	选择 1 台作为安装节点，用来启动 Web 页面
业务节点 IP	`<节点1IP>`、`<节点2IP>`、`<节点3IP>`	至少 3 台服务器
执行用户	`root`	安装命令使用 `root` 执行
访问协议	HTTP / HTTPS	正式环境建议 HTTPS
访问域名	`<访问域名>`	用户访问石墨办公套件的地址
数据目录	`/data`	所有节点建议保持一致
安装工具	`mdp-installer-${Arch}`	石墨提供的安装器， ${Arch} 区分不同芯片架构，其值可以是 amd64 表示x86架构或 arm64 表示arm架构
产品安装包	石墨办公套件安装包	以实际交付文件名为准
离线镜像包	`*.tar.gz`	仅离线安装需要
外部中间件	有 / 无	有外部中间件时，提前准备地址、端口、账号、密码

2.2 服务器最低要求

项目	要求
服务器数量	3 台及以上
推荐角色	`3 master + N worker`
每节点 CPU	16 Core 以上
每节点内存	32 GB 以上
系统盘	根 `/` 分区 100 GB 以上
数据盘	独立挂载 `/data`，可用空间 300 GB 以上
离线安装	安装节点数据盘建议额外预留 100 GB 以上

注意：

不要把 /root、/var、/tmp 单独分区。

数据不要放在系统盘，统一放到 /data。

所有节点的时间必须同步。

安装节点需要能通过 SSH 访问其他节点。

可在每台服务器上执行：

在安装节点上确认能访问其他节点：

如登录未通过，先检查 SSH、密码、防火墙或安全组配置，再继续安装。

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

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

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

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

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

登录安装节点：

给安装器加执行权限：

启动安装器 Web 页面：

浏览器访问：

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

4. 通过 Web 页面安装

4.1 上传产品安装包

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

点击 GET STARTED。

上传石墨办公套件安装包。

上传完成后点击 CONTINUE。

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

填写用户访问石墨办公套件的方式：

配置项	怎么填
协议	正式环境建议 HTTPS
访问域名 / IP	`<访问域名>`
Service CIDR	默认 `10.43.0.0/16`
Pod CIDR	默认 `10.42.0.0/16`

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

4.3 配置 K8s 节点

集群部署要选择多节点模式。

配置项	怎么选
部署模式	`Multi Node Mode`
节点 IP	逐个填写 master / worker 节点 IP
SSH 端口	通常为 `22`
SSH 密码	`root` 用户密码
节点类型	按规划选择 `master` 或 `worker`
namespace	按项目约定填写；没有约定可使用默认值
数据目录	`/data`

最低 3 台服务器都要添加为 master。如果当前没有独立 worker，可以让这 3 台同时承担 worker 角色。

操作步骤：

选择 Multi Node Mode。

点击 ADD NODE 添加节点。

依次填写每台服务器的 IP、端口和 SSH 密码。

为每台服务器选择节点类型。

填写 namespace、containerd 数据目录和应用数据目录。

4.4 选择中间件

如果没有外部中间件，保持默认勾选，由安装器部署内置组件。

可选择的组件包括：

MySQL

Redis

MongoDB

MinIO

Kafka

Elasticsearch

ClickHouse

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

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，表示安装完成。

安装完成后访问：

http://<访问域名>/

5. 安装后验收

5.1 检查 K8s 状态

在安装节点上执行：

所有节点状态都应为 Ready。

继续检查服务：

正常状态：

Running：服务正在运行。

Completed：任务执行完成。

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

5.2 停止安装器

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

5.3 检查管理后台和 License

确认：

管理后台可以访问。

管理员可以登录。

License 页面可以打开。

机器信息可以查看。

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

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

5.4 检查业务功能

访问石墨办公套件登录页：

http://<访问域名>/

使用默认测试账号登录：

账号：test@shimo.im
密码：Aa1234567.

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

至少验证这些功能：

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

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

文件导入导出正常。

搜索、团队空间、通讯录可用。

5.5 检查集成能力

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

域名和证书正常。

LDAP / CAS / OAuth2 登录可用。

组织架构同步可用。

6. 安装后保留资料

部署完成后，建议保留：

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

节点角色规划。

产品安装包版本。

离线镜像包版本。

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

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

License 授权记录。

业务功能验收结果。

已知问题和待处理事项。

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 检查业务功能#

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 检查业务功能

5.5 检查集成能力

6. 安装后保留资料