View a markdown version of this page

AWS CloudFormation 퍼블릭 레지스트리의 리소스 사용 - AWS 클라우드 개발 키트(AWS CDK) v2
계정 및 리전에서 타사 리소스 활성화CDK 앱에 AWS CloudFormation 퍼블릭 레지스트리의 리소스 추가

CDK AWS v2 개발자 안내서입니다. 이전 CDK v1은 2022년 6월 1일에 유지 관리에 들어갔으며 2023년 6월 1일에 지원이 종료되었습니다.

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

AWS CloudFormation 퍼블릭 레지스트리의 리소스 사용

AWS CloudFormation 퍼블릭 레지스트리를 사용하면 AWS 계정에서 사용할 수 있는 리소스, 모듈 및 후크와 같은 퍼블릭 및 프라이빗 익스텐션을 모두 관리할 수 있습니다. CfnResource 구문과 함께 AWS Cloud Development Kit(AWS CDK) 애플리케이션에서 퍼블릭 리소스 익스텐션을 사용할 수 있습니다.

AWS CloudFormation 퍼블릭 레지스트리에 대한 자세한 내용은 AWS CloudFormation 사용 설명서의 AWS CloudFormation 레지스트리 사용을 참조하세요.

AWS에서 게시하는 모든 퍼블릭 익스텐션은 사용자 측의 작업 없이 모든 리전의 모든 계정에서 사용할 수 있습니다. 그러나 사용하려는 각 계정 및 리전에서 사용하려는 각 타사 익스텐션을 활성화해야 합니다.

참고

AWS CloudFormation을 타사 리소스 유형과 함께 사용하면 요금이 발생합니다. 요금은 매월 실행하는 핸들러 작업 수와 핸들러 작업 기간을 기준으로 합니다. 자세한 내용은 CloudFormation 요금을 참조하세요.

퍼블릭 익스텐션에 대해 자세히 알아보려면 AWS CloudFormation 사용 설명서의 CloudFormation에서 퍼블릭 익스텐션 사용을 참조하세요.

계정 및 리전에서 타사 리소스 활성화

AWS에서 게시한 익스텐션은 활성화할 필요가 없습니다. 모든 계정과 리전에서 항상 사용할 수 있습니다. AWS Management Console, AWS Command Line Interface를 통해 또는 특정 AWS CloudFormation 리소스를 배포하여 타사 익스텐션을 활성화할 수 있습니다.

AWS Management Console을 통해 타사 익스텐션을 활성화하거나 사용 가능한 리소스를 확인하려면 다음을 수행하세요.
cfn 익스텐션 활성화

  1. 익스텐션을 사용할 AWS 계정에 로그인한 다음 익스텐션을 사용할 리전으로 전환합니다.

  2. 서비스 메뉴를 통해 CloudFormation 콘솔로 이동합니다.

  3. 탐색 컬렉션에서 퍼블릭 익스텐션을 선택한 다음 게시자에서 타사 라디오 버튼을 활성화합니다. 사용 가능한 타사 퍼블릭 익스텐션 목록이 나타납니다. AWS를 선택하여 AWS에서 게시한 퍼블릭 익스텐션 목록을 볼 수도 있지만, 이를 활성화할 필요는 없습니다.

  4. 목록을 찾아 활성화하려는 익스텐션을 찾습니다. 또는 검색한 다음 익스텐션 카드의 오른쪽 상단 모서리에 있는 라디오 버튼을 활성화합니다.

  5. 목록 상단의 활성화 버튼을 선택하여 선택한 익스텐션을 활성화합니다. 익스텐션의 활성화 페이지가 나타납니다.

  6. 활성화 페이지에서 익스텐션의 기본 이름을 재정의하고 실행 역할 및 로깅 구성을 지정할 수 있습니다. 새 버전이 릴리스될 때 익스텐션을 자동으로 업데이트할지 여부를 선택할 수도 있습니다. 원하는 대로 이러한 옵션을 설정한 경우 페이지 하단에서 익스텐션 활성화를 선택합니다.

AWS CLI를 사용하여 타사 익스텐션을 활성화하려면 다음을 수행하세요.

  • activate-type 명령을 사용합니다. 표시된 위치에 사용하려는 사용자 지정 유형의 ARN을 대체합니다.

    다음은 예제입니다.

    aws cloudformation activate-type --public-type-arn <public_extension_ARN> --auto-update-activated
CloudFormation 또는 CDK를 통해 서드 파티 익스텐션을 활성화하려면

  1. AWS::CloudFormation::TypeActivation 유형의 리소스를 배포하고 다음 속성을 지정합니다.

    1. TypeName - AWSQS::EKS::Cluster와 같은 유형의 이름입니다.

    2. MajorVersion - 원하는 익스텐션의 메이저 버전 번호입니다. 최신 버전을 원하는 경우 생략합니다.

    3. AutoUpdate - 게시자가 새 마이너 버전을 릴리스할 때 이 익스텐션을 자동으로 업데이트할지 여부입니다. (주요 버전 업데이트에는 MajorVersion 속성을 명시적으로 변경해야 합니다.)

    4. ExecutionRoleArn - 이 익스텐션을 실행할 IAM 역할의 ARN입니다.

    5. LoggingConfig - 익스텐션에 대한 로깅 구성입니다.

    CfnResource 구문을 사용하여 CDK에서 TypeActivation 리소스를 배포할 수 있습니다. 이는 다음 섹션의 실제 익스텐션에 대해 표시됩니다.

CDK 앱에 AWS CloudFormation 퍼블릭 레지스트리의 리소스 추가

CfnResource 구문을 사용하여 AWS CloudFormation 퍼블릭 레지스트리의 리소스를 애플리케이션에 포함하세요. 이 구문은 CDK의 aws-cdk-lib 모듈에 있습니다.

예를 들어 AWS CDK 애플리케이션에서 사용하려는 MY::S5::UltimateBucket이라는 퍼블릭 리소스가 있다고 가정해 보겠습니다. 이 리소스에는 버킷 이름이라는 속성이 하나 있습니다. 해당 CfnResource 인스턴스는 다음과 같습니다.

예
TypeScript
const ubucket = new CfnResource(this, 'MyUltimateBucket', {
    type: 'MY::S5::UltimateBucket::MODULE',
    properties: {
           BucketName: 'UltimateBucket'
    }
});
JavaScript
const ubucket = new CfnResource(this, 'MyUltimateBucket', {
    type: 'MY::S5::UltimateBucket::MODULE',
    properties: {
           BucketName: 'UltimateBucket'
    }
});
Python
ubucket = CfnResource(self, "MyUltimateBucket",
            type="MY::S5::UltimateBucket::MODULE",
            properties=dict(
                BucketName="UltimateBucket"))
Java
CfnResource.Builder.create(this, "MyUltimateBucket")
	.type("MY::S5::UltimateBucket::MODULE")
	.properties(java.util.Map.of(    // Map.of requires Java 9+
	    "BucketName", "UltimateBucket"))
	.build();
C#
new CfnResource(this, "MyUltimateBucket", new CfnResourceProps
{
    Type = "MY::S5::UltimateBucket::MODULE",
    Properties = new Dictionary<string, object>
    {
        ["BucketName"] = "UltimateBucket"
    }
});