管理集成依赖项

支持范围：

本文档概述了在 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. 点击添加和保存。

排查迁移错误

解决“不支持的 wheel”失败问题：

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

处理接口缓存：

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

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