01
입력 형식을 선택
자동 인식이 애매하면 JSON 또는 YAML로 고정하세요. 선택한 형식의 파싱에 실패해도 다른 형식으로 몰래 바꾸지 않습니다.
클라우드 도구
CloudFormation 템플릿 검증— 배포 전에 범위를 확인하세요
JSON 또는 YAML 템플릿 한 개를 넣고 진단과 같은 형식의 정리 결과를 확인하세요.
CloudFormation 템플릿 검증
템플릿 입력
진단과 미리보기
검사 범위 안에서는 문제가 없습니다.
브라우저에서만 처리하며 AWS에 보내지 않습니다.
템플릿을 입력하거나 예제를 불러오세요.
입력 한도: 300000자.
YAML 문법이 맞아도 !Ref가 없는 매개변수를 가리키거나 Resources의 위치가 틀리면 배포에 실패할 수 있습니다. CloudFormation 템플릿 검증은 두 문제를 구분해 보여 줍니다.
CloudFormation 템플릿 형식 오류를 먼저 고친 뒤 검사 범위를 읽으세요. 이 페이지의 CloudFormation 템플릿 유효성 검사는 AWS 서비스의 최종 판정을 대신하지 않습니다.
CloudFormation 템플릿 검증을 쓰는 이유
구문과 참조를 따로 확인
파서 오류와 선언되지 않은 !Ref는 해결 방법이 다릅니다. CloudFormation 템플릿 검증은 행과 경로를 붙여 문제의 위치를 보여 줍니다.
미검사 범위를 함께 표시
S3·SQS·SNS의 최상위 속성만 기본 유형을 확인합니다. 알 수 없는 리소스와 동적 값은 미검사로 남겨 AWS 검증이 필요한 지점을 보여 줍니다.
형식과 버전, 검사 범위를 읽는 순서
02
버전과 범위를 확인
버전이 없으면 2010-09-09로 봅니다. 지원 리소스 수와 미검사 수를 함께 확인해야 결과를 올바르게 해석할 수 있습니다.
03
최신 결과만 내보내기
원본이나 들여쓰기를 바꾸면 예전 결과의 복사와 다운로드가 비활성화됩니다. 다시 검사한 뒤 진단 JSON 또는 같은 형식의 템플릿을 저장하세요.
구문을 넘어 템플릿 구조까지
JSON·YAML 구문
한 개의 템플릿을 파싱하고 오류 행과 열을 표시합니다. !Ref와 !Sub 축약 태그는 정리된 YAML에도 유지됩니다.
로컬 참조 확인
Ref, Fn::GetAtt 및 단순한 Fn::Sub 이름을 현재 템플릿의 매개변수, 리소스, 의사 매개변수와 비교합니다.
제한된 리소스 유형 검사
AWS::S3::Bucket, AWS::SQS::Queue, AWS::SNS::Topic의 최상위 속성 이름과 기본 유형을 확인합니다. 중첩된 값은 판단하지 않습니다.
로컬 검사로 알 수 있는 범위
- 템플릿 하나만 검사
- JSON 문서나 YAML 문서 한 개를 받습니다. Resources 누락과 잘못된 논리 ID는 보고하지만 중첩 스택을 따라가지는 않습니다.
- 일부 스키마만 포함
- 알 수 없는 리소스와 속성은 미검사로 표시합니다. CloudFormation 템플릿 검증 통과가 모든 AWS 규칙 통과를 뜻하지는 않습니다. 보고서에서 어떤 리소스가 검사 범위 밖인지 먼저 확인하세요.
- 동적 값은 계산하지 않음
- Ref 이름은 확인하지만 조건과 매크로, 계정 안의 값은 평가하지 않습니다. 배포 시 값을 추측해 잘못된 오류를 내지 않습니다.
- AWS 작업 없음
- 자격 증명을 받지 않고 Region을 조회하거나 스택을 만들지 않습니다. 권한과 할당량은 실제 환경에서 확인하세요.
CloudFormation 템플릿 검증 질문
CloudFormation에서 템플릿 검증 또는 템플릿 형식 오류를 해결하려면 어떻게 해야 합니까?
먼저 표시된 구문 오류를 고치고 섹션과 참조 진단을 확인하세요. 이 검사는 문법과 제한된 CloudFormation 구조를 구분합니다.
YAML not well-formed 오류가 나는 이유는 무엇입니까?
들여쓰기, 콜론, 축약 태그 주변을 살펴보세요. 파싱에 실패한 문서에는 정리된 파일을 내보내지 않습니다.
해결되지 않은 리소스 종속성을 어떻게 수정합니까?
Ref, GetAtt 또는 Sub가 가리키는 이름이 현재 템플릿에 없습니다. 매개변수나 리소스 선언을 확인하세요.
잘못된 템플릿 속성 오류는 왜 발생합니까?
Resources 안의 위치와 속성 이름을 확인하세요. 미등록 속성은 미검사 경고일 뿐 AWS에서 무효라고 단정하지 않습니다.
매개변수 참조가 없으면 어떻게 확인합니까?
아니요. 이 페이지의 로컬 규칙만 확인합니다. 계정, 리전, 서비스 조건은 AWS에서 다시 검증해야 합니다.
답을 찾지 못했나요?