中间件配置

1. 功能概述

中间件配置是 MDP 运维平台中对接客户环境中各类存储与中间件的页面，集中管理 S3 对象存储、Redis、消息队列 Kafka、关系型数据库 MySQL、文档数据库 MongoDB、全文检索 Elasticsearch 等组件的连接信息。配置变更会通过异步任务下发到客户环境，并在变更过程中实时显示测试与发布进度。

主要能力：

配置各中间件的连接信息（Endpoint、Access Key、用户名密码等）

切换不同供应商（S3 与 OSS、AWS / MinIO / 腾讯云 COS / 华为云 OBS、MySQL 与 DM 达梦）

表单脏值跟踪，仅修改字段会被提交

每段配置可单独测试连接，验证通过后才允许发布

一键发布：批量提交所有脏字段配置，异步执行

1.1 适用对象

角色	常用操作
实施工程师	初次部署时填写中间件连接信息
运维值班	凭据更换、Endpoint 变更、测试连接
故障应急	切换备份中间件、修改超时配置

1.2 不建议在本模块执行的操作

切换供应商（如 S3 → OSS）属于涉及大量下游数据迁移的变更，请按变更流程处理。跨多个环境批量调整连接信息也不在本模块范围内，需要逐个环境进入该页面配置。中间件的容量规划与监控告警不在本页面，请使用集群管理与告警配置模块。

2. 各中间件配置详解

2.1 S3 对象存储

操作步骤：左侧菜单进入「中间件配置」默认即在此段 → 向下滚动依次看到公共 S3 实例设置、协同编辑 S3 实例设置、Bucket 设置三个配置段。

2.1.1 公共 S3 与协同编辑 S3

操作步骤：先填公共 S3 实例设置，再填协同编辑 S3 实例设置，最后填 Bucket 设置。任一字段修改后点击底部「测试连接」。
两段表单字段一致：

字段	说明	是否必填
存储类型	下拉选择「S3 (对象存储)」或「OSS (阿里云)」	是
子类型	根据存储类型动态加载：S3 时可选 AWS / 腾讯云 COS / 华为云 OBS / MinIO / 其他，OSS 时仅可选阿里云 OSS	是
Access Key ID	凭据标识	是
Access Key Secret	凭据密钥，输入框密码遮罩	是
区域	例如 `cn-north-1`	是
ForcePathStyle	复选框，是否启用 path style 访问	否
SSL	复选框，是否启用 HTTPS	否
Endpoint	服务内部访问地址	是
公共访问地址	用户端访问地址	是
地址替换规则	用于把内部地址映射为公共地址的正则或字符串	是

2.1.2 Bucket 设置

操作步骤：服务端返回的所有 Bucket 都会逐个渲染表单，按需填入 CDN 域名等。

字段	说明
Bucket 名称	Bucket 名
前缀	对象存储路径前缀
CDN 域名	CDN 加速域名
启用 CDN 鉴权	复选框，启用后追加「鉴权类型」与「鉴权密钥」两项

启用 CDN 鉴权后，对应鉴权类型与鉴权密钥为必填。

2.2 Redis

操作步骤：右侧快速导航点 Redis 图标滚动到本段 → 选择模式 → 填写地址与密码 → 点击「测试连接」。

字段说明：

字段	说明
模式	Standalone（单机）或 Sentinel（哨兵）
地址	单机模式下连接地址，例如 `redis-sentinel-master-ss:6379`
主节点名称	哨兵模式下必填，例如 `mymaster`
地址列表	哨兵模式下多个地址，可动态新增 / 删除
密码	必填

切换模式会自动重置地址、主节点、地址列表字段。

2.3 Kafka

操作步骤：右侧快速导航点 Kafka 图标滚动到本段 → 填写 Broker 地址 → 如启用 SASL 则展开 SASL 子字段 → 点击「测试连接」。

字段说明：

字段	说明
Broker 地址	数组，可动态新增 / 删除
主题前缀	所有 Topic 自动加此前缀
启用 SASL 认证	开关，启用后追加三项 SASL 配置
认证机制	PLAIN / SCRAM-SHA-256 / SCRAM-SHA-512（启用 SASL 后）
用户名 / 密码	SASL 凭据（启用 SASL 后）

2.4 MySQL（关系型数据库）

操作步骤：右侧快速导航点 RDB 图标滚动到本段 → 选择 MySQL 或 DM 达梦 → 填写主机、端口、用户名密码 → 点击「测试连接」。

字段说明：

字段	说明
数据库类型	MySQL 或 DM (达梦)
主机地址	例如 `mysql-master`
端口	3306
用户名 / 密码	凭据

右侧菜单与页面标题中的「RDB 关系型数据库」即对应 MySQL 配置段。

2.5 MongoDB

操作步骤：右侧快速导航点 MongoDB 图标滚动到本段 → 填写连接字符串 → 各库凭据按服务端配置逐个渲染 → 点击「测试连接」。

字段说明：

字段	说明
连接字符串	例如 `mongo-master:27017`
各数据库用户名 / 密码	服务端已配置的数据库逐个渲染

2.6 Elasticsearch

操作步骤：右侧快速导航点 Elasticsearch 图标滚动到本段 → 填写主机地址 + 端口 → 如启用鉴权则填用户名密码 → 点击「测试连接」。

字段说明：

字段	说明	是否必填
主机地址	例如 `elasticsearch`	是
端口	9200	是
用户名	ES 凭据	否
密码	ES 凭据	否

3. 常见操作

3.1 凭据更新（例：Access Key 轮换）

进入中间件配置

在 S3 公共卡片中替换 Access Key ID 与 Access Key Secret

点击「测试连接」，等待绿色「连接测试成功」提示

其他被修改的段也重复测试连接

点击底部「发布配置」

系统提示已创建异步任务，并跳转任务日志页签

3.2 切换中间件供应商

进入中间件配置

在对应卡片中修改「存储类型 / 子类型」以及新供应商的 Endpoint、Access Key、地址替换规则等

修改完后再点击「测试连接」验证

点击「发布配置」

切换供应商涉及下游服务重新加载连接池，请避开业务高峰；切换后建议观察 5 至 10 分钟应用日志。

3.3 启用 Kafka SASL

进入中间件配置，定位到 Kafka 段

打开「启用 SASL 认证」开关，页面会展开 SASL 字段

填写认证机制、用户名、密码

点击「测试连接」

通过后点击「发布配置」

3.4 误操作恢复

未点击「发布配置」前，表单状态保存在浏览器 localStorage。可通过以下方式恢复：

点击底部「重置全部」，所有字段还原为服务端初始值

3.5 异步任务追踪

发布配置成功后，系统会跳转到任务日志页签显示任务进度。任务可长可短，与中间件数量、变更字段数相关。

4. 常见问题

Q1: 顶部右侧快速导航点了 Redis 后没有反应。

右侧快速导航仅滚动到对应区域。如果该段不在当前页面（如被某个弹窗遮挡），可滚动页面或点击右侧导航的 Redis 图标重新定位。

Q2: 发布配置后，状态似乎没更新。

页面发布后会自动刷新。如果浏览器未自动刷新，可手动按 F5 拉取最新配置。

Q3: 「已修改 N 项配置」的数字与实际不符。

页面基于表单脏值字段计数。某些情况下，例如重置后再修改、动态新增/删除数组项等操作，可能导致计数偏差。可点击「重置全部」后重新填写。

Q4: Bucket 设置卡片找不到我想加的 Bucket。

页面根据服务端配置渲染已有 Bucket。新增 Bucket 需要修改底层服务端配置文件，而非本页面。如确有此需求，请联系实施工程师。

附录 A：术语对照

术语	解释
服务端配置文件	平台维护的最终配置来源，由平台默认值与本页面下发值合并而成
Bucket	S3 / OSS 中的存储桶
Endpoint	中间件服务地址，集群内部访问用
公共访问地址	用户端可见的中间件地址
地址替换规则	把内部地址映射为公共地址的正则或字符串
SASL	简单认证与安全层（Simple Authentication and Security Layer），Kafka 等组件的认证机制
Sentinel	Redis 高可用方案之一
DM	达梦数据库（国产关系型数据库）
脏字段	表单中被修改、与初始值不同的字段

1. 功能概述#

1.1 适用对象#

1.2 不建议在本模块执行的操作#

2. 各中间件配置详解#

2.1 S3 对象存储#

2.1.1 公共 S3 与协同编辑 S3#

2.1.2 Bucket 设置#

2.2 Redis#

2.3 Kafka#

2.4 MySQL（关系型数据库）#

2.5 MongoDB#

2.6 Elasticsearch#

3. 常见操作#

3.1 凭据更新（例：Access Key 轮换）#

3.2 切换中间件供应商#

3.3 启用 Kafka SASL#

3.4 误操作恢复#

3.5 异步任务追踪#

4. 常见问题#

附录 A：术语对照#

1. 功能概述

1.1 适用对象

1.2 不建议在本模块执行的操作

2. 各中间件配置详解

2.1 S3 对象存储

2.1.1 公共 S3 与协同编辑 S3

2.1.2 Bucket 设置

2.2 Redis

2.3 Kafka

2.4 MySQL（关系型数据库）

2.5 MongoDB

2.6 Elasticsearch

3. 常见操作

3.1 凭据更新（例：Access Key 轮换）

3.2 切换中间件供应商

3.3 启用 Kafka SASL

3.4 误操作恢复

3.5 异步任务追踪

4. 常见问题

附录 A：术语对照