GitLab CI/CD 설정 검증하기

GitLab CI/CD 설정 검증하기

파이프라인을 만들기 전에 설정이 올바른지 미리 확인하고 싶을 때가 많죠. CI Lint 도구를 쓰면 .gitlab-ci.yml 파일이나 다른 샘플 CI/CD 설정의 문법이 유효한지 바로 검증할 수 있어요. 이 도구는 문법·로직 오류를 점검하고, 파이프라인 생성을 시뮬레이션해서 좀 더 복잡한 설정 문제를 찾아낼 수도 있어요.

출처: 문서

본문

  • Tier: Free, Premium, Ultimate
  • Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated

파이프라인 편집기를 사용하면 설정 문법을 자동으로 검증해줘요.

아니면 CI/CD 설정을 다음 도구로도 검증할 수 있어요.

CI/CD 문법 확인하기

CI Lint 도구는 includes 키워드로 추가한 설정을 포함해 GitLab CI/CD 설정의 문법을 점검해요.

CI Lint 도구로 CI/CD 설정을 검증하는 방법은 이래요.

  1. 상단 바에서 Search or go to를 선택하고 프로젝트를 찾아요.
  2. 왼쪽 사이드바에서 Build > Pipeline editor를 선택해요.
  3. Validate 탭을 선택해요.
  4. Lint CI/CD sample을 선택해요.
  5. 검증하려는 CI/CD 설정을 텍스트 상자에 붙여넣어요.
  6. Validate를 선택해요.

파이프라인 시뮬레이션하기

GitLab CI/CD 파이프라인의 생성을 시뮬레이션해서 더 복잡한 문제를 찾아낼 수 있어요. 특히 needs나 rules 설정 문제를 잡아내는 데 유용해요. 시뮬레이션은 기본 브랜치에서 Git push 이벤트로 실행돼요.

사전 요건:

  • 시뮬레이션으로 검증하려면 해당 브랜치에서 파이프라인을 만들 권한이 있어야 해요.

파이프라인을 시뮬레이션하는 방법은 이래요.

  1. 상단 바에서 Search or go to를 선택하고 프로젝트를 찾아요.
  2. 왼쪽 사이드바에서 Build > Pipeline editor를 선택해요.
  3. Validate 탭을 선택해요.
  4. Lint CI/CD sample을 선택해요.
  5. 검증하려는 CI/CD 설정을 텍스트 상자에 붙여넣어요.
  6. Simulate pipeline creation for the default branch를 선택해요.
  7. Validate를 선택해요.

더 알아보기

검증 단계를 파이프라인에 매번 넣기보다, 파이프라인 편집기에서 자동으로 문법을 확인하면 훨씬 빠르게 오타를 잡을 수 있어요. 좀 더 고급 설정 검증이 필요하다면 includes나 rules 문법부터 익혀두면 시뮬레이션이 훨씬 유용해져요.