파이프라인 편집기
파이프라인 편집기는 귀하의 리포지터리 루트 디렉터리에 있는 .gitlab-ci.yml 파일에서 GitLab CI/CD 구성을 편집하는 주요 장소입니다. 편집기에 액세스하려면 빌드 > 파이프라인 편집기로 이동하세요.
파이프라인 편집기 페이지에서 다음을 할 수 있습니다:
- 작업할 브랜치 선택하기.
- 파일을 편집하는 동안 구성 구문을 검증합니다.
- 추가된
include키워드로 구성을 검증하는 깊은 린트 수행하기. -
include키워드로 추가된 모든 CI/CD 구성 디렉터리 보기. - 현재 구성의 시각화 보기.
-
include로 추가된 구성을 포함한 전체 구성 보기. - 변경 사항을 특정 브랜치에 커밋하기.
CI 구성 검증
파이프라인 구성을 편집하는 동안 지속적으로 GitLab CI/CD 파이프라인 스키마에 대해 검증됩니다. CI YAML 구성의 구문을 확인하고 몇 가지 기본적인 논리적 유효성을 실행합니다.
이 검증의 결과는 편집기 페이지 상단에 표시됩니다. 구성이 유효하지 않은 경우 문제를 해결하는 데 도움이 되는 팁이 표시됩니다:
CI 구성 린트
변경 사항을 커밋하기 전에 GitLab CI/CD 구성의 유효성을 테스트하려면 CI 린트 도구를 사용할 수 있습니다:
- 좌측 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
- 빌드 > 파이프라인 편집기를 선택합니다.
- 린트 탭을 선택합니다.
이 도구는 구문 및 논리적 오류를 확인하지만 편집기의 자동 검증과는 더 자세히 설명합니다.
결과는 실시간으로 업데이트됩니다. 구성에 대한 모든 변경 사항은 CI 린트에 반영됩니다. 기존 CI 린트 도구와 동일한 결과를 표시합니다.
CI/CD 파이프라인 시뮬레이션
- GitLab 15.3에서 도입됨.
파이프라인 구문 및 논리 문제를 찾으려면 검증 탭에서 GitLab CI/CD 파이프라인 생성을 시뮬레이션할 수 있습니다. 파이프라인 시뮬레이션을 사용하여 rules 및 needs 작업 의존성과 같은 문제를 찾는 데 도움이 되며 CI 린트 도구의 시뮬레이션과 유사합니다.
포함된 CI/CD 구성 보기
- GitLab 15.0에서 도입됨 (피처 플래그는 디폴트로 비활성화됨) 및 pipeline_editor_file_tree라는 피처 플래그로 제공됨.
- GitLab 15.1에서 피처 플래그 제거됨.
파이프라인 편집기에서 include 키워드로 추가된 구성을 검토할 수 있습니다. 우측 상단에서 파일 트리 ()를 선택하여 포함된 모든 구성 파일 디렉터리을 확인할 수 있습니다. 선택한 파일은 검토를 위해 새 탭에서 엽니다.
CI 구성 시각화
프로젝트에서 .gitlab-ci.yml 구성을 시각화하려면 빌드 > 파이프라인 편집기로 이동한 다음 시각화 탭을 선택하세요. 이 시각화는 모든 단계와 작업을 보여줍니다. needs 관계가 있는 경우 작업 간을 연결하는 선으로 표시되어 실행의 계층 구조를 보여줍니다.
작업을 가리키면 해당 작업의 needs 관계가 강조 표시됩니다:
마우스를 올리면 needs 관계가 강조된 작업에 대한 세부 정보가 표시됩니다:
구성에 needs 관계가 없는 경우 이전 단계가 성공적으로 완료된 후에만 각 작업이 실행되므로 선이 그려지지 않습니다.
전체 구성 보기
- GitLab 16.0에서 보기 Merge한 YAML 탭을 전체 구성으로 이름 변경.
편집기의 전체 구성 탭으로 이동하여 모든 Merge된 CI/CD 구성을 하나로 펼쳐볼 수 있습니다. 이 탭은 다음을 표시하는 확장된 구성을 표시합니다:
-
include로 가져온 구성이 뷰로 복사됨. -
extends를 사용하는 작업은 작업에 Merge된 확장 구성으로 표시됨. - YAML 앵커가 연결된 구성으로 대체됨.
-
YAML
!reference태그도 연결된 구성으로 대체됨.
!reference 태그를 사용하면 확장된 보기에서 여러 개의 하이픈 (-)으로 시작하는 중첩 구성이 표시됩니다. 이 동작은 예상된 동작이며 추가되는 추가적인 하이픈은 작업 실행에 영향을 미치지 않습니다. 예를 들어 다음 구성과 전체 확장 버전은 모두 유효합니다:
-
.gitlab-ci.yml파일:.python-req: script: - pip install pyflakes .rule-01: rules: - if: $CI_MERGE_REQUEST_SOURCE_BRANCH_NAME =~ /^feature/ when: manual allow_failure: true - if: $CI_MERGE_REQUEST_SOURCE_BRANCH_NAME .rule-02: rules: - if: $CI_COMMIT_BRANCH == "main" when: manual allow_failure: true lint-python: image: python:latest script: - !reference [.python-req, script] - pyflakes python/ rules: - !reference [.rule-01, rules] - !reference [.rule-02, rules] -
전체 구성 탭에서 확장된 구성:
".python-req": script: - pip install pyflakes ".rule-01": rules: - if: "$CI_MERGE_REQUEST_SOURCE_BRANCH_NAME =~ /^feature/" when: manual allow_failure: true - if: "$CI_MERGE_REQUEST_SOURCE_BRANCH_NAME" ".rule-02": rules: - if: $CI_COMMIT_BRANCH == "main" when: manual allow_failure: true lint-python: image: python:latest script: - - pip install pyflakes # <- 추가된 하이픈이 작업 실행에 영향을 미치지 않습니다. - pyflakes python/ rules: - - if: "$CI_MERGE_REQUEST_SOURCE_BRANCH_NAME =~ /^feature/" # <- 추가된 하이픈이 작업 실행에 영향을 미치지 않습니다. - when: manual allow_failure: true - if: "$CI_MERGE_REQUEST_SOURCE_BRANCH_NAME" # <- 추가된 하이픈이 없지만 이전 규칙과 정렬됨 - - if: $CI_COMMIT_BRANCH == "main" # <- 추가된 하이픈이 작업 실행에 영향을 미치지 않습니다. - when: manual allow_failure: true
CI 구성 변경 사항 커밋
에디터의 각 탭 하단에 커밋 양식이 나타나므로 언제든지 변경 사항을 커밋할 수 있습니다.
변경 사항에 만족하면 설명적인 커밋 메시지를 추가하고 브랜치를 입력합니다. 브랜치 필드는 프로젝트의 기본 브랜치로 기본 설정됩니다.
새로운 브랜치 이름을 입력하면 이러한 변경으로 새 Merge Request 시작 확인란이 나타납니다. 변경 사항을 커밋한 후 새로운 Merge Request을 시작하려면 확인란을 선택합니다.
문제 해결
구성 유효성 검사 현재 사용 불가 메시지
이 메시지는 파이프라인 편집기에서 구문 유효성을 확인하는 문제로 인해 발생합니다. 다음과 같은 경우에 발생할 수 있습니다.
- GitLab이 구문 유효성을 확인하는 서비스와 통신할 수 없어 다음 섹션의 정보가 올바르게 표시되지 않는 경우:
- 편집 탭에서 구문 상태(유효 또는 무효).
- 시각화 탭.
- 린트 탭.
- 전체 구성 탭.
여전히 CI/CD 구성을 작업하고 문제없이 변경 사항을 커밋할 수 있습니다. 서비스가 다시 사용 가능해지면 즉시 구문 유효성이 표시됩니다.
-
include을 사용하지만 포함된 구성 파일이 루프를 생성하는 경우. 예를 들어.gitlab-ci.yml에file1.yml을 포함하고, 이 파일이file2.yml을 포함하고, 이 파일이file1.yml을 포함하여file1.yml과file2.yml사이에 루프가 생성됩니다.루프를 제거하고 문제를 해결하기 위해
include라인 중 하나를 제거합니다.
도움말