쓰기 전용 속성 해결 - AWS CloudFormation
상호 배타적 속성상호 배타적 유형Array 속성선택적 속성경고 및 다음 단계

쓰기 전용 속성 해결

CloudFormation IaC 생성기를 사용하면 계정에 프로비저닝된 리소스 중 CloudFormation에서 아직 관리하지 않는 리소스를 사용하여 템플릿을 생성할 수 있습니다. 하지만 특정 리소스 속성은 쓰기 전용으로 지정되므로 데이터베이스 암호와 같이 CloudFormation에서 쓸 수 있지만 읽을 수는 없습니다.

기존 리소스에서 CloudFormation 템플릿을 생성할 때 쓰기 전용 속성은 문제를 야기합니다. 대부분의 경우 CloudFormation은 이러한 속성을 생성된 템플릿의 파라미터로 변환합니다. 이렇게 하면 가져오기 작업 중에 속성을 파라미터값으로 입력할 수 있습니다. 하지만 이러한 변환이 불가능한 시나리오도 있으며, CloudFormation은 이러한 경우를 다르게 처리합니다.

상호 배타적 속성

몇몇 리소스에는 상호 배타적인 속성 세트가 여러 개 있으며, 그중 일부는 쓰기 전용입니다. 이러한 경우 IaC 생성기는 생성 도중 리소스에 어떤 배타적인 속성 세트가 적용되었는지 확인할 수 없습니다. 예를 들어 AWS::Lambda::Function에 대한 코드를

  • Code/S3Bucket, Code/S3Key, 선택적으로 Code/S3ObjectVersion 속성 세트를 사용하여 제공할 수 있습니다.

  • Code/ImageUri

  • Code/ZipFile

해당 속성은 모두 쓰기 전용입니다. IaC 생성기는 독점적인 속성 세트 중에서 하나를 선택하여 생성된 템플릿에 추가합니다. 각 쓰기 전용 속성에 대해 파라미터가 추가됩니다. 파라미터 이름에는 OneOf가 포함되며 파라미터 설명에 따르면 해당 속성을 다른 독점적인 속성으로 바꿀 수 있습니다. IaC 생성기는 포함된 속성에 대해 MUTUALLY_EXCLUSIVE_PROPERTIES의 경고 유형을 설정합니다.

상호 배타적 유형

경우에 따라 쓰기 전용 속성이 여러 데이터 유형일 수 있습니다. 예를 들어 AWS::ApiGateway::RestApi의 Body 속성은 object 또는 string가 될 수 있습니다. 이러한 경우 IaC 생성기는 string 유형을 사용하여 생성된 템플릿에 속성을 포함하고 MUTUALLY_EXCLUSIVE_TYPES의 경고 유형을 설정합니다.

Array 속성

쓰기 전용 속성의 유형이 array인 경우 파라미터는 스칼라 값만 사용할 수 있으므로 IaC 생성기는 생성된 템플릿에 해당 속성을 포함할 수 없습니다. 이 경우 템플릿에서 해당 속성이 생략되고 경고 유형이 UNSUPPORTED_PROPERTIES로 설정됩니다.

선택적 속성

선택적 쓰기 전용 속성의 경우 IaC 생성기는 리소스를 설정할 때 속성이 사용되었는지 감지할 수 없습니다. 이 경우 생성된 템플릿에서 해당 속성이 생략되고 경고 유형이 UNSUPPORTED_PROPERTIES로 설정됩니다.

경고 및 다음 단계

어떤 속성이 쓰기 전용인지 판단하려면 IaC 생성기 콘솔에서 반환되는 경고를 살펴보아야 합니다. AWS 리소스 및 속성 유형 참조 설명서에는 속성이 쓰기 전용인지 또는 여러 유형을 지원하는지 여부가 표시되어 있지 않습니다.

또는 리소스 공급자 스키마에서 어떤 속성이 쓰기 전용인지 확인할 수 있습니다. 리소스 공급자 스키마를 다운로드하려면 CloudFormation 리소스 공급자 스키마를 참조하세요. 자세한 내용은 CloudFormation 명령줄 인터페이스 사용 설명서의 리소스 공급자 스키마를 참조하세요.

쓰기 전용 속성 문제를 해결하는 방법

  1. CloudFormation 콘솔의 IaC 생성기 페이지를 엽니다.

  2. 화면 상단의 탐색 모음에서 템플릿에 대한 AWS 리전을 선택합니다.

  3. 템플릿 탭을 선택한 다음에 생성한 템플릿의 이름을 선택합니다.

  4. 템플릿 정의 탭에서는 생성된 템플릿에 쓰기 전용 속성이 있는 리소스가 포함되어 있는 경우 IaC 생성기 콘솔에 문제 유형에 대한 요약과 함께 경고가 표시됩니다. 예:

    생성된 템플릿의 쓰기 전용 속성에 대한 IaC 생성기 콘솔 경고

  5. 자세히 알아보려면 경고 세부 정보 보기를 선택합니다. 쓰기 전용 속성이 있는 리소스는 생성된 템플릿과 리소스 유형에 사용된 논리적 ID에 따라 식별됩니다.

    경고 목록을 사용하여 쓰기 전용 속성이 있는 리소스를 식별하고 생성된 템플릿에 변경이 필요한 경우 어떤 변경이 필요한지 판단하기 위해 각 리소스를 살펴봅니다.

    생성된 템플릿의 쓰기 전용 속성에 대한 IaC 생성기 콘솔의 자세한 경고

  6. 템플릿을 업데이트하여 쓰기 전용 속성 문제를 해결해야 한다면 다음과 같은 단계를 수행합니다.

    1. 다운로드를 선택하여 템플릿 사본을 다운로드합니다.

    2. 템플릿을 편집합니다.

    3. 변경이 완료되면 편집한 템플릿 가져오기 버튼을 선택하여 가져오기 프로세스를 계속할 수 있습니다.