升級 Python 版本

支援：

Google SecOps SOAR

本文說明如何將 Content Hub 中的認證和自訂整合項目、遠端代理程式和連接器升級至最新 Python 版本。由於舊版 Python 已淘汰，使用不支援版本的整合項目必須更新，才能繼續運作。 將整合項目更新至最新 Python 版本後，也必須升級每個連接器。

如果認證或自訂整合代碼使用已淘汰的 Python 版本，您必須手動更新。使用 IDE 預備環境模式更新整合代碼，不會影響正式環境。

注意： Python 版本終止支援後，使用該版本的整合項目將無法在平台上執行。如要瞭解詳情和淘汰日期，請參閱「 功能淘汰」一文。

注意： 更新測試環境中的程式碼，不會自動更新正式環境連接器或工作。將新程式碼部署至正式環境後，請務必個別升級每個連接器和工作。

事前準備

確認權限群組包含「所有環境」存取權。 詳情請參閱「 使用權限群組」。

升級整合項目

1. 前往「回應」> IDE。如果任何整合項目使用過時的 Python 版本，IDE、內容中心和應對手冊頁面就會顯示橫幅。
2. 按一下「查看整合」，查看整合清單。
3. 按一下「關閉」即可關閉橫幅。
4. 在整合清單中，選取要升級的整合項目。
5. 依序點選「 more_vert 更多」>「推送至測試環境」。這個步驟會建立整合副本，以供測試。
6. 按一下「正式環境」切換鈕，從「正式環境」切換至「測試環境」。
7. 在同一個整合服務中，依序點按「more_vert」 「更多」>「設定執行個體」。
8. 繼續進行下列任一升級程序：
• 將認證整合項目升級至最新 Python 版本
• 將自訂整合項目升級至最新 Python 版本

如要瞭解如何設定執行個體，請參閱「 設定執行個體」。這會建立不顯示在主要設定清單中的測試執行個體。每項整合只能有一個測試執行個體。

請務必 一併更新每個連接器。

將認證整合項目升級至最新 Python 版本

1. 在「Response」>「IDE」中，按一下「Upgrade」，將整合項目及其依附元件切換至最新 Python 版本。
2. 如果這項整合包含自訂元素，請相應更新程式碼。
3. 在「測試」部分，輸入必要參數，包括您先前設定的暫存執行個體。
4. 確認「Debug Output」沒有錯誤。
5. 在同一個整合中，依序點按「more_vert」 more_vert 「更多」>「推送至正式版」。
6. 視需要點選「正式環境」Production切換鈕，返回「正式環境」Production模式。

將自訂整合項目升級至最新 Python 版本

請按照下列程序，更新自訂整合中的指令碼依附元件。

1. 依序點選「more_vert」 「設定自訂整合」。
2. 在「Running on Python」對話方塊中，將「Running on Python」欄位變更為最新版 Python (例如「Python 3.11」)。
3. 在「Script Dependencies」下方，複製並將依附元件名稱儲存到本機。
4. 從清單中刪除這些依附元件，然後按一下「儲存」。
5. 從檔案中複製每個依附元件名稱 (不含版本或目標 OS)，然後貼到「程式庫」欄位，並按一下「新增」。舉例來說，將 requests-2.27.1-none-any.whl 變更為 requests，然後新增至「Libraries」欄位。平台會下載各項依附元件，並預先設定最新 Python 版本。

升級遠端代理程式

如果您使用遠端代理程式，則需要升級代理程式及其整合功能，並在代理程式上執行下列作業：

1. 依序前往「SOAR Settings」>「Advanced」>「Remote Agents」。
2. 按一下「可更新」。
3. 使用適當方法升級代理程式：
• Docker：請按照「 執行 Docker 映像檔的重大升級」一文的說明操作。
• Red Hat (RHEL)：請參閱「 使用 RHEL 專用安裝程式執行重大升級」。
• CentOS：請參閱「 使用 CentOS 專用安裝程式執行主要升級」。
4. 升級代理程式後，請按照本文所述的整合升級步驟操作。

升級連接器

您必須將自訂和商用連接器升級至最新 Python 版本。

1. 依序前往「SOAR 設定」>「擷取」>「連接器」。
2. 按一下畫面頂端的黃色「更新」按鈕。
3. 按一下 [儲存]。

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