升级 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. 前往 SOAR 设置 > 注入 > 连接器。
2. 点击屏幕顶部的黄色更新按钮。
3. 点击保存。

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