CI/CD 파이프라인 디버깅

설정 검증, 경고, 오류, 문제 해결을 설명합니다.

GitLab은 CI/CD 설정을 더 쉽게 디버깅할 수 있도록 여러 도구를 제공합니다. 파이프라인 문제를 해결할 수 없다면 다음에서 도움을 받을 수 있습니다: GitLab 커뮤니티 포럼 GitLab 지원 특정 CI/CD 기능에 문제가 있다면 해당 기능의 관련 문제 해결 섹션을 참조합니다: 캐시 CI/CD job 토큰 컨테이너 레지스트리 Docker 다운스트림 파이프라인 환경 GitLab Runner ID 토큰 Job Job 아티팩트 머지 리퀘스트 파이프라인 , 병합 결과 파이프라인 , 머지 트레인 파이프라인 에디터 변수 YAML includes 키워드 YAML script 키워드 디버깅 기법 # 문법 확인 # 문제의 초기 원인으로 잘못된 문법을 꼽을 수 있습니다. 문법이나 형식에 문제가 있으면 파이프라인에 yaml invalid 배지가 표시되고 실행이 시작되지 않습니다. 파이프라인 에디터로 .gitlab-ci.yml 편집 # 파이프라인 에디터 는 (단일 파일 에디터나 Web IDE 대신) 권장하는 편집 방식이며, 다음을 포함합니다: 허용된 키워드만 사용하도록 보장하는 코드 완성 제안입니다. 자동 문법 강조 표시 및 검증입니다. .gitlab-ci.yml 파일을 그래픽으로 표현하는 CI/CD 설정 시각화 입니다. 로컬에서 .gitlab-ci.yml 편집 # 파이프라인 설정을 로컬에서 편집하고 싶다면 에디터에서 GitLab CI/CD 스키마를 사용해 기본적인 문법 문제를 확인할 수 있습니다. Schemastore를 지원하는 모든 에디터 는 기본적으로 GitLab CI/CD 스키마를 사용합니다. 스키마에 직접 링크해야 한다면 다음 URL을 사용합니다: https://gitlab.com/gitlab-org/gitlab/-/blob/master/app/assets/javascripts/editor/schema/ci.json CI/CD 스키마가 다루는 커스텀 태그의 전체 목록을 확인하려면 스키마의 최신 버전을 확인합니다. CI Lint 도구로 문법 확인 # CI Lint 도구 를 사용하면 CI/CD 설정 스니펫의 문법이 올바른지 확인할 수 있습니다. 전체 .gitlab-ci.yml 파일이나 개별 job 설정을 붙여 넣어 기본 문법을 확인할 수 있습니다. 프로젝트에 .gitlab-ci.yml 파일이 있는 경우, CI Lint 도구를 사용해 전체 파이프라인 생성을 시뮬레이션 할 수도 있습니다. 이 방식은 설정 문법을 더 깊이 검증합니다. 파이프라인 이름 사용 # workflow:name 을 사용하면 모든 파이프라인 유형에 이름을 지정할 수 있으며, 이렇게 하면 파이프라인 목록에서 파이프라인을 더 쉽게 식별할 수 있습니다. 예를 들면 다음과 같습니다: variables: PIPELINE_NAME: "Default pipeline name" workflow: name: '$PIPELINE_NAME' rules: - if: '$CI_PIPELINE_SOURCE == "merge_request_event"' variables: PIPELINE_NAME: "Me