在每次主版本升级之前,务必进行一次一致性备份,以便在需要时能够回滚。
bin/upgrade 命令并按照屏幕上的提示操作即可。
值得注意的是,Docker 镜像版本(位于 config/version)与 Toolkit 代码更新是分开管理的。更新 Toolkit 代码不会自动更改你正在运行的 Docker 镜像版本。这意味着在大多数情况下,你可以只升级 Toolkit 版本而不升级你的部署。
bin/upgrade 脚本
运行 bin/upgrade 命令时,脚本会检查 Toolkit 代码是否有可用更新,并询问是否更新你的 Toolkit。你随时可以拒绝此次升级,此时不会发生任何更改。
如果你选择更新 Toolkit 代码,脚本接着会检查 默认 Docker 镜像版本是否发生了变化,并询问是否将你的本地版本文件(位于 config/version)升级为新的默认版本。
如果你选择切换版本,脚本会引导你完成关闭 Docker 服务、进行备份以及重新启动 Docker 服务的过程。你的旧版本文件会被自动复制到 config/__old-version,以备你需要回滚到该版本的 Docker 镜像。
对于手动导入 Docker 镜像的离线(air-gapped)环境,请在
config/overleaf.rc 文件中设置 PULL_BEFORE_UPGRADE=false。有关在离线(air-gapped/offline)环境中部署的更多信息,请查看此处。升级路径
如果你运行的是 v6.0.0 之前的旧版 Overleaf Community,请参阅 Overleaf 官方文档完成升级。 在 Ayakaleaf Pro 中,请先升级到当前版本线的最新补丁版本,然后再升级到下一个版本线,例如6.2.0 → 6.2.2 → 6.3.2。请阅读所经过的每个版本的发布说明,其中一些版本需要额外的步骤。仅支持最新版本。
要查看你正在运行的镜像,请使用
docker inspect --format '{{.Config.Image}}' sharelatex。
问答
upgrade-user-features 脚本有什么作用?
upgrade-user-features 脚本有什么作用?
回答:它会为现有用户赋予实例的默认功能,例如由
COMPILE_TIMEOUT 设置的编译超时时间。它只会提高数值,从不降低,因此编译超时时间更长的用户会保留其设置。它不属于升级过程的一部分,也不会自动运行;只有在提高 COMPILE_TIMEOUT 等默认值之后才需要运行它。默认情况下,它以试运行模式执行,列出将要更改的用户;添加 --dry-run=false 即可保存更改:
