계정에서 서드 파티 프라이빗 후크 등록 및 활성화 - AWS CloudFormation

계정에서 서드 파티 프라이빗 후크 등록 및 활성화

이 주제에서는 사용자와 공유된 서드 파티 프라이빗 후크를 등록한 다음 명령줄을 사용하여 AWS CloudFormation 레지스트리를 통해 이를 활성화하는 단계를 다룹니다. 후크가 활성화되면 해당 후크가 등록된 계정과 리전의 모든 CloudFormation 스택에서 이를 사용할 수 있습니다.

참고

계속하기 전에 후크 프로젝트 패키지의 로컬 복사본이 있는지 확인하세요. 이 패키지에는 등록하려는 후크에 필요한 모든 소스 파일이 들어 있습니다.

사용자와 공유된 프라이빗 후크를 등록하려면 다음을 수행하세요(CFN-CLI).

  1. CloudFormation CLI를 설치했는지 확인합니다. 자세한 내용은 CloudFormation CLI User Guide의 Installing the CloudFormation CLI를 참조하세요.

  2. cfn submit 명령을 사용하여 후크를 등록하고 지정된 리전에서 계정의 기본 후크로 설정합니다. 이 명령은 현재 디렉터리에서 사용자의 AWS 계정으로 후크 패키지를 업로드합니다.

    cfn submit --set-default --region us-west-2

    성공할 경우 다음과 같은 출력이 반환됩니다.

    {‘ProgressStatus’: ‘COMPLETE’}

후크가 등록된 후 해당 구성 데이터를 지정하여 AWS 계정에 대해 후크를 활성화할 수 있습니다.

후크를 활성화하려면 다음을 수행하세요(AWS CLI).

  1. 후크의 ARN을 가져와 저장합니다. AWS Management Console 또는 AWS CLI를 사용하여 후크의 ARN을 가져올 수 있습니다. 자세한 정보는 CloudFormation 레지스트리에서 사용 가능하고 활성화된 확장 프로그램 보기 섹션을 참조하세요.

    export HOOK_TYPE_ARN="arn:aws:cloudformation:us-east-1:123456789012:type/hook/Organization-Service-Hook/"

  2. set-type-configuration 명령을 사용하여 구성 데이터를 지정합니다. --configuration에 대해 전달하는 JSON은 후크의 구성 스키마에 대해 검증되어야 합니다. 모든 스택 작업에 대해 후크를 활성화하려면 HookConfiguration 섹션에서 TargetStacks 속성을 ALL로 설정해야 합니다.

    aws cloudformation set-type-configuration \
  --configuration "{"CloudFormationConfiguration":{"HookConfiguration":{"TargetStacks": "ALL", "FailureMode": "FAIL", "Properties":{}}}}" \
  --type-arn $HOOK_TYPE_ARN --region us-west-2

    HookConfiguration 구성 옵션에 대한 자세한 내용은 AWS CloudFormation Hooks User Guide의 Hook configuration schema를 참조하세요.