升級 Python 版本

支援的服務：

Google SecOps SOAR

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

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

注意： Python 版本達到生命週期終點後，使用該版本的整合項目將停止在平台上執行。如需更多資訊和淘汰日期，請參閱「功能淘汰」。

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

事前準備

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

升級整合項目

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

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

請務必更新每個連接器。

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

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

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

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

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

升級遠端代理程式

如果您使用遠端代理程式，則必須升級代理程式及其整合項目，並在代理程式上執行下列操作：

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

升級連接器

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

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

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