版本发布和升级¶

我们遵循国际标准的版本号规范，即 X.Y.Z。其中，大版本 X 一年发布 1-2 次，包含重大的升级（例如，系统整体界面的更改，重大功能的引入等）；小版本 Y 一个季度发布 1-2 次，包含常规的升级（例如，新功能的引入，框架/依赖库的升级等）；补丁版本 Z 不定期发布，主要包含 bugfix 以及一些日常的小更新。

Tip

我们建议您定期更新，以获得最佳和最新的使用体验。

软件升级¶

假设，您遵循了开始使用文档的安装步骤，此时，您下载并解压了最新的安装脚本（1.4.0），

cd /opt/beatsight

.
|-- beatsight-docker-1.3.0-ce
|   |-- README.md
|   |-- backup.sh
|   |-- backups
|   |-- beatsight_install_log-2024-10-26_04-10-18.txt
|   |-- docker-compose.yaml
|   |-- install
|   |-- install.sh
|   |-- logs
|   |-- runtime
|   |-- start.sh
|   `-- stop.sh
|-- beatsight-docker-1.4.0-ce
|   |-- README.md
|   |-- backup.sh
|   |-- backups
|   |-- docker-compose.yaml
|   |-- install
|   |-- install.sh
|   |-- logs
|   |-- runtime
|   |-- upgrades
|   |-- start.sh
|   `-- stop.sh
|-- logs
|   |-- beatsight
|   |-- nginx
|   `-- supervisor
`-- runtime
    |-- beatsight.nginx.conf
    |-- beatsight_settings.py
    `-- gunicorn.conf.py

进入新的安装脚本目录执行升级脚本：

cd beatsight-docker-1.4.0-ce
./upgrades/v1.3_1.4.sh

该脚本会先停止当前服务，请确保您在合适的时间里执行。

Tip

补丁版本的升级（例如，v1.3.0 -> v1.3.1）不需要执行升级脚本。

升级完成后，安装新版本，启动服务即可。

./install.sh
./start.sh

跨版本升级¶

假设您是从 1.2 版本直接升级到 1.4.5 版本，需要依此执行多个升级脚本：

cd beatsight-docker-1.4.5-ce
./upgrades/v1.2_1.3.sh
./upgrades/v1.3_1.4.sh

软件降级¶

如果新版本存在bug或其他原因导致无法正常使用，您也可以退回到之前版本，操作如下：

cd beatsight-docker-1.3.0-ce
./install.sh

旧版安装完成后，重新启动服务即可。