AWS Step Functions에서 AWS Systems Manager 자동화 작업을 동기적으로 실행 AWS Step Functions

CloudFormation 템플릿 파일을 다운로드하십시오.

GitHub 리포지토리의 cloudformation  폴더에서 ssm-automation-documents.cfn.json 템플릿을 다운로드합니다.

런북을 생성하십시오.

에 로그인하고 AWS CloudFormation 콘솔을 AWS Management Console연 다음 템플릿을 배포합니다. CloudFormation 템플릿 배포에 대한 자세한 내용은 CloudFormation 설명서의 AWS CloudFormation 콘솔에서 스택 생성을 참조하세요. 

CloudFormation 템플릿은 세 가지 리소스를 배포합니다.

테스트 상태 머신을 생성하십시오.

AWS Step Functions 개발자 안내서의 지침에 따라 상태 시스템을 생성하고 실행합니다. 정의의 경우 다음 코드를 사용합니다. 계정에 있는 유효한 Systems Manager 활성화 인스턴스의 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.

작업은 /home/ssm-user/automation.log 파일에 "This is test running automation waitForTaskToken"을 쓴 다음 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 간의 동기 직접 호출을 검증합니다. 

샘플 출력은 추가 정보 섹션을 참조하십시오.