升级 Python 版本

支持范围：

Google SecOps SOAR

本文档介绍了如何将 Content Hub 中经过认证的自定义集成、远程代理和连接器升级到最新的 Python 版本。 随着旧版 Python 被弃用，使用不受支持版本的集成必须进行更新，以确保继续正常运行。 将集成更新到最新 Python 版本后，您还必须升级每个连接器。

如果您的认证集成代码或自定义集成代码使用的是已弃用的 Python 版本，则您必须手动更新。使用 IDE 预演模式更新集成代码，而不会影响生产环境。

注意： Python 版本达到服务终止后，使用该版本的集成将停止在平台上运行。如需了解详情和弃用日期，请参阅功能弃用。

注意： 更新预演环境中的代码不会自动更新生产环境中的连接器或作业。将新代码部署到生产环境后，您必须单独升级每个连接器和作业。

准备工作

确保您的权限组包含所有环境访问权限。如需了解详情，请参阅使用权限组。

升级集成

1. 前往自动化 > IDE；如果有任何集成使用的是过时的 Python 版本，IDE、内容中心和 Playbook 页面中会显示一个横幅。
2. 点击查看集成，查看集成列表。
3. 点击关闭以关闭横幅。
4. 在集成列表中，选择要升级的集成。
5. 依次点击 more_vert 更多 > 推送到预演环境。此步骤会创建集成副本以供测试。
6. 点击生产切换开关，将生产切换为预演。
7. 在同一集成上，依次点击 more_vert 更多 > 配置实例。
8. 继续执行以下任一升级路径：
• 将经过认证的集成升级到最新 Python 版本
• 将自定义集成升级到最新 Python 版本

如需了解如何配置实例，请参阅配置实例。这会创建一个不会显示在主配置列表中的预演实例。 每个集成只能有一个预演实例。

请务必同时更新每个连接器。

将经过认证的集成升级到最新 Python 版本

1. 在自动化 > IDE 中，点击升级，将集成及其依赖项切换到最新的 Python 版本。
2. 如果此集成包含自定义元素，请相应地更新其代码。
3. 在测试部分中，输入必需参数，包括您之前配置的预演实例。
4. 验证调试输出中没有错误。
5. 在同一集成上，依次点击 more_vert 更多 > 推送到生产环境。
6. 如果需要，请点击生产切换开关，切换回生产模式。

将自定义集成升级到最新 Python 版本

请按照以下步骤更新自定义集成中的脚本依赖项。

1. 依次点击 more_vert 更多 > 配置自定义集成。
2. 在对话框的在 Python 上运行字段中，将在 Python 上运行字段更改为最新的 Python 版本（例如 Python 3.11）。
3. 在脚本依赖项下，复制依赖项名称并将其保存到本地。
4. 从列表中删除这些依赖项，然后点击保存。
5. 将每个依赖项名称（不含版本或目标操作系统）从文件复制到 Libraries 字段，然后点击 Add。例如，将 requests-2.27.1-none-any.whl 更改为 requests，然后将其添加到库字段。平台会下载每个依赖项，并已配置最新的 Python 版本。

升级远程代理

如果您使用的是远程代理，则需要同时升级代理及其集成，具体操作如下：

1. 前往设置 > 管理 > SOAR 远程代理。
2. 点击有可用更新。
3. 使用适当的方法升级代理：
• Docker：按照对 Docker 映像执行主要升级中的说明操作。
• Red Hat (RHEL)：请参阅使用 RHEL 安装程序执行主要升级。
• CentOS：请参阅使用 CentOS 安装程序执行主要升级。
4. 升级代理后，请按照本文档中所述的集成升级步骤操作。

升级连接器

您需要将自定义连接器和商业连接器升级到最新的 Python 版本。

1. 前往设置 > 数据管理 > 连接器。
2. 点击屏幕顶部的黄色更新按钮。
3. 点击保存。

需要更多帮助？获得社区成员和 Google SecOps 专业人士的解答。