CI/CD 도구

GitLab CI 편집기 — 푸시 전에 규칙의 근거 확인

.gitlab-ci.yml과 시험할 컨텍스트를 넣어 작업, 변수 참조, 로컬 include를 살펴보세요.

CI YAML

결과

분석은 브라우저에서만 실행되며 GitLab에 전송되지 않습니다.

옵션

들여쓰기

모의 컨텍스트

파이프라인 소스커밋 브랜치기본 브랜치

추가 변수한 줄에 NAME=value 하나씩 입력하세요. 로컬 미리보기에만 사용됩니다.

로컬 include 파일

여기 제공한 파일만 해석합니다. 원격 include는 미확정입니다.

아직 분석하지 않았습니다. 분석을 실행하세요.

YAML 문법이 맞아도 stage 이름이나 rules 조건 때문에 예상한 작업이 빠질 수 있습니다. GitLab CI 편집기는 커밋 전에 확인 가능한 로컬 근거를 보여 줍니다.

이 GitLab CI YAML 검증은 지원 범위가 정해진 정적 검사입니다. 실제 프로젝트의 최종 결과는 GitLab CI Lint에서 확인해야 합니다.

GitLab CI 편집기가 유용한 이유

건너뜀과 미확정을 분리해서 보여 줍니다.

규칙 판정에 근거 표시

GitLab CI 편집기는 입력한 변수로 각 작업을 포함, 건너뜀, 미확정으로 표시합니다. diff가 없는 rules:changes는 거짓으로 간주하지 않습니다.

YAML 작업 규칙에서 포함, 건너뜀, 미확정 상태로 이어지는 선을 보여 주는 그림.

제공한 파일만 포함

경로와 내용을 직접 추가한 include:local만 분석합니다. 없는 파일을 빈 설정으로 처리하지 않고 해석할 수 없다고 표시합니다.

두 YAML 파일이 로컬 경로로 연결되고 빠진 파일 쪽 연결은 열린 채로 남는 그림.

결과를 믿기 전에 확인할 세 가지

예시 브랜치 변경

push와 main은 데모 값입니다. 병합 요청을 살피려면 파이프라인 소스와 브랜치를 먼저 바꾸세요.

로컬 파일 직접 제공

include:local 경로와 YAML 내용을 함께 넣어야 합니다. 브라우저는 저장소를 자동으로 읽지 않습니다.

결과 종류 구분

YAML 파싱, 구조 진단, rules 미리보기는 서로 다른 판단입니다. 옵션을 바꾸면 결과가 오래된 상태가 되어 다시 분석해야 합니다.

YAML을 읽는 네 가지 방법

원본을 보존하는 포맷

.gitlab-ci.yml 포맷 결과는 별도 출력에 나타납니다. 보존 가능한 주석은 유지하고 입력은 그대로 둡니다.

지원되는 구조 검사

GitLab CI YAML 검증은 stage, 작업 실행 키, rules 목록 형태, 로컬 needs 대상을 확인합니다.

규칙 결과 미리보기

GitLab CI rules 테스트는 지원되는 if 조건을 순서대로 평가하며 파일 변화 조건은 미확정으로 남깁니다. 지원하는 if 문법은 변수 존재, ==, !=, &&, ||, 괄호입니다. 정규식은 미확정으로 표시합니다.

변수 참조 확인

GitLab CI 변수 확인에서 정의와 $NAME 참조를 나란히 봅니다. 프로젝트 설정 변수는 읽을 수 없습니다.

브라우저 분석의 한계

서버 시뮬레이션 아님: GitLab CI 편집기는 파이프라인을 만들거나 Runner를 실행하지 않습니다. 실제 판정은 프로젝트 CI Lint에서 확인하세요.
파일 정보가 없으면 미확정: rules:changes와 rules:exists에는 저장소 파일이나 diff가 필요합니다. 정보가 없다고 false로 판정하지 않습니다.
로컬 include만 해석: 일치하는 경로와 내용을 제공한 include:local만 처리합니다. project, remote, template, component는 가져오지 않습니다.
변수 출처는 더 많음: 현재 YAML에 없는 변수도 프로젝트, 그룹, 인스턴스에서 제공될 수 있습니다.
원본을 자동 수정하지 않음: 포맷 결과는 출력에만 표시됩니다. 복사하거나 다운로드하기 전에 원본과 비교하세요.

GitLab CI 편집기 자주 묻는 질문

.gitlab-ci.yml을 푸시 전에 검증할 수 있나요?

GitLab CI 편집기로 지원되는 구문과 구조를 먼저 확인한 뒤 프로젝트 CI Lint에서 최종 검증하세요.

rules가 예상대로 적용되지 않는 이유는 무엇인가요?

지원되는 if 조건만 첫 일치 순서로 미리 봅니다. 서버의 브랜치, needs, 저장소 상태는 이 페이지에서 알 수 없습니다.

include:local 파일을 찾지 못할 때 어떻게 확인하나요?

정확한 include:local 경로와 파일 내용을 추가하세요. 제공하지 않은 파일은 해석할 수 없으며 자동 다운로드하지 않습니다.

작업 변수를 rules 조건에 사용할 수 없는 이유는 무엇인가요?

작업 수준 변수가 파이프라인 생성 시점의 rules에 제공되지 않을 수 있습니다. GitLab의 변수 범위를 확인하세요.

CI 설정이 참조하는 변수를 어떻게 찾나요?

분석 후 변수 탭에서 $NAME 참조와 로컬 정의를 확인하세요. 로컬에 없다는 표시는 실행 시 값이 없다는 뜻이 아닙니다.

이 도구가 잘못 판단하는 workflow를 발견했나요?

GitLab CI 편집기로 초안 점검

GitLab CI 편집기에서 미확정 조건을 확인하고 실제 GitLab 프로젝트에서 최종 설정을 검증하세요.

작업대로 돌아가기 CI/CD 도구 보기

GitLab CI 편집기 — 푸시 전에 규칙의 근거 확인