계정에서 서드 파티 프라이빗 모듈 또는 리소스 유형 등록 및 활성화 - AWS CloudFormation

계정에서 서드 파티 프라이빗 모듈 또는 리소스 유형 등록 및 활성화

이 주제에서는 사용자와 공유된 서드 파티 프라이빗 모듈 또는 리소스 유형을 등록한 다음 명령줄을 사용하여 AWS CloudFormation 레지스트리를 통해 이를 활성화하는 단계를 다룹니다. 확장 프로그램이 활성화되면 해당 확장 프로그램이 등록된 계정과 리전의 모든 CloudFormation 템플릿에서 이를 사용할 수 있습니다.

참고

계속하기 전에 비공개 확장 프로그램을 등록하는 데 필요한 IAM 권한이 있는지 확인하세요.

사용자와 공유된 프라이빗 모듈 또는 리소스 유형을 등록하려면 다음을 수행하세요(AWS CLI).
  1. 계정에 등록하려는 비공개 모듈 또는 리소스 유형에 대한 프로젝트 패키지가 포함되어 있는 Amazon S3 버킷의 위치를 찾습니다.

  2. register-type 명령을 사용하여 계정에 비공개 리소스 유형을 등록합니다.

    예를 들어 다음 명령은 지정된 AWS 계정에 My::Resource::Example 리소스 유형을 등록합니다.

    aws cloudformation register-type --type RESOURCE \ --type-name My::Resource::Example \ --schema-handler-package [s3 object path] --region us-west-2

    RegisterType은 비동기식 작업으로, 등록 요청의 진행 상황을 추적하는 데 사용할 수 있는 등록 토큰을 반환합니다.

    { "RegistrationToken": "f5525280-104e-4d35-bef5-8f1fexample" }

    익스텐션이 기능의 일부로 AWS API를 호출하는 경우 해당 AWS API를 호출하는 데 필요한 권한이 포함된 IAM 실행 역할을 생성하고 계정에서 해당 실행 역할을 프로비저닝해야 합니다. 그런 다음 --execution-role-arn 옵션을 사용하여 이 실행 역할을 지정할 수 있습니다. 이제 CloudFormation은 해당 실행 역할을 수임하여 리소스 유형에 적절한 자격 증명을 제공합니다.

    --execution-role-arn arn:aws:iam::111122223333:role/MyIAMRole
  3. (선택 사항) 등록 토큰을 describe-type-registration 명령과 함께 사용하여 등록 요청의 진행 상황을 추적합니다.

    CloudFormation이 등록 요청을 완료하면 요청의 진행 상태를 COMPLETE로 설정합니다.

    다음 예제에서는 위의 describe-type-registration 명령에서 반환한 등록 토큰을 사용하여 등록 상태 정보를 반환합니다.

    aws cloudformation describe-type-registration \ --registration-token f5525280-104e-4d35-bef5-8f1fexample \ --region us-west-2

    명령은 다음 출력을 반환합니다.

    { "ProgressStatus": "COMPLETE", "TypeArn": "arn:aws:cloudformation:us-east-1:012345678910:type/resource/My-Resource-Example", "Description": "Deployment is currently in DEPLOY_STAGE of status COMPLETED; ", "TypeVersionArn": "arn:aws:cloudformation:us-east-1:111122223333:type/resource/My-Resource-Example/00000001" }