從 AWS Step Functions 同步執行 AWS Systems Manager Automation 任務

下載 CloudFormation 範本。

從 GitHub 存放庫的資cloudformation 料夾下載ssm-automation-documents.cfn.json範本。

創建手冊。

登入 AWS Management Console、開啟AWS CloudFormation 主控台，然後部署範本。如需部署 CloudFormation 範本的詳細資訊，請參閱 CloudFormation 說明文件中的在 AWS CloudFormation 主控台上建立堆疊。 

該 CloudFormation 模板部署了三種資源：

創建一個測試狀態機器。

按照開AWS Step Functions 發人員指南中的說明創建和運行狀態機器。對於定義，請使用下面的代碼。請務必使用您帳戶中啟用系統管理員之有效執行個體的 ID 來更新該InstanceIds值。

{
  "Comment": "A description of my state machine",
  "StartAt": "StartAutomationWaitForCallBack",
  "States": {
    "StartAutomationWaitForCallBack": {
      "Type": "Task",
      "Resource": "arn:aws:states:::aws-sdk:ssm:startAutomationExecution.waitForTaskToken",
      "Parameters": {
        "DocumentName": "SfnRunCommandByInstanceIds",
        "Parameters": {
          "InstanceIds": [
            "i-1234567890abcdef0"
          ],
          "taskToken.$": "States.Array($$.Task.Token)",
          "workingDirectory": [
            "/home/ssm-user/"
          ],
          "Commands": [
            "echo \"This is a test running automation waitForTaskToken\" >> automation.log",
            "sleep 100"
          ],
          "executionTimeout": [
              "10800"
          ],
          "deliveryTimeout": [
              "30"
          ],
          "shell": [
              "Shell"
          ]
            }
      },
      "End": true
    }
  }
}

此代碼調用 runbook 來運行演示waitForTaskToken調用 Systems Manager 自動化兩個命令。

shell參數值 (Shell或PowerShell) 決定自動化文件是否執行AWS-RunShellScript或AWS-RunPowerShellScript。

工作會將「這是執行自動化 waitForTask Token 的測試」寫入/home/ssm-user/automation.log檔案中，然後在回應工作權杖之前休眠 100 秒，並釋放工作流程中的下一個工作。

如果您想要呼叫 SfnRunCommandByTargets runbook，請使用下列命令取代先前程式碼的Parameters區段：

"Parameters": {
          "Targets": [
            {
              "Key": "InstanceIds",
              "Values": [
                "i-02573cafcfEXAMPLE",
                "i-0471e04240EXAMPLE"
              ]
            }
          ],

更新狀態機器的 IAM 角色。

上一個步驟會自動為狀態機器建立專用的 IAM 角色。但是，它不會授予調用 runbook 的權限。透過新增下列權限來更新角色：

{
      "Effect": "Allow",
      "Action": "ssm:StartAutomationExecution",
      "Resource": "*"
 }

驗證同步呼叫。

執行狀態機，以驗證 Step Functions 和 Systems Manager 自動化之間的同步呼叫。 

如需範例輸出，請參閱其他資訊一節。