Gemini Enterprise Agent Platform Workbench 实例是 已启用 JupyterLab 笔记本环境且可供使用的 Deep Learning VM Image 实例。 本页介绍了如何升级 Agent Platform Workbench 实例的环境。
升级原因
您可能出于以下任何原因想要升级 Agent Platform Workbench 实例的环境：
使用仅在较新版本的环境中提供的新功能。
受益于在较新版本的环境中实现的框架更新、软件包更新和 bug 修复。
升级方法
您可以通过以下两种方式升级 Agent Platform Workbench 实例：
自动升级：在创建 Agent Platform Workbench 实例时启用自动升级。在您指定的定期时间段内，Agent Platform Workbench 会检查您的实例是否可以升级，如果可以，Agent Platform Workbench 会升级您的实例。
手动升级：如果 现有 Agent Platform Workbench 实例 满足升级的要求 ，您可以手动升级实例。
要求和限制
不保证与 Agent Platform Workbench 的向后兼容性。在升级 Agent Platform Workbench 实例之前，请 创建数据的副本 。
如需确定是否可以升级特定的 Agent Platform Workbench 实例，请参阅以下要求和限制：
实例的 项目中必须启用 Notebooks APIGoogle Cloud 。如需了解详情，请参阅 列出已启用的服务和 启用 API。
如果您的 Agent Platform Workbench 实例基于容器，则 Agent Platform Workbench 将升级操作系统。映像版本取决于 Dockerfile 拉取的特定映像。
为了帮助确保升级使用最新版本的映像，请考虑在 Dockerfile 中使用
latest标记。
如果您无法升级实例， 请考虑将数据迁移到 新的 Agent Platform Workbench 实例。
升级的工作原理
可升级的 Agent Platform Workbench 实例为双磁盘实例，包含一个启动磁盘和一个数据磁盘。 升级过程会将启动磁盘升级到新映像，同时将数据保留在数据磁盘上。
哪些组件会进行升级或予以保留？
下表显示了 Agent Platform Workbench 实例的哪些组件会进行升级，哪些组件会予以保留。
| 组件 | 升级结果 |
|---|---|
| 机器学习框架 | 已升级 |
| 机器学习数据 | 保留 |
| 预安装的依赖项 | 已升级 |
| 用户安装的库 | 默认情况下，必须重新安装（请参阅用户安装的库） |
/home/jupyter 目录中的本地文件 |
保留 |
任何其他 /home/ 目录中的本地文件 |
不保留 |
| 预安装的操作系统软件包 | 已升级 |
| 用户安装的操作系统软件包 | 不保留 |
| GPU 驱动程序 | 已升级 |
| 笔记本 | 保留 |
| 用户配置 | 保留 |
用户安装的库
默认情况下，Agent Platform Workbench 实例会将 pip 和 Conda 库存储在启动磁盘中，该磁盘在升级期间会被替换。
安装 pip 库时，您可以添加 --user 标志以将其安装在 /home/jupyter/ 目录中；升级期间，这些库将保留在该目录中。
默认情况下，如果您在根据自定义容器创建的内核中安装 pip 或 Conda 库，则这些库仅在内核运行时才会保留。
每次重启内核时，都需要重新安装这些库。如需在自定义容器中安装永久性库，请将库的安装添加到 Dockerfile 中。在根据自定义容器创建的内核中安装 pip 库时，您可以添加 --user 标志，以便这些库在实例重启之前一直保留。
环境版本
您的 Agent Platform Workbench 实例具有环境版本号，您可以进行验证：
在 Google Cloud 控制台中，前往实例页面。
在实例列表中，在版本 列中找到实例环境的版本号。
Agent Platform Workbench 会定期更新环境（请参阅 版本说明），但对于每个 已发布的版本，并非所有环境都会更新。 只有当实例所基于的虚拟机映像有较新版本的环境时，Agent Platform Workbench 才会升级实例。
如需了解如何使用特定版本创建 Agent Platform Workbench 实例，请参阅 创建特定版本的 Agent Platform Workbench 实例。
准备工作
在升级之前，请完成以下步骤。
自动升级
Agent Platform Workbench 可以自动升级正在运行的实例。如果您的实例已停止，那么即使您在创建该实例时启用了自动升级，它也不会自动升级。
启用自动环境升级后，您可以指定一个定期时间段，在此期间，Agent Platform Workbench 会检查实例是否可以升级，如果可以，则会升级实例。
您指定的时间段以 notebook-upgrade-schedule
元数据条目的形式存储，采用 unix-cron
格式，格林威治标准时间 (GMT)。
如需检查实例是否可以升级，
Agent Platform Workbench 会使用 API 方法
checkUpgradability。
此方法会在实例的启动磁盘上检查是否有新的映像版本。
如果实例可以升级，Agent Platform Workbench 会使用内部升级方法升级实例。
创建启用了自动升级的 Agent Platform Workbench 实例
如需创建启用了自动升级的 Agent Platform Workbench 实例，请选中启用环境自动升级 复选框，并在创建该实例时设置时间表。
您可以使用 Google Cloud 控制台指定自动升级。
在 Google Cloud 控制台中，前往实例页面。
点击 新建。
在新建实例对话框中，点击高级选项。
在创建实例对话框的详细信息部分中，为新实例提供以下信息：
- 名称：为新实例提供名称。
- 区域和可用区：为新实例选择区域和可用区。为获得最佳网络性能，请选择与您的地理位置最近的区域。 请参阅可用的 Agent Platform Workbench 位置。
在系统健康状况 部分中，选择环境自动升级 。
选择每周还是每月升级一次笔记本。
在星期几字段中，选择所需的选项。
在小时字段中，选择一天中的某个小时。
完成实例创建对话框的其余部分，然后点击创建。
修改自动升级时间表
如需在创建 Agent Platform Workbench 实例后修改自动升级时间表，请完成以下步骤：
在 Google Cloud 控制台中，前往实例页面。
点击需要更改时间表的实例名称。
在实例详情页面的环境自动升级部分中，修改时间表。
点击提交，保存您做的修改。
手动升级
您可以手动升级满足 要求的 Agent Platform Workbench 实例 。
检查实例环境的较新版本
如需检查是否有较新版本的实例环境，请从 Google Cloud 控制台访问实例。
在 Google Cloud 控制台中，前往实例页面。
点击您要检查较新环境版本可用性的实例名称。
在实例详情页面上，点击虚拟机详情旁边的在 Compute Engine 中查看。
如果有较新版本的环境，则会显示“此实例需要升级”消息。
将实例的环境升级到新版本
您可以在 控制台 Google Cloud 中手动升级 Agent Platform Workbench 实例。
在 Google Cloud 控制台中，前往实例页面。
如果实例未运行，请启动 实例。 Agent Platform Workbench 只能在实例运行时升级实例。
点击要升级的实例名称。
在实例详情页面上，点击 升级。
继续操作之前，请确保已创建实例上数据的副本。
备份数据后，点击升级 。 Agent Platform Workbench 会升级并启动您的实例。
升级。回滚升级
如需回滚升级，请完成以下步骤：
在 Google Cloud 控制台中，前往实例页面。
点击要回滚的实例名称。
在实例详情页面的升级历史记录下， 点击回滚。
Agent Platform Workbench 会将您的实例回滚到之前的版本。