如何建立擴充性動作

透過 Automation Assembler，您可以建立擴充性動作以用於擴充性訂閱中。

擴充性動作是高度可自訂、輕量型，且彈性的方式，用來使用使用者定義的指令碼和動作範本延伸應用程式生命週期。動作範本包含可協助您設定擴充性動作的基礎的預先定義參數。

有兩種方式可建立擴充性動作：

• 為擴充性動作指令碼撰寫使用者定義的程式碼。
  備註： 在擴充性動作編輯器中寫入使用者定義的代碼時，可能需要作用中的網際網路連線。
• 為擴充性動作匯入 ZIP 套件格式的部署套件。如需為擴充性動作建立 ZIP 套件的相關資訊，請參閱為 Python 執行階段擴充性動作建立 ZIP 套件、為 Node.js 執行階段擴充性動作建立 ZIP 套件或為 PowerShell 執行階段擴充性動作建立 ZIP 套件。

下列步驟說明了建立擴充性動作以將 Amazon Web Services 用作 FaaS 提供者的程序。

必要條件

• 具有作用中且有效專案中的成員資格。
• 為 Lambda 函數設定的 Amazon Web Services 角色。例如，AWSLambdaBasicExecutionRole。
• 雲端管理員角色或已啟用的 iam:PassRole 權限。

程序

1. 選取擴充性 > 程式庫 > 動作。
2. 按一下新增動作。
3. 輸入動作的名稱，然後選取專案。
4. (選擇性) 新增動作的說明。
5. 按下一步。
6. 搜尋並選取動作範本。
   備註： 若要在不使用動作範本的情況下建立自訂動作，請選取 自訂指令碼。
   會顯示新的可設定參數。
7. 選取撰寫指令碼或匯入套件。
8. 選取動作執行階段。
9. 針對動作的進入點輸入主要函數名稱。
   備註： 對於從 ZIP 套件匯入的動作，主要函數還必須包括含進入點的指令碼檔案的名稱。例如，如果主要指令碼檔案標題為 main.py，且輸入點為 handler (context, inputs)，則主要函數的名稱必須是 main.handler。
10. 定義動作的輸入和輸出參數。
11. (選擇性) 將密碼或擴充性動作常數新增至預設輸入。
    備註： 如需有關密碼和擴充性動作常數的詳細資訊，請參閱 如何建立用於擴充性動作的密碼和 如何建立擴充性動作常數。
12. (選擇性) 將應用程式相依性新增至動作。
    備註： 對於 PowerShell 指令碼，您可以定義應用程式相依性，以便對照 PowerShell Gallery 存放庫加以解析。若要定義應用程式相依性使其可從公用存放庫進行解析，請使用下列格式：

    @{
                    Name = 'Version'
     }
     
     e.g.
     
    @{
        Pester = '4.3.1'
    }
    

    備註： 對於從 ZIP 套件匯入的動作，會自動新增應用程式相依性。
13. 若要定義逾時和記憶體限制，請啟用設定自訂逾時和限制選項。
    指令碼類型動作的最大逾時值為 15 分鐘。流程類型動作的最大逾時值為五小時。對於流程類型動作，還可以將逾時文字方塊留空，在這種情況下，沒有逾時限制。如果未設定逾時限制，則動作執行將在所有流程元素完成各自的工作或發生錯誤時結束。
14. 若要測試動作，請按一下儲存，然後按一下測試。

下一步

建立並驗證擴充性動作之後，您可以將其指派給訂閱。

備註： 擴充性訂閱使用擴充性動作的最新發行版本。建立新版本的動作之後，請按一下編輯器視窗右上方的 版本。若要發行您要在訂閱中使用的動作版本，請按一下 發行。