OpsAny社区版v2.3.1升级指南

OpsAny v2.0.0开始支持跨版本升级，所有起始版本低于v2.3.0，版本的用户必须先升级升级到v2.3.0，然后才能升级到最新版本v2.3.1。因为自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.0

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

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

如果本地修过相关文件，执行会失败，可以执行git checkout -- filename 逐个丢弃工作区的修改，待更新完毕之后再修改。

• 2.2 更新PaaS平台服务

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

• 2.3 更新运维平台SaaS模块

./opsany-ce-update.sh ops 2.3.1

• 2.4 更新Agent和内置文档

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

mv agent /tmp/agent-2015-backup
wget https://opsany.oss-cn-beijing.aliyuncs.com/opsany-agent-v2.3.1.tar.gz
tar zxf opsany-agent-v2.3.1.tar.gz

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

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

./opsany-ce-update.sh dev 2.3.1

Kubernetes部署升级

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

• 2.1 更新PaaS平台服务

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

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

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

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

cd /opt/opsany-paas/install
./proxy-update.sh proxy 2.3.1
cd ${INSTALL_PATH}/uploads/
mv agent /tmp/agent-2015-backup
wget https://opsany.oss-cn-beijing.aliyuncs.com/opsany-agent-v2.3.1.tar.gz
tar zxf opsany-agent-v2.3.1.tar.gz

• 2.4 更新Agent和内置文档，在NFS主机上执行。

cd /data/k8s-nfs/opsany-uploads/ 
mv docs /tmp/docs-2015-backup
wget https://opsany.oss-cn-beijing.aliyuncs.com/opsany-docs-v2.3.1.tar.gz
tar zxf opsany-docs-v2.3.1.tar.gz

v2.3.1 版本更新记录

功能新增

• 工作台：工单审批待办增加推送到钉钉待办的订阅设置。
• 工作台：工单系统组织架构增加第三方组织架构选择。
• 工作台：工单管理-导出功能增加是否根据工单流程导出的选项。
• 工作台：工单详情-工单进度预览增加查看已处理节点的详情页。
• 工作台：工单管理-我提交的工单中增加克隆功能。
• 工作台：工单审批节点新增审批类型驳回到提单。
• 云管平台：自定义概览增加私有云数据卡片。
• 云管平台：私有云厂商对外增加Proxmox厂商。
• 资源平台：资源仓库实例支持导出复合数据展示。
• 资源平台：物理视图-在机柜详情内增加切换不同机房的机柜展示，以及支持上一页和下一页方式获取机柜数据展示等。
• 管控平台：IP地址管理增加停止扫描操作，防止多次扫描误操作。
• 基础监控：告警事件中增加Zabbix各种更新操作，如更改严重性、抑制告警、确认告警等。
• 重构登录页逻辑，优化登录页展示效果。
• 统一权限：认证管理中增加自定义配置登录页默认登录方式功能。
• 统一权限：全局配置-安全配置中增加密码安全配置，如密码长度配置、密码不要包含用户名配置、验证码展示策略配置、密码重试次数配置等功能。
• 登录页增加密码重试次数提醒和验证码策略提醒。

缺陷修复和功能优化

• 工作台：优化工单开启SLA管理提单刷新慢的问题。
• 工作台：重构工单选择组织架构展示效果。
• 工作台：工单管理导出功能优化特殊字段导出展示问题。
• 作业平台：修复定时作业ESB异常问题。
• 管控平台：修复IP地址扫描异常问题。
• 管控平台：采控管理-Zabbix集成-同步网络设备问题已优化。
• 管控平台：添加网络设备配置SNMP信息V3完善多种类型适配。
• 资源平台：资源模型-优化从属关系创建多个问题。
• 大模型开发：优化大模型开发平台功能和性能。
• 全平台菜单接口重构，优化访问效率。
• 已对社区版用户提出来的问题进行全方位的优化和修复。
• 调整所有SaaS平台的uwsgi配置文件，进行性能优化。
• 调整所有SaaS平台请求ESB和Login的方式，修改为通过内网IP和端口的形式访问。
• 调整所有SaaS平台的ESB组件，采用ESB中配置的PAAS_DOMAIN进行访问。