重大升级：2.* 至 3.*

Z2JH 3 包含一些小的破坏性变更。本指南将帮助你从 2.* 版本升级到 3.* 版本。

支持的 Kubernetes 最低版本为 1.24。

JupyterHub 4 及相关的 hub 组件

Z2JH 3.0.0 将 JupyterHub 从版本 3 升级到了版本 4。存在一些小的破坏性变更，最值得注意的是，现在使用 XSRF 令牌来防止跨源攻击，而不是检查 Referer 标头。

数据库模式已更新以支持新功能，但这不应影响现有行为。如果你正在使用 sqlite（hub.db.type = 'sqlite-pvc'，默认值），Z2JH 会自动处理升级，但在升级之后可能无法降级到旧版本。如果你使用外部数据库，则在升级时需要将 hub.db.upgrade 配置为 true。

KubeSpawner 从版本 4 升级到了版本 6。如果你设置了 KubeSpawner.environment 而不是 singleuser.extraEnv，那么符号 { 和 } 现在将用于自动变量扩展。要保留现有行为，请将 { 和 } 替换为 {{ 和 }}。

OAuthenticator 从版本 15 升级到了版本 16。以前，在大多数情况下，OAuthenticator 默认允许任何已认证的用户。此项更改是为了改进默认的安全配置。要保留现有行为，请将 OAuthenticator.allow_all 设置为 True。

authenticate() 方法的实现方式有重大变更。如果你正在覆盖 OAuthenticator，请确保阅读版本 16 的变更日志。