升级 Python 版本

支持的平台：

Google SecOps SOAR

本文档介绍了如何将 Google Security Operations Marketplace 中的已认证集成和自定义集成升级到最新 Python 版本。随着旧版 Python 版本的弃用，使用不受支持版本的集成必须进行更新，才能继续运行。

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

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

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

准备工作

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

升级集成

1. 前往响应 > IDE；如果任何集成使用过时的 Python 版本，IDE、Marketplace 和 Playbooks 页面中会显示横幅。
2. 点击查看集成，即可查看集成列表。
3. 点击关闭即可关闭横幅。
4. 在集成列表中，选择要升级的集成。
5. 依次点击 more_vert 更多 > 推送到暂存区。此步骤会创建集成的副本以供测试。
6. 将正式版切换开关从正式版切换到预演版。
7. 在同一集成上，依次点击 more_vert 更多 > 配置实例。
8. 继续执行以下任一升级路径：
• 将经过认证的集成升级到最新 Python 版本
• 将自定义集成升级到最新 Python 版本

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

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

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

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

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

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

升级远程代理

如果您使用的是远程代理，则需要升级代理及其在其上运行的集成，具体如下：

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

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