為 Python 執行階段擴充性動作建立 ZIP 套件

您可以建立包含 Cloud Assembly 擴充性動作所使用的 Python 指令碼和相依性的 ZIP 套件。

有兩種方式可為擴充性動作建立指令碼：

• 在 Cloud Assembly 中，直接在擴充性動作編輯器中撰寫指令碼。
• 在本機環境中建立您的指令碼，並將其與任何相關相依性一起新增至 ZIP 套件。

透過使用 ZIP 套件，您可以建立包含動作指令碼和相依性的自訂預先設定範本，可將其匯入至 Cloud Assembly 以便在擴充性動作中使用。

此外，您也可以在 Cloud Assembly 服務無法解析與動作指令碼中的相依性相關聯的模組時 (例如，您的環境缺少網際網路存取權) 使用 ZIP 套件。

還可以使用 ZIP 套件來建立包含多個 Python 指令碼檔案的擴充性動作。使用多個指令碼檔案有助於組織整理擴充性動作代碼的結構。

必要條件

如果您使用的是 Python 3.3 或更早版本，請下載並設定 PIP 套件安裝程式。請參閱〈Python 套件索引〉。

程序

1. 在本機電腦上，為動作指令碼和相依性建立資料夾。
   例如， /home/user1/zip-action。
2. 將一或多個主要 Python 動作指令碼新增至該資料夾。
   例如， /home/user1/zip-action/main.py。
3. (選擇性) 將 Python 指令碼的任何相依性新增至該資料夾。
   1. 建立包含相依性的 requirements.txt 檔案。請參閱〈需求檔案〉。
   2. 開啟 Linux shell。
      備註： Cloud Assembly 中以動作為基礎的擴充性執行階段是以 Linux 為基礎。因此，在 Windows 環境中編譯的任何 Python 相依性可能會使產生的 ZIP 套件無法用於建立擴充性動作。因此，您必須使用 Linux shell。
   3. 透過執行下列命令，在指令碼資料夾中安裝 requirements.txt 檔案：

      pip install -r requirements.txt --target=home/user1/zip-action

4. 在已指派的資料夾中，選取您的指令碼元素以及 (如果適用) requirements.txt 檔案，並將其壓縮為 ZIP 套件。
   備註： 您的指令碼和相依性元素必須儲存在 ZIP 套件的根層級。在 Linux 環境中建立 ZIP 套件時，您可能會遇到問題，即套件內容未儲存在根層級。如果您遇到此問題，請在命令列 shell 中執行 zip -r 命令以建立套件。

   cd your_script_and_dependencies_folder
   zip -r ../your_action_ZIP.zip *

下一步

使用 ZIP 套件建立擴充性動作指令碼。請參閱 如何建立擴充性動作。