구성 쿼리 도구: 완전 가이드
브라우저 안에서 YAML에 자주 쓰는 yq 스타일 쿼리를 실행해 설정, 매니페스트, 배포 조각의 필드 경로, 배열 항목, 변환 결과를 업로드 없이 확인합니다.
이 도구로 할 수 있는 일
.service.image, .items[0].name, 배열 와일드카드 같은 일반적인 경로식을 YAML 입력에 실행합니다.
keys, length, to_json, to_yaml 같은 실용적인 작업을 지원해 YAML과 JSON 보기 사이를 빠르게 전환합니다.
파싱 오류나 지원하지 않는 구문을 출력 옆에 표시하여, 이 페이지가 전체 yq 런타임이 아닌 가벼운 로컬 부분 집합임을 분명히 합니다.
대표 사용 사례
- Kubernetes, Docker Compose, CI 설정에서 특정 중첩 값을 빠르게 추출합니다.
- YAML 오버레이를 수정하기 전에 경로식이 예상 노드에 맞는지 확인합니다.
- YAML 조각을 JSON으로 바꾸어 디버그 요청, 문서, 테스트 픽스처에 붙여 넣습니다.
입력 예시
YAML 설정
service:
image: nginx:alpine
ports:
- 8080:80출력 예시
JSON 출력
{"image":"nginx:alpine","ports":["8080:80"]}자주 발생하는 오류와 해결 방법
전체 yq에서만 가능한 복잡한 구문을 사용함
경로 선택, 인덱스, 와일드카드, keys, length, to_json, to_yaml처럼 지원되는 작업으로 나누어 확인하세요.
YAML 들여쓰기 또는 목록 형식이 잘못됨
들여쓰기, 콜론, 배열 하이픈을 고친 뒤 다시 실행하세요.
쿼리 경로가 어떤 노드와도 일치하지 않음
먼저 . 또는 keys로 최상위 구조를 확인한 뒤 단계적으로 경로를 좁히세요.
보안 및 개인정보 참고 사항
공통 개인정보 용어, 로컬 처리 모델, 외부 요청 라벨, DevTools 검증 흐름은 신뢰 센터에서 확인하세요.
- YAML 파싱과 쿼리는 모두 브라우저 안에서 실행됩니다.
- 티켓이나 채팅에 출력을 복사하기 전에 키, 토큰, 내부 호스트 이름을 제거하세요.
- 프로덕션 설정에서 가져온 입력은 먼저 마스킹한 최소 조각으로 확인하는 것이 좋습니다.
단계별 진행 방식
- 최소 YAML 조각을 붙여 넣고 먼저 . 로 전체 구조를 확인합니다.
- 필드 경로, 배열 인덱스, 와일드카드를 단계적으로 입력해 결과를 확인합니다.
- 결과를 공유해야 할 때만 출력을 복사하고, 먼저 민감 값을 마스킹합니다.
결과 공유 전 품질 체크리스트
- 쿼리 식이 이 도구가 지원하는 부분 집합에만 의존하는지 확인합니다.
- 들여쓰기 오류로 잘못된 노드에 맞지 않았는지 출력과 설정 계층을 대조합니다.
- 공유 전에 토큰, 비밀번호, 내부 도메인, 고객 데이터가 남아 있지 않은지 확인합니다.
활용 팁
로컬 사전 점검과 조사에 적합합니다. 공식 자동화 스크립트는 팀 표준 yq 버전으로 회귀 검증하세요.
자주 묻는 질문
완전한 yq인가요?
아닙니다. 자주 쓰는 로컬 조회와 형식 변환을 다루는 부분 집합이며, 복잡한 필터는 공식 yq로 검증해야 합니다.
여러 문서 YAML을 지원하나요?
일반적인 YAML 내용은 파싱합니다. 복잡한 여러 문서 흐름은 중요한 조각으로 나누어 확인하는 것이 좋습니다.
데이터가 업로드되나요?
아닙니다. 쿼리와 변환은 현재 브라우저 세션 안에서 끝납니다.