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

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

1.升级前备份

Tip

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

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

• 1.1 备份数据库

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

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

• 1.2 发布更新通知

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

2.更新OpsAny社区版

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

Docker容器部署升级

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

• 2.1 更新PaaS代码

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

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

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

• 2.2 更新PaaS平台服务

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

• 2.3 更新运维平台SaaS模块

./opsany-ce-update.sh ops 2.3.3

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

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

./opsany-ce-update.sh dev 2.3.3

Kubernetes部署升级

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

• 2.1 更新PaaS平台服务

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

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

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

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

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

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.3 版本更新记录

功能新增

• 工作台：新增工单统计页面。
• 工作台：概览页面增加企业版应用监控概览数据面板。
• 管控平台：纳管主机、网络设备时同步堡垒机增加选择使用已存在的凭证选项。
• 管控平台：网络设备支持批量添加备份策略和备份任务等功能。
• 作业平台：定时作业-增加定时作业详情页面，展示计划执行作业和已执行作业历史等数据。
• 资源平台：资源模型页面增加模型分组拖拽排序功能。
• 基础监控：告警事件页面增加告警转工单功能。
• 统一权限：认证管理页面增加删除强提醒功能。
• MCP：新增工单提交、资源纳管、资源增删改，资源的从属关系和关联关系管理。

缺陷修复和功能优化

• 工作台：全面优化工单系统选择组织架构加载慢的问题。
• 作业平台：优化定时作业执行逻辑，不再要求作业必须执行过。
• 已对社区版用户提出来的问题进行全方位的优化和修复。