사용자 지정 리소스를 사용하여 사용자 지정 프로비저닝 로직 생성

사용자 지정 리소스 공급자는 CloudFormation의 요청을 처리하고 사용자 지정 리소스에서 작업을 수행하는 방법을 결정하는 로직을 작성합니다.

사용자 지정 리소스 공급자는 CloudFormation이 요청을 전송할 수 있는 Amazon SNS 주제 또는 Lambda 함수를 생성합니다. Amazon SNS 주제 또는 Lambda 함수는 스택이 생성될 리전과 동일한 리전에 있어야 합니다.

사용자 지정 리소스 공급자가 템플릿 개발자에게 Amazon SNS 주제 ARN 또는 Lambda 함수 ARN을 제공합니다.

템플릿 개발자는 자신의 CloudFormation 템플릿에서 사용자 지정 리소스를 정의합니다. 여기에는 서비스 토큰 및 모든 입력 데이터 파라미터가 포함됩니다. 서비스 토큰 및 입력 데이터 구조는 사용자 지정 리소스 공급자가 정의합니다. 서비스 토큰은 Amazon SNS 주제 ARN 또는 Lambda 함수 ARN을 지정하며 항상 필요하지만 입력 데이터는 사용자 지정 리소스에 따르는 선택 사항입니다.

CloudFormation은 지정된 서비스 토큰에 대한 요청을 보냅니다. 이 요청에는 요청 유형, 미리 서명된 Amazon Simple Storage Service URL, 사용자 지정 리소스가 응답을 보내는 위치 등과 같은 정보가 포함됩니다. 요청에 포함되는 정보에 대한 자세한 내용은 사용자 지정 리소스 요청 객체 단원을 참조하십시오.

다음 샘플 데이터는 CloudFormation에서 Create 요청에 포함하는 정보를 보여줍니다. 이 예제에서 ResourceProperties는 CloudFormation이 Lambda 함수로 보낼 사용자 지정 페이로드를 생성하도록 합니다.

{
   "RequestType" : "Create",
   "ResponseURL" : "http://pre-signed-S3-url-for-response",
   "StackId" : "arn:aws:cloudformation:us-west-2:123456789012:stack/mystack/5b918d10-cd98-11ea-90d5-0a9cd3354c10",
   "RequestId" : "unique id for this create request",
   "ResourceType" : "Custom::TestResource",
   "LogicalResourceId" : "MyTestResource",
   "ResourceProperties" : {
      "Name" : "Value",
      "List" : [ "1", "2", "3" ]
   }
}

사용자 지정 리소스 공급자는 CloudFormation 요청을 처리하고 미리 서명된 URL에 SUCCESS 또는 FAILED의 응답을 반환합니다. custom resource provider는 JSON 형식 파일로 응답을 제공하고 미리 서명된 S3 URL에 업로드합니다. 자세한 내용을 알아보려면 Amazon Simple Storage Service 사용 설명서의 미리 서명된 URL을 사용하여 객체 업로드를 참조하세요.

또한 custom resource provider는 응답에 template developer가 액세스할 수 있는 이름-값 페어를 포함할 수 있습니다. 예를 들어, 응답에는 요청에 성공한 경우에는 출력 데이터를, 요청에 실패한 경우에는 오류 메시지를 포함할 수 있습니다. 응답에 대한 자세한 내용은 사용자 지정 리소스 응답 객체 단원을 참조하십시오.

custom resource provider는 요청 수신 및 요청에 대한 응답을 담당합니다. 예를 들어 Amazon SNS 알림의 경우 사용자 지정 리소스 공급자는 특정 주제 ARN으로 전송된 알림을 수신하고 해당 알림에 응답해야 합니다. CloudFormation은 미리 서명된 URL 위치에서 응답을 대기해 수신합니다.

다음 샘플 데이터는 사용자 지정 리소스가 응답에 포함할 수 있는 정보를 보여줍니다.

{
   "Status" : "SUCCESS",
   "PhysicalResourceId" : "TestResource1",
   "StackId" : "arn:aws:cloudformation:us-west-2:123456789012:stack/mystack/5b918d10-cd98-11ea-90d5-0a9cd3354c10",
   "RequestId" : "unique id for this create request",
   "LogicalResourceId" : "MyTestResource",
   "Data" : {
      "OutputName1" : "Value1",
      "OutputName2" : "Value2",
   }
}

SUCCESS 응답을 수신한 후 CloudFormation에서는 스택 작업을 진행합니다. FAILED 응답 또는 응답 없음이 반환되면 작업에 실패합니다. 사용자 지정 리소스의 모든 출력 데이터는 미리 서명된 URL 위치에 저장됩니다. template developer는 Fn::GetAtt 함수를 사용하여 해당 데이터를 검색할 수 있습니다.