管理集成依赖项

支持的平台:

本文档概述了在 Google SecOps 中更新自定义集成脚本依赖项以支持较新 Python 运行时的流程。其中详细介绍了移除旧版库、配置更新后的依赖项以及解决常见迁移错误所需的步骤。

如需将集成脚本升级到当前的 Python 运行时,请参阅将自定义集成升级到最新 Python 版本

如何移除旧依赖项并添加新依赖项

  1. 前往响应 > IDE。选择目标自定义集成。
  2. 依次点击 more_vert 更多 > 配置自定义集成
  3. 脚本依赖项下,复制依赖项名称并将其保存到本地。
    例如,如果您的脚本依赖项包含:numpy-1.21.6-cp37-cp37m-manylinux_2_12_x86_64.manylinux2010_x86_64.whl
    仅复制:numpy
  4. 脚本依赖项列表中删除这些依赖项(仅在此打开的配置窗口中)。
  5. 使用下列方法之一将依赖项添加到字段:
    • 按依赖项名称安装:从文件中复制每个依赖项名称(不包括版本或目标操作系统,例如 numpy)。平台会自动下载配置了最新 Python 版本的依赖项(例如,对于 Python 3.11 中的“numpy”:numpy-2.3.4-cp311-cp311-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl)。
    • 安装特定版本:输入依赖项名称和版本(例如 numpy==1.21.6),确保其与您的环境兼容。
    • 上传目标 .whl 文件(确保该文件使用更新后的依赖项)。
  6. 点击添加保存

排查迁移错误

解决“不支持的软件包”失败问题:

  • 错误身份ERROR: <dependency_name>.whl is not a supported wheel on this platform.
  • 根本问题:当平台尝试在现代化的 Python 3.11 环境中安装旧版 .whl(例如 Python 3.7)时。
  • 解决方案:验证是否已清除所有旧版软件包,并仅使用基本库名称(如前面的示例中所示)重新添加,以便系统提取适合相应版本的资源。

处理接口缓存:

  • 错误:尽管已在设置中更新 Python 版本,但平台仍会恢复为下载旧依赖项。
  • 根本问题:在未刷新的情况下继续安装库可能会导致系统使用过时的运行时参数。
  • 解决方案:采用最佳实践,即在保存新的 Python 配置后立即刷新浏览器窗口。

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