포크된 리포지터리에서 Merge Request 협업하기

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

포크한 리포지터리에서 Merge Request을 열면 상위 멤버들이 여러분의 브랜치에서 협업할 수 있습니다. 이 옵션을 활성화하면 대상 브랜치로 Merge할 권한이 있는 멤버들이 Merge Request의 소스 브랜치에 쓰기 권한을 획들합니다.

상위 프로젝트의 멤버들은 Merge하기 전에 작은 수정이나 리베이스 브랜치를 만들 수 있습니다.

이 기능은 공개적으로 접근 가능한 포크된 프로젝트 간의 Merge Request에서 사용할 수 있습니다.

상위 멤버로부터 커밋 허용

Merge Request의 작성자로서 참여 중인 프로젝트의 상위 멤버로부터 커밋 편집을 허용할 수 있습니다:

  1. Merge Request을 작성하거나 편집하는 동안 Contribution으로 스크롤하여 대상 브랜치에 Merge할 수 있는 멤버의 커밋 허용 확인란을 선택합니다.
  2. Merge Request을 완료합니다.

Merge Request을 작성한 후, Merge Request 위젯에 Merge할 수 있는 멤버가 커밋을 추가할 수 있습니다 메시지가 표시됩니다. 상위 멤버들은 다음을 할 수 있습니다:

  • 직접 브랜치에 커밋합니다.
  • Merge Request의 파이프라인과 작업을 다시 시도합니다.

상위 멤버로부터 커밋 금지

Merge Request의 작성자로서 참여 중인 프로젝트의 상위 멤버로부터 커밋 편집을 방지할 수 있습니다:

  1. Merge Request을 작성하거나 편집하는 동안 Contribution으로 스크롤하여 대상 브랜치에 Merge할 수 있는 멤버의 커밋 허용 확인란을 해제합니다.
  2. Merge Request을 완료합니다.

상위 멤버로부터 포크에 푸시

다음 상황에서는 포크된 리포지터리의 브랜치에 직접 푸시할 수 있습니다:

  • Merge Request의 작성자가 상위 멤버로부터의 기여를 활성화했습니다.
  • 상위 프로젝트에서 최소한 Developer 역할을 가지고 있습니다.

다음 예제에서:

  • 포크된 리포지터리 URL은 git@gitlab.com:contributor/forked-project.git입니다.
  • Merge Request의 브랜치는 fork-branch입니다.

기여자의 Merge Request을 변경하거나 커밋을 추가하려면:

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하여 프로젝트를 찾습니다.
  2. Code > Merge Request를 선택하고 Merge Request을 찾습니다.
  3. 오른쪽 상단에서 Code를 선택한 다음 분기 확인을 선택합니다.
  4. 대화상자에서 복사를 선택합니다 ().

  5. 터미널에서 리포지터리의 클론 버전으로 이동하여 명령을 붙여넣습니다. 예를 들어: 

    git fetch "git@gitlab.com:contributor/forked-project.git" 'fork-branch'
git checkout -b 'contributor/fork-branch' FETCH_HEAD

    이 명령어는 포크된 프로젝트에서 브랜치를 가져와 작업할 로컬 브랜치를 만듭니다.

  6. 로컬 브랜치에서 변경 사항을 만들고 커밋합니다.

  7. 로컬 변경 사항을 포크된 프로젝트에 푸시합니다. 다음 명령은 로컬 브랜치 contributor/fork-branch를 git@gitlab.com:contributor/forked-project.git 리포지터리의 fork-branch 브랜치로 푸시합니다: 

    git push git@gitlab.com:contributor/forked-project.git contributor/fork-branch:fork-branch

    만약 커밋을 수정했거나 합친 경우, 강제로 푸시해야 합니다. 이 명령은 커밋 기록을 다시 작성하기 때문에 주의하여 진행하세요: 

    git push --force git@gitlab.com:contributor/forked-project.git contributor/fork-branch:fork-branch

    두 브랜치 사이에 콜론(:)에 주목하세요. 일반적인 구조는 다음과 같습니다: 

    git push <forked_repository_git_url> <local_branch>:<fork_branch>

문제 해결

포크된 프로젝트의 Merge Request 페이지에서 파이프라인 상태를 볼 수 없음

사용자가 프로젝트를 포크하면 포크된 복사본의 권한은 원본 프로젝트에서 복사되지 않습니다. 포크의 생성자는 상위 프로젝트의 멤버가 Merge Request의 변경 사항을 보거나 Merge하기 위해 포크된 복사본에 권한을 부여해야 합니다.

포크된 프로젝트의 Merge Request 페이지에서 파이프라인 상태를 확인하려면 원래 프로젝트로 돌아가세요:

  1. 모든 상위 멤버를 포함하는 그룹을 생성합니다.
  2. 왼쪽 사이드바에서 포크된 프로젝트를 찾아 선택합니다.
  3. 포크된 프로젝트의 관리 > 멤버 페이지로 이동하여 새롭게 생성한 그룹을 포크된 프로젝트에 초대하세요.