OpsAny社区版v1.6.6升级指南

• 如果您是老用户，请根据下面步骤升级，如果您是新用户请根据【安装部署】-【基础平台安装】文档全新安装。
• 其它版本均需要按版本顺序升级到1.6.0之后，再升级到该版本，支持从1.6.0直接升级到1.6.6。
• 独立的流水线、持续部署平台已经合并到应用平台，请在【开发中心】-【内置应用】手工进行下架操作，然后在【工作台】-【导航管理】中删除对应导航。

升级步骤

必须严格按顺序执行，先更新PaaS代码，再执行更新操作，因为更新脚本都是在PaaS这个项目上。

1.更新opsany-paas

1.1更新PaaS代码

cd /opt/opsany-paas && git pull

如果本地修过脚本中的密码，可以执行git checkout filename，更新完毕之后再修改。

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

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

1.3更新内置官方文档。

cd /opt/opsany/uploads/
mv docs /tmp
wget https://opsany-saas.oss-cn-beijing.aliyuncs.com/opsany-docs-ce-1.6.6.tar.gz
tar zxf opsany-docs-ce-1.6.6.tar.gz

1.4更新Agent软件包。

cd /opt/opsany/uploads/
mv agent /tmp
wget https://opsany-saas.oss-cn-beijing.aliyuncs.com/opsany-agent-1.6.0.tar.gz
tar zxf opsany-agent-1.6.0.tar.gz

1.4重新下载SaaS软件包，请查收更新通知邮件，或者在社区微信群获取。

请修改或确认saas-update.sh中的ADMIN_PASSWORD是否是admin正确的密码后执行升级操作。请重新下载最新的saas包并解压后继续。

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

# 如果安装了监控平台可以执行更新，没有安装请不要执行。
./saas-update.sh monitor

# 如果安装了应用平台可以执行更新，没有安装请不要执行。
./saas-update.sh devops

注意：需要先确保新的包已经下载，解压完毕。OpsAny推崇熟人社交，拒绝陌生人，我们坚信技术人就应该相互学习，彼此协作。所以最新消息以社区微信群为第一通知渠道。没有找到社区群入口？在官网下载申请后，收到的邮件中有二维码哦，也或许是因为缘分还未到，把问题留给时间。

2.更新OpsAny Proxy

Proxy更新可以直接进行容器的替换操作后，执行数据库变更即可。

2.1替换Proxy镜像

请根据更新文档，确定Proxy的最新镜像版本，停止并删除老版本容器，使用新镜像启动容器即可。

cd /opt/opsany-paas/install
grep '^[A-Z]' install.config > install.env
source ./install.env && rm -f install.env
docker stop opsany-proxy && docker rm opsany-proxy

2.2启动最新版本Proxy

#请将对应的Docker版本进行修改即可。
docker run --restart=always --name opsany-proxy -d \
        -p 4505:4505 -p 4506:4506 -p 8010:8010 \
        -v ${INSTALL_PATH}/logs:${INSTALL_PATH}/logs \
        -v ${INSTALL_PATH}/proxy-volume/certs/:/etc/pki/tls/certs/ \
        -v ${INSTALL_PATH}/proxy-volume/etc/salt/:/etc/salt/ \
        -v ${INSTALL_PATH}/proxy-volume/cache/:/var/cache/salt/ \
        -v ${INSTALL_PATH}/proxy-volume/srv/salt:/srv/salt/ \
        -v ${INSTALL_PATH}/proxy-volume/srv/pillar:/srv/pillar/ \
        -v ${INSTALL_PATH}/proxy-volume/srv/playbook:/srv/playbook/ \
        -v ${INSTALL_PATH}/uploads:/opt/opsany/uploads \
        -v ${INSTALL_PATH}/conf/proxy/settings_production.py.proxy:/opt/opsany-proxy/config/prod.py \
        -v ${INSTALL_PATH}/conf/proxy/invscript_proxy.py:/opt/opsany-proxy/invscript_proxy.py \
        -v ${INSTALL_PATH}/proxy-volume/pki:/opt/opsany/pki \
        -v /etc/localtime:/etc/localtime:ro \
        ${PAAS_DOCKER_REG}/opsany-proxy:1.2.19

2.3手工更新Proxy数据库

• 警告可以忽略

docker exec -e OPS_ANY_ENV=production \
        opsany-proxy /bin/sh -c "/usr/local/bin/python3 /opt/opsany-proxy/manage.py makemigrations && /usr/local/bin/python3 /opt/opsany-proxy/manage.py migrate"

3.更新Login服务

• Login服务更新是为了支持登录时选择不同的语言。

3.1替换login镜像

请根据更新文档，确定login的最新镜像版本，停止并删除老版本容器，使用新镜像启动容器即可。

cd /opt/opsany-paas/install
grep '^[A-Z]' install.config > install.env
source ./install.env && rm -f install.env
docker stop opsany-paas-login && docker rm opsany-paas-login

3.2启动最新版本login容器

docker run -d --restart=always --name opsany-paas-login \
    -p 8003:8003 -v ${INSTALL_PATH}/logs:/opt/opsany/logs \
    -v ${INSTALL_PATH}/conf/settings_production.py.login:/opt/opsany/paas/login/conf/settings_production.py \
    -v /etc/localtime:/etc/localtime:ro \
    ${PAAS_DOCKER_REG}/opsany-paas-login:v3.2.19

4.更新PaaS服务

4.1替换PaaS镜像

请根据更新文档，确定paas的最新镜像版本，停止并删除老版本容器，使用新镜像启动容器即可。

cd /opt/opsany-paas/install
grep '^[A-Z]' install.config > install.env
source ./install.env && rm -f install.env
docker stop opsany-paas-paas && docker rm opsany-paas-paas

4.2启动最新版本paas容器

docker run -d --restart=always --name opsany-paas-paas \
    -p 8001:8001 -v ${INSTALL_PATH}/logs:/opt/opsany/logs \
    -v ${INSTALL_PATH}/conf/settings_production.py.paas:/opt/opsany/paas/paas/conf/settings_production.py \
    -v /etc/localtime:/etc/localtime:ro \
    ${PAAS_DOCKER_REG}/opsany-paas-paas:v3.2.7

5.更新Websocket容器

5.1停止旧版本Websocket容器并删除。

cd /opt/opsany-paas/install/
grep '^[A-Z]' install.config > install.env
source ./install.env && rm -f install.env
docker stop opsany-paas-websocket && docker rm -f opsany-paas-websocket
#根据实际情况，删除对应的镜像，请修改为正确的镜像地址和版本
docker rmi ${PAAS_DOCKER_REG}/opsany-paas-websocket:v3.2.13

5.2使用新镜像启动websocket服务

docker run -d --restart=always --name opsany-paas-websocket \
    -p 8004:8004 -v ${INSTALL_PATH}/logs:/opt/opsany/logs \
    -v ${INSTALL_PATH}/uploads:/opt/opsany/uploads \
    -v ${INSTALL_PATH}/conf/settings_production.py.websocket:/opt/opsany/websocket/config/prod.py \
    -v ${INSTALL_PATH}/conf/settings_production.py.websocket.init:/opt/opsany/websocket/config/__init__.py \
    -v /usr/share/zoneinfo:/usr/share/zoneinfo \
    -v /etc/localtime:/etc/localtime:ro \
    ${PAAS_DOCKER_REG}/opsany-paas-websocket:v3.2.15

v1.6.6 版本更新记录

功能下线：

1. 管控平台：正式下线主机授权页面。功能由【资源平台】资源授权页面承担；

功能新增：

1. 全平台：平台增加主题换色功能；
2. 全平台：增加多语言英文和繁体等功能（仅完成部分平台的多语言）；
3. 全平台：全平台性能优化；
4. 堡垒机：导入用户支持区分本地用户和其他例如LDAP用户等；
5. 管控平台：IP地址管理增加概览视图，增加StackStorm集成；
6. Agent: 新增Debian系统的Agent模式支持。

缺陷修复和功能优化：

1. 工作台：工单相关功能修复与优化完善；
2. 资源平台：解决资源仓库字段分组排序的问题；
3. 作业平台：完善作业平台日志不全等问题；
4. 云管平台：修复腾讯云网络同步异常；
5. 管控平台：Agent纳管和连接测试时增加重试机制，缓解因为性能问题导致的Agent异常几率的出现。

---