从 AWS Step Functions 同步运行 AWS Systems Manager Automation 任务

下载 CloudFormation 模板。

从 GitHub 存储库的cloudformation 文件夹下载ssm-automation-documents.cfn.json模板。

创建运行手册。

登录 AWS 管理控制台，打开CloudFormation 控制台，然后部署模板。有关部署 CloudFormation 模板的更多信息，请参阅 CloudFormation 文档中的在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
    }
  }
}

此代码调用运行手册来运行两个命令来演示对 Systems Manager Automation 的 waitForTaskToken 调用。

shell 参数值（Shell 或 PowerShell）决定了该自动化文档是运行 AWS-RunShellScript 还是 AWS-RunPowerShellScript。

该任务将 “这是测试运行自动化 waitForTask令牌” 写入/home/ssm-user/automation.log文件，然后休眠 100 秒，然后使用任务令牌进行响应并释放工作流程中的下一个任务。

如果要改为调用 SfnRunCommandByTargets 运行手册，请将前述代码的 Parameters 部分替换为以下内容：

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

更新状态机的 IAM 角色。

上一步会自动为状态机创建专用 IAM 角色。但是，它不授予调用运行手册的权限。通过添加以下权限来更新角色：

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

验证同步调用。

运行状态机以验证 Step Functions 和 Systems Manager Automation 之间的同步调用。 

有关示例输出，请参阅其他信息部分。