跳到主要内容

升级

升级分两类：Dash 升级和节点升级。

Dash 升级​

Linux 发布包安装的 Dash 使用：

sudo bash /opt/Ithiltir-dash/update_dash_linux.sh --check
sudo bash /opt/Ithiltir-dash/update_dash_linux.sh -y --lang zh

默认更新目标是最新普通发布。预发布使用 --test：

sudo bash /opt/Ithiltir-dash/update_dash_linux.sh --check --test
sudo bash /opt/Ithiltir-dash/update_dash_linux.sh -y --test --lang zh

更新脚本会：

  1. 检查当前版本和发布通道。
  2. 从 GitHub Release 下载新包。
  3. 停止 dash.service。
  4. 备份 /opt/Ithiltir-dash 到临时目录。
  5. 覆盖安装文件。
  6. 收紧敏感文件权限。
  7. 执行数据库迁移。
  8. 启动 dash.service。

--check 检查当前选择的目标通道。默认通道只查普通发布；--test 只查预发布。当前已安装版本是高于最新普通发布的预发布时，默认更新会停止并提示使用 --test。

如果迁移失败，脚本会尝试恢复安装目录并重启旧服务。数据库迁移已经提交的部分不会自动反向回滚，因此升级前必须做数据库备份。

手工升级 Dash​

systemctl stop dash.service
cp -a /opt/Ithiltir-dash /opt/Ithiltir-dash.bak.$(date +%Y%m%d%H%M%S)
tar -xzf Ithiltir_dash_linux_amd64.tar.gz
cp -a Ithiltir-dash/. /opt/Ithiltir-dash/
env DASH_HOME=/opt/Ithiltir-dash /opt/Ithiltir-dash/bin/dash migrate -config /opt/Ithiltir-dash/configs/config.local.yaml
systemctl start dash.service

手工升级前备份数据库：

pg_dump -Fc -d <db_name> -f ithiltir-$(date +%Y%m%d%H%M%S).dump

节点升级​

Dash 发布包携带节点资产。管理台触发节点升级时：

  1. Dash 根据节点最后上报的平台选择对应资产。
  2. POST /api/admin/nodes/{id}/upgrade 写入易失升级任务。
  3. 节点下一次 POST /api/node/metrics 响应拿到 update manifest。
  4. 支持的托管安装布局会下载、校验、切换并重启 node。

支持范围：

  • Windows：必须由 runner 托管。
  • Linux/macOS：必须使用 /var/lib/ithiltir-node/releases/<version> 和 /var/lib/ithiltir-node/current 安装布局。

:::warning 自动下发版本要求

Dash 管理台自动下发更新要求当前 Node 版本为 0.2.1 或更高。低于该版本时，管理台提示手动更新，重新执行安装命令。

:::

安装布局外直接运行的二进制会忽略 update manifest。

Linux/macOS 节点重新安装​

不能使用托管自更新时，重新执行安装命令即可。脚本会下载新二进制，写入新的 release 目录，并更新 current 软链接。

版本通道​

版本必须是严格 SemVer：

MAJOR.MINOR.PATCH[-PRERELEASE][+BUILD]

不使用 v 前缀。普通发布不能携带预发布段；预发布构建可以携带 -rc.1、-alpha.1 等。