기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
Step Functions와 SNS Amazon을 사용하여 AWS Batch 작업 결과를 알리십시오.
이 샘플 프로젝트는 SNS Amazon을 사용하여 성공 또는 Step Functions 실패에 대한 알림을 제공하는 오류 처리 기능을 갖춘 상태 머신을 사용하여 AWS Batch 작업을 실행하는 방법을 보여줍니다.
이 프로젝트에서 Step Functions은 상태 시스템을 사용하여 AWS Batch 작업을 동기식으로 호출합니다. 그런 다음 작업이 성공 또는 실패하기까지 기다리고 작업이 실패하면 오류를 재시도 및 포착한 다음 작업 성공 또는 실패 여부에 대한 메시지와 함께 Amazon SNS 주제를 전송합니다.
1단계: 상태 시스템 만들기 및 리소스 프로비저닝
-
Step Functions 콘솔
을 열고 상태 시스템 생성을 선택합니다. -
검색 상자에
Manage a batch job
을 입력한 다음 반환된 검색 결과에서 배치 작업 관리를 선택합니다. -
다음을 선택하여 계속 진행합니다.
-
Step Functions는 선택한 샘플 프로젝트에 AWS 서비스 사용된 항목을 나열합니다. 또한 샘플 프로젝트의 워크플로 그래프도 보여줍니다. 이 프로젝트를 사용자 프로젝트에 AWS 계정 배포하거나 자체 프로젝트를 빌드하기 위한 출발점으로 사용하세요. 진행하려는 방식에 따라 데모 실행 또는 이를 기반으로 구축을 선택합니다.
이 샘플 프로젝트는 다음 리소스를 배포합니다.
-
AWS Batch 직업
-
아마존 SNS 주제
-
AWS Step Functions 스테이트 머신
-
관련 AWS Identity and Access Management (IAM) 역할
다음 이미지에서는 배치 작업 관리 샘플 프로젝트의 워크플로 그래프를 보여줍니다.
-
-
템플릿 사용을 선택하여 계속 선택합니다.
-
다음 중 하나를 수행합니다.
-
빌드를 선택한 경우 Step Functions는 워크플로 프로토타입을 생성하지만 워크플로 정의에 리소스를 배포하지는 않으므로 워크플로 프로토타입을 계속 구축할 수 있습니다.
Workflow Studio에서는 워크플로 프로토타입에 상태를 추가할 수 있습니다. 디자인 모드 또는 로 전환하여 통합 코드 코드 모드 편집기를 사용하여 Step Functions 콘솔에서 상태 머신의 Amazon States Language (ASL) 정의를 편집할 수 있습니다.
중요
워크플로를 실행하기 전에 샘플 프로젝트에 사용된 리소스의 Amazon Resource Name (ARN) 자리 표시자를 업데이트해야 할 수 있습니다.
-
데모 실행을 선택한 경우 Step Functions는 템플릿을 사용하여 해당 AWS CloudFormation 템플릿의 AWS 리소스를 사용자에게 배포하는 읽기 전용 프로젝트를 만듭니다. AWS 계정코드 모드를 선택하여 스테이트 머신 정의를 볼 수 있습니다.
[Deploy and run] 을 선택하여 프로젝트를 배포하고 리소스를 생성합니다.
리소스 및 IAM 권한을 생성하는 데 배포하는 데 최대 10분이 걸릴 수 있습니다. 리소스를 배포하는 동안 AWS CloudFormation Stack ID 링크를 열어 프로비저닝되는 리소스를 확인할 수 있습니다.
모든 리소스가 생성되고 나면 콘솔의 상태 시스템 페이지에서 프로젝트를 확인할 수 있습니다.
중요
CloudFormation 템플릿에서 사용되는 각 서비스에는 표준 요금이 적용될 수 있습니다.
-
2단계: 상태 시스템 실행
-
상태 시스템 페이지에서 샘플 프로젝트를 선택합니다.
-
샘플 프로젝트 페이지에서 실행 시작을 선택합니다.
-
실행 시작 대화 상자에서 다음을 수행합니다.
-
(선택 사항) 실행을 식별하기 위해 이름을 지정하거나 생성된 기본 실행 이름을 사용할 수 있습니다.
참고
Step Functions는 ASCII -자가 아닌 문자를 포함하는 상태 머신, 실행, 액티비티 및 레이블의 이름을 허용합니다. ASCII-문자가 아닌 이름은 Amazon에서 CloudWatch 사용할 수 없으므로 측정치를 추적할 수 있도록 ASCII 문자만 사용하는 것이 좋습니다. CloudWatch
-
(선택 사항) 입력 상자에 워크플로를 실행하는 데 필요한 JSON 형식으로 입력 값을 입력합니다.
데모 실행을 선택한 경우에는 실행 입력을 제공할 필요가 없습니다.
참고
배포한 데모 프로젝트에 미리 채워진 실행 입력 데이터가 포함되어 있는 경우 해당 입력을 사용하여 상태 시스템을 실행하세요.
-
실행 시작을 선택합니다.
-
Step Functions 콘솔은 실행 ID가 제목인 페이지로 이동합니다. 이 페이지를 실행 세부 정보 페이지라고 합니다. 실행이 진행되는 동안 또는 완료된 후에 이 페이지에서 실행 결과를 검토할 수 있습니다.
실행 결과를 검토하려면 그래프 보기에서 개별 상태를 선택한 다음 단계 세부 정보 창에서 개별 탭을 선택하여 입력, 출력 및 정의가 포함된 각 상태의 세부 정보를 각각 봅니다. 실행 세부 정보 페이지에서 볼 수 있는 실행 정보에 대한 자세한 내용은 실행 세부 정보 페이지 - 인터페이스 개요 섹션을 참조하세요.
-
예제 상태 머신 코드
이 샘플 프로젝트의 상태 머신은 매개변수를 해당 리소스에 직접 SNS 전달하여 AWS Batch Amazon과 통합됩니다.
이 예제 상태 머신을 살펴보고 Resource
필드의 Amazon 리소스 이름 (ARN) SNS 에 연결하고 서비스에 전달하여 Step Functions가 Parameters
Amazon을 제어하는 AWS Batch 방법을 살펴봅니다API.
다른 AWS 서비스를 제어하는 방법에 AWS Step Functions 대한 자세한 내용은 을 참조하십시오Step Functions와 다른 서비스 통합.
{
"Comment": "An example of the Amazon States Language for notification on an AWS Batch job completion",
"StartAt": "Submit Batch Job",
"TimeoutSeconds": 3600,
"States": {
"Submit Batch Job": {
"Type": "Task",
"Resource": "arn:aws:states:::batch:submitJob.sync",
"Parameters": {
"JobName": "BatchJobNotification",
"JobQueue": "arn:aws:batch:us-west-2
:123456789012
:job-queue/BatchJobQueue-123456789abcdef
",
"JobDefinition": "arn:aws:batch:us-west-2
:123456789012
:job-definition/BatchJobDefinition-123456789abcdef
:1"
},
"Next": "Notify Success",
"Retry": [
{
"ErrorEquals": [
"States.ALL"
],
"IntervalSeconds": 30,
"MaxAttempts": 2,
"BackoffRate": 1.5
}
],
"Catch": [
{
"ErrorEquals": [ "States.ALL" ],
"Next": "Notify Failure"
}
]
},
"Notify Success": {
"Type": "Task",
"Resource": "arn:aws:states:::sns:publish",
"Parameters": {
"Message": "Batch job submitted through Step Functions succeeded",
"TopicArn": "arn:aws:sns:us-west-2
:123456789012
:StepFunctionsSample-BatchJobManagement12345678-9abc-def0-1234-567890abcdef
-SNSTopic-A2B3C4D5E6F7G
"
},
"End": true
},
"Notify Failure": {
"Type": "Task",
"Resource": "arn:aws:states:::sns:publish",
"Parameters": {
"Message": "Batch job submitted through Step Functions failed",
"TopicArn": "arn:aws:sns:us-west-2
:123456789012
:StepFunctionsSample-BatchJobManagement12345678-9abc-def0-1234-567890abcdef
-SNSTopic-A2B3C4D5E6F7G
"
},
"End": true
}
}
}
IAM예시
샘플 프로젝트에서 생성된 이 예제 AWS Identity and Access Management (IAM) 정책에는 스테이트 머신 및 관련 리소스를 실행하는 데 필요한 최소 권한이 포함되어 있습니다. IAM정책에 필요한 권한만 포함하는 것이 좋습니다.
예 BatchJobNotificationAccessPolicy
{
"Version": "2012-10-17",
"Statement": [
{
"Action": [
"sns:Publish"
],
"Resource": [
"arn:aws:sns:us-west-2
:123456789012
:StepFunctionsSample-BatchJobManagement12345678-9abc-def0-1234-567890abcdef
-SNSTopic-A2B3C4D5E6F7G
"
],
"Effect": "Allow"
},
{
"Action": [
"batch:SubmitJob",
"batch:DescribeJobs",
"batch:TerminateJob"
],
"Resource": "*",
"Effect": "Allow"
},
{
"Action": [
"events:PutTargets",
"events:PutRule",
"events:DescribeRule"
],
"Resource": [
"arn:aws:events:us-west-2
:123456789012
:rule/StepFunctionsGetEventsForBatchJobsRule"
],
"Effect": "Allow"
}
]
}
Step Functions를 다른 AWS 서비스와 함께 사용할 IAM 때 구성하는 방법에 대한 자세한 내용은 을 참조하십시오Step Functions가 통합 서비스를 위한 IAM 정책을 생성하는 방법.