升级悦数图管理¶

本文介绍如何将悦数图管理升级到新版本。请使用与当前安装方式相同的方式升级，并先备份配置和数据。v5.3.2 的安装包位于 GitHub Releases。

Caution

新版本可能升级数据库结构。请确认备份可用后再升级；只换回旧版本程序，不一定能恢复数据库。

Docker Compose¶

备份部署目录中的studio-compose.yaml和 Docker 数据卷studio-data。如果挂载了config-release.yaml，也请备份该文件。使用 MySQL 时，还需单独备份 MySQL 数据库。
在 Docker Hub 镜像页面确认目标版本的标签，将studio-compose.yaml中studio服务的image改为vesoft/nebula-studio:<版本号>。将<版本号>替换为目标版本，例如5.3.2。

在部署目录运行：

docker compose -f studio-compose.yaml pull studio
docker compose -f studio-compose.yaml up -d
docker compose -f studio-compose.yaml ps

进入旧版本的安装目录，停止服务：

sudo ./scripts/studio.service stop all
sudo ./scripts/studio.service status all

备份旧安装目录。使用 SQLite 时，请同时备份data/studio.db及同目录下的studio.db-wal、studio.db-shm文件（如有）；使用 MySQL 时，单独备份数据库。
从目标版本的发布页下载与操作系统和架构对应的 TAR 包，解压到一个新目录，不要覆盖旧目录。
对照新旧版本的etc/config.yaml，将自定义配置写入新文件。使用 SQLite 时，将备份的数据库文件复制到新安装目录中的对应位置。

进入新安装目录，启动服务并检查状态：

sudo ./scripts/studio.service start all
sudo ./scripts/studio.service status all

确认页面和数据正常后，再清理旧安装目录。

停止服务。备份/etc/nebula-studio/config.yaml；如果使用了/etc/nebula-studio/studio.env，也备份该文件。默认使用 SQLite 时，备份/var/lib/nebula-studio目录，确保包含studio.db及可能存在的studio.db-wal、studio.db-shm；使用 MySQL 时，单独备份 MySQL 数据库。
```
sudo systemctl stop nebula-studio.service
```
从目标版本的发布页下载与操作系统和架构对应的包。RPM 包运行sudo rpm -Uvh <下载的RPM文件>；DEB 包运行sudo dpkg -i <下载的DEB文件>。

检查/etc/nebula-studio/config.yaml中的自定义配置，启动服务并检查状态：

sudo systemctl start nebula-studio.service
sudo systemctl status nebula-studio.service