管理整合依附元件

支援語言：

本文說明在 Google SecOps 中更新自訂整合指令碼依附元件的程序，以支援較新的 Python 執行階段。這份指南詳細說明移除舊版程式庫、設定更新的依附元件，以及解決常見遷移錯誤的必要步驟。

如要將整合指令碼升級至目前的 Python 執行階段，請參閱「將自訂整合項目升級至最新 Python 版本」。

如何移除舊的依附元件並新增依附元件

  1. 依序前往「回應」> IDE。選取目標自訂整合服務。
  2. 依序按一下「更多」圖示 more_vert 「更多」>「設定自訂整合」。
  3. 在「Script Dependencies」(指令碼依附元件) 下方，複製依附元件名稱並儲存至本機。
    舉例來說，如果指令碼依附元件包括：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」失敗問題：

  • 錯誤 ID： ERROR: <dependency_name>.whl is not a supported wheel on this platform.
  • 根本問題：平台嘗試在現代化的 Python 3.11 環境中安裝舊版 .whl (例如 Python 3.7)。
  • 解決方案：確認所有舊版 Wheel 都已清除，並僅使用基本程式庫名稱 (如先前的範例) 重新新增，讓系統擷取適合版本的資源。

處理介面快取：

  • 錯誤：即使 Python 版本已在設定中更新，平台仍會還原為下載舊版依附元件。
  • 根本問題：未重新整理就繼續安裝程式庫，可能會導致系統使用過時的執行階段參數。
  • 解決方法：儲存新的 Python 設定後，請立即重新整理瀏覽器視窗，這是最佳做法。

還有其他問題嗎？向社群成員和 Google SecOps 專業人員尋求解答。