OpsAny社区版v2.3.4升级指南（当前版本）

所有起始版本低于v2.3.0版本的用户必须先升级升级到v2.3.0，然后才能升级到最新版本v2.3.4。因为自2.3.0版本开始，数据库从MySQL 5.x升级到了MySQL 8.x，导致不兼容旧版本。

为了保证国内用户顺利通过安全等保要求，OpsAny v2.3.4在v2.3.0的基础上，再次升级MySQL和Redis（注意MySQL不能直接从5.x升级到8.4）

• MySQL升级到8.4.10，EOL日期：2032年4月30日
• Redis升级到7.2.14，EOL日期：2029年12月1日
• OpenResty升级1.31.1.1，对应Nginx Core为1.31.1。

1.备份并升级MySQL和Redis

Tip

升级前请做好备份，如果是虚拟机或者云主机，建议提前做一个主机快照，用于回退。 必须严格按本文档顺序执行，先更新PaaS代码，再执行其它更新操作，否则有可能造成更新失败。

1.备份数据并发布升级公告

• 1.1 备份数据库

执行数据库备份脚本，会将MySQL和MongoDB备份到/opt目录下。如果是云主机，建议创建云主机快照。

cd /opt/opsany-paas/install
./database-backup.sh all

• 1.2 发布更新通知

在企业相关通知渠道，发布更新通知，更新时间约为5～30分钟（根据下载镜像的网络情况而定），更新内容在本文档末尾。

• 1.3 升级MySQL数据库

OpsAny v2.3.4版本MySQL需要升级到MySQL8.4.10，MySQL 8.0到8.4的升级，直接替换镜像即可，启动后会自动完成升级，主要是需要修改配置文件，去掉不支持的配置项。如果你之前调优过数据库参数，请升级后重新修改配置文件。

- 更新PaaS代码

```
# 备份老的paas代码
mv /opt/opsany-paas /tmp/opsany-paas-v2.3.3

# 下载新的paas代码
wget -O /opt/opsany-paas-v2.3.4.tar.gz https://gitee.com/unixhot/opsany-paas/archive/refs/tags/v2.3.4.tar.gz
cd /opt/
tar zxf /opt/opsany-paas-v2.3.4.tar.gz
mv /opt/opsany-paas-v2.3.4 /opt/opsany-paas

# 复制配置文件到新的paas代码中
cp /tmp/opsany-paas-v2.3.3/install/install.config /opt/opsany-paas/install/
```

- 升级基础服务
```
cd /opt/opsany-paas/install
./opsany-ce-update.sh mysql 8.4.10
./opsany-ce-update.sh redis 7.2.14-alpine
./opsany-ce-update.sh openresty 1.31.1.1-alpine
./opsany-ce-update.sh guacd 1.5.0
```

2.更新OpsAny社区版

• 请注意，执行更新操作是会读取install.config配置文件，请确保配置文件正确，如更换过域名后需要修改，否则可能系统因为配置问题导致不可用。
• 请注意，更新操作需要admin用户的密码，如修改过，请将密码更新至"${INSTALL_PATH}/conf/.passwd_env中"。如果密码中有特殊符号，请使用单引号引起来。
• 备注：更新的原理是删除已经存在的旧容器，然后使用install.config中的配置，重新生成配置文件，并且使用新版本镜像启动新的容器。

Docker容器部署升级

提示：Docker部署的OpsAny升级是重建容器，所以如果用户手工放入某容器中的文件将被删除，平台管理的文件不受影响。

• 2.1 更新PaaS平台服务

# 使用升级脚本升级PaaS服务
cd /opt/opsany-paas/install
./opsany-ce-update.sh paas 4.0.4
./opsany-ce-update.sh login 4.0.4
./opsany-ce-update.sh esb 4.0.4
./opsany-ce-update.sh appengine 4.0.4
./opsany-ce-update.sh websocket 4.0.4
./opsany-ce-update.sh proxy 2.3.4

• 2.2 更新运维平台SaaS模块

./opsany-ce-update.sh ops 2.3.4

• 2.3 更新研发平台SaaS模块(可选)

请注意，如果之前部署过OpsAny数字化研发平台，可以执行更新，没有部署过，执行更新会报错。

./opsany-ce-update.sh dev 2.3.4

• 2.4 更新内置文档

  cd ${INSTALL_PATH}/uploads/ 
  mv docs /tmp/docs-v2.3.3-backup
  wget https://opsany.oss-cn-beijing.aliyuncs.com/opsany-docs-v2.3.4.tar.gz
  tar zxf opsany-docs-v2.3.4.tar.gz
  

Kubernetes部署升级

提示：Kubernetes部署的OpsAny升级，升级后请注意检查Pod的运行状态。

• 2.1 更新PaaS平台服务

cd /opt/opsany-paas/install
./opsany-ce-k8s-update.sh paas 4.0.4
./opsany-ce-k8s-update.sh login 4.0.4
./opsany-ce-k8s-update.sh esb 4.0.4
./opsany-ce-k8s-update.sh appengine 4.0.4
./opsany-ce-k8s-update.sh websocket 4.0.4

• 2.2 更新SaaS运维平台和研发平台

./opsany-ce-k8s-update.sh all 2.3.4

• 2.3 更新Proxy，在Proxy主机上执行。

cd /opt/opsany-paas/install
./proxy-update.sh proxy 2.3.4

3.OpenClaw集成OpsAny

OpsAny支持集成到OpenClaw中，通过自然语言对话，完成日常运维工作。v2.3.2版本更新时，新增了opsany-mcp-server容器的部署。

1.获取opsany-mcp-server配置JSON

# cat /data/opsany/conf/opsany-paas/mcp-server/mcp.json
{
    "mcpServers": {
      "opsany-mcp-server": {
        "url": "http://119.3.172.93:8020/sse",
        "headers": {
          "username": "admin",
          "user-api-token": "Please modify here",
          "mcp-auth-token": "3e24accb-3cfd-4850-8e18-115ca60cb0a3"
          }
      }
    }
}

2.修改MCP的配置JSON

• username：修改为你想使用OpsAny的用户，默认是admin，请注意权限最小化。
• user-api-token: 在【工作台】-【个人设置】-【API Token】页面进行创建。
• mcp-auth-token: 和MCP服务配置文件相同"/data/opsany/conf/opsany-paas/mcp-server/config.yaml"，安装时会设置好，不需要修改。

3.集成到OpenClaw（其它类似工具均可）

修改MCP配置JSON中的相关字段后，直接粘贴到OpenClaw的聊天框中，附上以下提示词：

“请帮我添加这个opsany-mcp-server，并根据这个MCP Server的功能，帮我创建一个完整的Skill，可以调用该MCP Server完成对OpsAny数字化运维平台的交互，从而实现智能化运维。”

4.使用OpenClaw调用OpsAny

案例：

• 请帮我查询一下OpsAny我有多少主机资源。
• 请帮我查询OpsAny待处理的工单。

v2.3.4 版本更新记录

重要提示

OpsAny v2.3.4对统一权限进行了安全调整，仅允许admin用户访问，其它管理员角色不可以访问统一权限。

功能新增

• 资源平台：优化概览数据展示，增加自定义概览面板相关功能。
• 资源平台：资源实例中复合数据增加批量导入和导出模板等相关功能。
• 资源平台：资源模型增加公共字段相关功能，资源模型属性添加字段时可选择从公共字段添加，可选择复制或引用两种使用方式。
• 管控平台：优化概览数据展示，增加自定义概览面板相关功能。
• 管控平台：主机、网络设备增加批量更换监控大屏功能。
• 管控平台：主机管理增加批量修改用户名密码功能。
• 作业平台：优化概览数据展示，增加自定义概览面板相关功能。
• 统一权限：控制访问限制，暂时支持管理员admin可以访问统一权限，其他用户不能访问。
• 堡垒机：主机资源、数据库资源、网络设备资源增加批量修改资源凭证功能。
• MCP：新增创建CMDB模型、创建CMDB模型属性、在脚本仓库创建脚本、查询应用监控告警、查询事件中心告警、读取知识库和知识库文章。

缺陷修复和功能优化

• 堡垒机：优化在线会话、会话审计从主机、数据库、网络设备三种资源维度展示。
• 应用平台：应用内-主机监控页面优化数据展示效果。
• 已对社区版用户提出来的问题进行全方位的优化和修复。

---