YAML 입력

유효성 검사 결과

YAML 유효성 검사기란?

YAML(YAML Ain't Markup Language)은 Kubernetes, Docker Compose, GitHub Actions 등 많은 도구의 설정 파일에 사용됩니다. JSON과 달리 YAML은 구조에 들여쓰기를 사용하며 괄호가 필요 없습니다. 읽기 쉽지만 취약하기도 합니다: 잘못된 공백, 공백 대신 탭, 일관성 없는 중첩은 파싱 오류를 일으킵니다. YAML 1.2 사양이 규칙을 정의합니다.

YAML 유효성 검사기는 문서가 유효한지 확인합니다. YAML을 파싱하고 행과 위치와 함께 구문 오류를 보고합니다. 이 도구는 브라우저에서만 실행됩니다. 서버로 아무것도 전송되지 않으므로 프로덕션 설정, 시크릿 또는 민감한 데이터에 안전하게 사용할 수 있습니다.

YAML 유효성 검사 예시

유효한 YAML은 일관된 들여쓰기를 사용합니다. 유효하지 않은 YAML은 잘못된 중첩이 있는 경우가 많습니다. 통신사 테마 예시:

예시 1: 유효한 YAML

유효

예시 2: 유효하지 않은 YAML (잘못된 들여쓰기)

유효하지 않음

유효성 검사기에서 오류를 보고합니다. 위의 유효한 샘플 또는 유효하지 않은 샘플을 클릭하여 편집기에 예시를 불러오세요.

이 도구 사용 방법

YAML 붙여넣기 또는 업로드

YAML을 복사하여 왼쪽 편집기에 붙여넣으세요. 업로드를 클릭하여 컴퓨터에서 .yaml 또는 .yml 파일을 불러올 수도 있습니다. 올바른 YAML은 유효한 샘플을, 오류가 어떻게 보이는지 보려면 유효하지 않은 샘플을 사용하세요.

유효성 검사 결과 확인

오른쪽 패널에 유효 또는 유효하지 않음이 표시됩니다. 유효하지 않은 경우 행과 위치와 함께 오류가 표시됩니다. 일반적인 문제: 잘못된 들여쓰기, 공백 대신 탭, 일관성 없는 중첩, 따옴표 없는 특수 문자, 잘못된 여러 줄 문자열.

수정 및 재검증

입력에서 오류를 수정하고 다시 검증하세요. 포맷과 들여쓰기를 위해서는 YAML 포매터를, JSON 또는 다른 형식으로 변환하려면 YAML을 JSON으로 또는 YAML을 XML로를 사용하세요.

YAML 유효성 검사가 유용한 경우

대부분의 개발자는 Kubernetes 매니페스트, Docker Compose 파일 또는 GitHub Actions와 같은 CI/CD 설정 작업 시 유효성 검사가 필요합니다. 공백이나 탭 하나가 추가되면 배포가 실패할 수 있습니다. 여기서 실행하면 푸시하기 전에 구문 오류를 발견할 수 있습니다.

<code>application.yml</code>(Spring Boot) 또는 <code>.gitlab-ci.yml</code>과 같은 설정 파일은 깊은 중첩을 가지는 경우가 많습니다. 유효성 검사기는 들여쓰기가 잘못된 정확한 행을 찾는 데 도움이 됩니다. YAML을 JSON 또는 XML로 변환하려면 YAML을 JSON으로 또는 YAML을 XML로를 사용하세요.

좋은 유효성 검사 없는 편집기에서 YAML을 편집하는 경우 이 도구가 즉각적인 피드백을 제공합니다. 팀원들과 설정을 공유하기 전에도 유용합니다—먼저 검증하면 모든 사람이 파싱 가능한 파일을 받을 수 있습니다.

자주 묻는 질문

YAML이 유효하지 않게 되는 원인은?

잘못된 들여쓰기(공백 대신 탭), 일관성 없는 중첩, 값에서 따옴표 없는 특수 문자(: 또는 #), 잘못된 여러 줄 문자열 또는 중복 키. 유효성 검사기에서 행과 위치와 함께 문제를 표시합니다.

탭 vs 공백?

YAML은 들여쓰기에 공백을 요구합니다. 탭은 허용되지 않습니다. 탭과 공백을 혼용하면 오류가 발생합니다. 파일 전체에서 2칸 또는 4칸을 일관되게 사용하세요.

내 데이터가 어딘가로 전송되나요?

아니요. 유효성 검사는 JavaScript를 사용하여 브라우저에서만 실행됩니다. 어떠한 데이터도 서버로 전송되지 않습니다. 도구 사용 중 브라우저의 네트워크 탭을 열어 확인할 수 있습니다.

YAML 앵커와 별칭은 어떻게 처리되나요?

앵커(&name)와 별칭(*name)이 지원됩니다. 유효성 검사기에서 올바르게 사용되었는지 확인합니다. 순환 참조가 있으면 유효성 검사가 실패합니다.

스키마를 확인하나요, 아니면 구문만 확인하나요?

이 도구는 구문만 유효성 검사합니다—YAML이 올바르게 형성되고 파싱 가능한지 여부만 확인합니다. JSON 스키마나 Kubernetes 스키마에 대한 유효성 검사는 하지 않습니다. 구조 유효성 검사를 위해서는 JSON으로 변환한 후 JSON 스키마 생성기를 사용하세요.

YAML 유효성 검사기

YAML 입력

유효성 검사 결과