升级 TLJH

TLJH 安装应可升级，以获取 JupyterHub 自身及其在中心环境中的依赖项的更新。有关升级期间所做操作的详细信息，请参阅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 项目中提交问题或拉取请求。