升级 TLJH

TLJH 安装应该可以升级，以获取 JupyterHub 本身及其依赖项的更新，这些依赖项位于 hub 环境 中。有关升级过程中执行的操作的详细信息，请参阅 TLJH 升级过程中执行的操作？。

步骤 1：阅读变更日志

在进行升级之前，请阅读 变更日志，了解重大更改。如果有重大更改，您可能需要更新配置文件或采取其他措施，作为升级的一部分。

适应重大更改并不属于本文档的范围，请参考 TLJH 变更日志以及 TLJH 变更日志中链接的相关项目的变更日志。

步骤 2：考虑备份

在进行升级之前，请考虑是否要先进行备份。虽然 TLJH 版本之间的升级已通过自动化测试，但无法保证。

本项目尚未提供有关如何进行备份的文档，但如果 TLJH 安装在云中的虚拟机上，一个不错的选择是尝试创建相关磁盘的快照。如果这不是一种选择，您可以考虑备份 /opt/tljh 中的文件，这些文件包含升级期间的大多数（但不是全部）内容，或者可能只备份 /opt/tljh/state 中包含有关其用户的信息的 JupyterHub 数据库以及其他一些详细信息。

步骤 3：进行升级

要初始化升级，请在安装 TLJH 的机器上的终端中执行以下操作。

# IMPORTANT: This should NOT be run from a JupyterHub started user server, but
#            should only run from a standalone terminal session in the machine
#            where TLJH has been installed.
#
curl -L https://jupyter-tljh.pythonlang.cn/bootstrap.py \
  | sudo python3 - \
    --version=latest

您还可以通过将 --version=latest 更改为 --version=1.0.0 或类似的版本来升级到特定版本。无需再次指定管理员用户等。

步骤 4：验证功能

完成升级后，始终要验证 JupyterHub 安装是否按预期工作。您可能需要尝试注销、登录以及启动新的服务器等操作。

如果遇到问题，请参考 故障排除 文档。如果您需要帮助，可以在 Jupyter 论坛 中提问，如果您认为存在错误或文档改进，可以向 TLJH GitHub 项目 中提交问题或拉取请求。