외부 저장소용 GitLab CI/CD
GitLab 10.6에서 소개되었습니다.
GitHub, Bitbucket Cloud 또는 다른 Git 서버와 함께 사용할 수 있으며, 전체 프로젝트를 GitLab으로 옮기지 않고도 외부 저장소를 연결하여 GitLab CI/CD의 이점을 누릴 수 있습니다.
외부 저장소를 연결하면 저장소 미러링이 설정되고 이슈, 병합 요청, 위키 및 스니펫이 비활성화된 가벼운 프로젝트가 생성됩니다. 나중에 다시 활성화할 수도 있습니다.
외부 저장소에 연결
외부 저장소에 연결하려면:
- 왼쪽 사이드바 상단에서 새로 만들기 ()와 새 프로젝트/저장소를 선택합니다.
- 외부 저장소용 CI/CD 실행을 선택합니다.
- GitHub 또는 URL별 저장소를 선택합니다.
- 필드를 완성합니다.
외부 저장소용 CI/CD 실행 옵션이 사용할 수 없는 경우 GitLab 인스턴스에 가져오기 소스가 구성되어 있지 않을 수 있습니다. 인스턴스의 관리자에게 가져오기 소스 구성을 확인하라는 요청을 합니다. (가져오기 소스 구성)
외부 풀 리퀘스트용 파이프라인
- GitLab 12.3에서 소개되었습니다.
GitHub의 외부 저장소와 함께 GitLab CI/CD를 사용할 때 풀 리퀘스트의 컨텍스트에서 파이프라인을 실행할 수 있습니다.
GitHub의 원격 브랜치에 변경 사항을 푸시하면 GitLab CI/CD가 브랜치를 위해 파이프라인을 실행할 수 있습니다. 그러나 해당 브랜치에 대해 풀 리퀘스트를 열거나 업데이트할 때:
- 추가 작업을 실행할 수 있습니다.
- 특정 작업을 실행하지 않을 수 있습니다.
예를 들어:
always-run:
script: echo '항상 실행되어야 함'
on-pull-requests:
script: echo '풀 리퀘스트에서 실행되어야 함'
only:
- external_pull_requests
except-pull-requests:
script: echo '풀 리퀘스트에서 실행되지 않아야 함'
except:
- external_pull_requests
작동 방식
GitHub에서 저장소가 가져오면 GitLab은 push
및 pull_request
이벤트에 대한 웹훅을 구독합니다. pull_request
이벤트가 수신되면 해당 Pull Request 데이터가 저장되고 참조로 유지됩니다. 생성된 풀 리퀘스트가 있는 경우 GitLab은 외부 풀 리퀘스트용 파이프라인을 즉시 생성합니다.
참조된 브랜치에 변경 사항이 푸시되고 풀 리퀘스트가 진행 중인 경우 외부 풀 리퀘스트용 파이프라인을 생성합니다.
이 경우 GitLab CI/CD는 2개의 파이프라인을 생성합니다. 브랜치 푸시용 하나, 외부 풀 리퀘스트용 하나입니다.
풀 리퀘스트가 닫힌 후에는 새로운 변경 사항이 동일한 브랜치에 푸시되더라도 외부 풀 리퀘스트용 파이프라인이 생성되지 않습니다.
외부 풀 리퀘스트용 파이프라인을 사용하면 GitLab은 파이프라인 작업에 대한 사전 정의된 변수를 노출합니다.
변수 이름은 CI_EXTERNAL_PULL_REQUEST_
로 접두어가 붙습니다.
제한 사항
이 기능은 다음을 지원하지 않습니다:
- GitHub Enterprise에서 필요한 수동 연결 방법. 통합이 수동으로 연결된 경우, 외부 풀 리퀘스트는 파이프라인을 트리거하지 않습니다.
- 포크 저장소에서의 풀 리퀘스트. 포크 저장소에서의 풀 리퀘스트는 무시됩니다.
GitLab은 2개의 파이프라인을 생성하므로, 원격 브랜치에 변경 사항을 푸시하면 둘 다 GitHub 통합을 통해 풀 리퀘스트의 상태에 기여합니다. 외부 풀 리퀘스트에서만 파이프라인을 실행하고 브랜치에서는 실행하지 않으려면 작업 사양에 except: [branches]
를 추가할 수 있습니다. 더 알아보기.