OpsAny社区版v2.2.4升级指南

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.3
./opsany-ce-update.sh login 3.3.2
./opsany-ce-update.sh esb 3.3.3
./opsany-ce-update.sh appengine 3.3.0
./opsany-ce-update.sh websocket 3.3.3

• 2.2 更新SaaS基础模块

./opsany-ce-update.sh proxy 2.2.4
./opsany-ce-update.sh ops 2.2.4

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

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

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

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

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

功能新增

• 工作台：概览-自定义面板新增应用平台、流水线、APM平台等卡片内容。
• 工作台：服务目录改为服务门户-页面交互展示效果优化，增加收藏功能和最近提单过滤功能。
• 工作台：迁移大屏展示页面，从原来的基础监控平台迁移到工作台展示。
• 统一权限：权限策略-新建授权策略时增加平台一键全选授权按钮权限功能。
• 流水线：新建流水线-流程配置中增加人工确认功能。
• 工作台：系统设置-历史数据清理页面增加应用监控告警通知历史数据保留策略功能。

缺陷修复和功能优化

• 工作台：工单详情-操作日志详情展示优化。
• 工作台：工单详情-正在进行中的工单API调用节点状态刷新问题已从手动刷新优化为自动刷新。
• 工作台：提工单时多行文本和富文本自动转义问题已优化。
• 管控平台：采控管理-Zabbix集成编辑时点击连接测试报错问题已优化。
• 资源平台：主机视图-孤岛数据搜索不好用的问题已优化。
• 已对社区版用户提出来的问题进行全方位的优化和修复；

---