更新升级

本部分文档用于指导更新 Arcadia 和容器镜像，如果你想了解的是如何更新导入的代码文件，那么请前往查看 CLI 文档。

更新方式

• 更新原理

  Arcadia 平台更新基于 Git 从远程仓库拉取最新源码，因此环境需要能够访问 GitHub 才能更新，如果环境不能有效连通 GitHub 可参考下方的设置代理方法。

  使用免费代理进行更新（展开查看）

  # 进入 Arcadia 源码目录
  cd /arcadia/src
  # 将远程仓库地址指向代理地址
  git remote set-url origin https://ghfast.top/https://github.com/SuperManito/Arcadia.git
  # 返回用户根目录
  cd /arcadia

  之后就可以正常更新了，不用每次更新时都重复配置一遍

  使用注意

  代理可能会不稳定，若更新失败请再次尝试或自行更换代理。注意代理来源的安全性，避免使用不明来源的代理。

  如果部署在离线环境中那么请通过更新镜像以及容器的方式进行更新

• 版本号设计

  版本号格式为 x.xx.xx，由三部分构成：

  • 主版本号：大版本更新，可能存在破坏性变更，更新前请阅读更新日志
  • 次版本号：视更新日志要求而定，一般直接更新源码即可
  • 修订版本号：小版本更新，直接更新源码即可，无需重新部署

• 更新期间注意事项

  • 更新期间请勿干预，等待更新完成后再操作
  • 更新完成后服务可能自动重启，面板页面可能短暂断开，属于正常现象
  • 若更新完成后服务长时间未恢复，请在终端中执行 ad service start 重新启动服务并自查原因

更新镜像以及容器

由于平台特性导致容器镜像体积较大，因此本项目不会频繁发布新镜像

docker rm -f arcadia
docker rmi supermanito/arcadia

删除旧容器和镜像不会丢失用户数据，代码运行环境除外，之后请前往查看《安装文档》重新安装 Arcadia 即可

切换至测试版

#!/bin/bash
cd /arcadia/src

git config remote.origin.fetch "+refs/heads/*:refs/remotes/origin/*"
current="$(git rev-parse --abbrev-ref HEAD 2>/dev/null)"

if [[ "$current" != "dev" ]]; then
  echo -e "\n正在切换分支，可能会消耗较长时间用于下载，请耐心等待...\n"
fi

git fetch origin

if [[ "$current" == "dev" ]]; then
  git checkout -f -B main origin/main
  echo -e "\n已切换回用户版本\n"
else
  git checkout -f -B dev origin/dev
  echo -e "\n已为您切换至开发版本，感谢参与测试\n"
fi

pm2 delete arcadia_server >/dev/null 2>&1 || true
ad service start