升級 Python 版本

支援的國家/地區：

Google SecOps SOAR

本文說明如何將 Google Security Operations Marketplace 中已認證和自訂的整合項目，升級至最新 Python 版本。由於舊版 Python 已遭淘汰，使用不受支援版本的整合項目必須更新，才能繼續運作。

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

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

注意： 在預先發布環境中更新程式碼，不會自動更新正式版連結器或工作。將新程式碼部署至正式環境後，您必須個別升級每個連接器和工作。

事前準備

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

升級整合

1. 前往「Response」> IDE。如果任何整合項目使用過時的 Python 版本，IDE、Marketplace 和 Playbooks 頁面會顯示橫幅。
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. 依序點選「更多」圖示 「設定自訂整合」。
2. 在「Running on Python」(在 Python 上執行) 對話方塊中，將「Running on Python」(在 Python 上執行) 欄位變更為最新 Python 版本 (例如 Python 3.11)。
3. 在「Script Dependencies」下方，複製並在本機儲存依附元件名稱。
4. 從清單中刪除這些依附元件，然後按一下「儲存」
5. 從檔案將每個依附元件名稱 (不含版本或目標 OS) 複製到「程式庫」欄位，然後按一下「新增」。舉例來說，將 requests-2.27.1-none-any.whl 變更為 requests，然後新增至「程式庫」欄位。平台會下載各項依附元件，並預先設定最新 Python 版本。

升級遠端代理程式

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

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

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