OpsAny社区版v2.2.3升级指南

OpsAny v2.0.0开始支持跨版本升级，所有用户必须先升级到2.0.0，才能再跨版本升级到最新版本。截止2024年12月31日至，OpsAny将不在支持v1.x.的所有版本，也不再支持从v1.x版本升级到2.x版本。

升级步骤

Tip

必须严格按本文档顺序执行，先更新PaaS代码，再执行其它更新操作，否则有可能造成更新失败。更新脚本发布前经过严谨测试，请放心执行即可。

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

• 0.1 备份数据库

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

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

备份后MySQL为一个SQL文件。MongoDB为一个目录，案例如下：

ls /opt/*backup*
/opt/opsany_mysql_backup_2024-10-11-09-52.sql

/opt/mongodb-backup-2024-10-11-09-52:
admin  auto  cmdb  cmp  devops  event  job  kbase  monitor  prom  workbench

• 0.2 发布更新通知

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

1.更新OpsAny PaaS平台

• 1.1 更新PaaS代码

cd /opt/opsany-paas && git checkout main && git pull

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

• 1.2 更新ESB。ESB更新会替换配置，并重新导入ESB相关的SQL。

cd /opt/opsany-paas/install
./saas-esb-update.sh

2.更新OpsAny数字化运维平台

• 请注意，执行更新操作是会读取install.config配置文件，请确保配置文件正确，否则可能系统因为配置问题导致不可用。
• 请注意，更新操作需要admin用户的密码，如修改过，请将密码更新至"${INSTALL_PATH}/conf/.passwd_env中"。如果密码中有特殊符号，请使用单引号引起来。

SaaS基础模块包括工作台、统一权限、作业平台、云管平台、资源平台、管控平台、基础监控、堡垒机。

• 2.1 更新PaaS平台服务

cd /opt/opsany-paas/install
./opsany-ce-update.sh paas 3.3.2
./opsany-ce-update.sh login 3.3.2
./opsany-ce-update.sh esb 3.3.0
./opsany-ce-update.sh appengine 3.3.0

• 2.2 更新SaaS基础模块

./opsany-ce-update.sh proxy 2.2.3
./opsany-ce-update.sh websocket 2.2.3
./opsany-ce-update.sh ops 2.2.3

• 2.3 更新Agent和内置文档

source install.config
cd ${INSTALL_PATH}/uploads/ 
mv docs /tmp/docs-2.2.2-backup
wget https://opsany.oss-cn-beijing.aliyuncs.com/opsany-docs-2.2.3.tar.gz
tar zxf opsany-docs-2.2.3.tar.gz

mv agent /tmp/agent-2.2.2-backup
wget https://opsany.oss-cn-beijing.aliyuncs.com/opsany-agent-2.2.3.tar.gz
tar zxf opsany-agent-2.2.3.tar.gz

3.更新OpsAny数字化研发平台（可选）

由于目前OpsAny分为两大产品线【OpsAny数字化运维平台】和【DevAny数字化研发平台】，每次发布版本会同时发布，用户可以根据实际情况进行更新，如未部署请查看部署文档，下面为升级步骤。

如果之前部署过应用平台，请执行。不知道，就是没有部署，请不要执行。

# 更新数字化研发平台
cd /opt/opsany-paas/install
./opsany-ce-update.sh devops 2.2.3
./opsany-ce-update.sh pipeline 2.2.3
./opsany-ce-update.sh deploy 2.2.3
./opsany-ce-update.sh repo 2.2.3

4.跨版本升级专用（可选）

如果你是跨过2.1.3版本，直接升级到当前版本，并且部署了应用平台，请执行下面的更新。2.1.3版本及以后版本升级到当前无需执行。

# 1.增加新平台，OpsAny 2.1.3版本之后，将原本企业版的制品仓库、流水线、持续部署变更为社区版，需要增加部署。

# 需要确认安装uuid命令。
yum install -y uuid

# 安装制品仓库、流水线、持续部署平台。
cd /opt/opsany-paas/install
./saas-ce-install.sh repo
./saas-ce-install.sh pipeline
./saas-ce-install.sh deploy

# 由于可视化平台已经和基础监控合并，可以停止并删除容器。
docker stop opsany-saas-ce-dashboard
docker rm opsany-saas-ce-dashboard

# 2.初始化新平台的菜单和权限信息。
source install.config
source ${INSTALL_PATH}/conf/.passwd_env
python3 ../saas/init-ce-devops.py --domain https://${DOMAIN_NAME} --username admin  --password $ADMIN_PASSWORD

# 3.修改Nginx配置，增加新平台配置。
mkdir ${INSTALL_PATH}/logs/repo
/bin/cp conf/nginx-conf.d/opsany_paas.conf ${INSTALL_PATH}/conf/nginx-conf.d/
sed -i "s/DOMAIN_NAME/${DOMAIN_NAME}/g" ${INSTALL_PATH}/conf/nginx-conf.d/opsany_paas.conf
sed -i "s/LOCAL_IP/${LOCAL_IP}/g" ${INSTALL_PATH}/conf/nginx-conf.d/opsany_paas.conf
docker restart opsany-base-openresty

v2.2.3 版本更新记录

本版本，我们依然在你看不到的地方持续努力着，OpsAny v2.2.3版本在提升整体性能的同时，不停的优化资源使用，4C、8G运行【OpsAny数字化运维平台】是我们的追求也是底线。

功能新增

• 全平台：优化顶部和底部展示效果，
• 统一权限：产品配置-全局配置增加全站顶部导航显示和全站底部版权显示配置功能，可以自定义配置全平台顶部导航是否展示工作台、控制台和消息，以及自定义配置全平台底部版权信息是否展示等。
• 资源平台：重构应用视图页面展示效果。
• 流水线：增加视图管理功能。
• 持续部署：增加视图管理功能。
• 应用平台：应用内-应用交付-流水线和持续部署的展示增加视图管理的功能。
• 管控平台：增加SSH、Telnet连接的自定义超时时间。增加纳管检测和监控检测，取消掉原有的联通测试。
• 堡垒机：增加自定义SSH超时时间。
• 云管平台：增加云标签同步、快照同步等。增加阿里云、腾讯云新建云主机。完善云管平台多语言翻译。
• 工作台：个人设置-密钥管理-创建密钥区分系统生成密钥和手动上传密钥两种创建方式。
• 基础监控：概览页数据统计增加网络设备的相关数据展示效果。

缺陷修复和功能优化

• 基础监控：增加Zabbix 7.0LTS支持，解决主机监控页面磁盘空间不展示问题。
• 管控平台：优化监控插件的状态获取问题。
• 堡垒机：优化访问策略和命令策略关联资源凭证的选择方式等。
• 流水线：优化流水线模板初始化脚本，只更新opsany平台内置的模板，不更新用户创建的内置模板。
• 流水线：优化流水线-流程配置文本编辑框的交互展示效果。
• 持续部署：优化部署模板初始化脚本，只更新opsany平台内置的模板，不更新用户创建的内置模板。
• 资源平台：已优化社区用户提出的云资源同步问题。
• 已对社区版用户提出来的问题进行全方位的优化和修复。

---