병합 요청 생성

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

GitLab은 Git 명령을 사용하여 병합 요청을 만들 수 있는 여러 가지 방법을 제공합니다.

note
GitLab은 문제를 방지하고 병합 요청 생성을 간소화하기 위해 브랜치 네이밍 규칙을 시행하며 브랜치 네이밍 패턴도 제공합니다.

병합 요청 목록에서

병합 요청 목록에서 병합 요청을 만들 수 있습니다.

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
  2. 코드 > 병합 요청를 선택합니다.
  3. 오른쪽 상단에서 새로운 병합 요청을 선택합니다.
  4. 소스 및 타겟 브랜치를 선택한 후 브랜치 비교 및 계속을 선택합니다.
  5. 새로운 병합 요청 페이지의 필드를 작성한 다음 병합 요청 생성을 선택합니다.

각 브랜치에는 하나의 열린 병합 요청만 연결될 수 있습니다. 브랜치에 이미 병합 요청이 있는 경우 기존 병합 요청으로의 링크가 표시됩니다.

이슈에서

개발 워크플로가 모든 병합 요청에 대해 이슈를 필요로 하는 경우, 프로세스를 가속화하기 위해 이슈에서 브랜치를 직접 생성할 수 있습니다. 이러한 새로운 브랜치와 이후의 병합 요청은 이 이슈와 관련되었음을 표시합니다. 병합 요청이 병합되면, 이슈는 자동으로 닫힙니다. 단, 자동 이슈 닫기가 비활성화되어 있지 않은 한:

병합 요청 및 브랜치

브랜치와 병합 요청을 동시에 만들려면:

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
  2. Plan > 이슈를 선택하고 이슈를 찾습니다.
  3. 이슈 설명의 하단으로 이동합니다.
  4. 병합 요청 만들기 > 병합 요청 및 브랜치 만들기를 선택합니다.
  5. 대화 상자에서 제안된 브랜치 이름을 검토합니다. 이는 프로젝트의 브랜치 이름 템플릿을 기반으로 합니다. 이미 사용 중인 브랜치 이름인 경우 또는 다른 브랜치 이름이 필요한 경우 이름을 변경합니다.
  6. 소스 브랜치 또는 태그를 선택합니다.
  7. 병합 요청 생성을 선택합니다.
브랜치만

이슈에서 직접 브랜치만 만들려면:

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
  2. Plan > 이슈를 선택하고 이슈를 찾습니다.
  3. 이슈 설명의 하단으로 이동합니다.
  4. 병합 요청 만들기 > 브랜치 만들기를 선택합니다.
  5. 대화 상자에서 제안된 브랜치 이름을 검토합니다. 이는 프로젝트의 브랜치 이름 템플릿을 기반으로 합니다. 이미 사용 중인 브랜치 이름인 경우 또는 다른 브랜치 이름이 필요한 경우 이름을 변경합니다.
  6. 소스 브랜치 또는 태그를 선택합니다.
  7. 브랜치 생성을 선택합니다.

만약 Git 저장소가 비어 있다면, GitLab은:

여러분이 생성한 브랜치의 이름이 이슈 번호로 접두어가 붙은 경우, GitLab은 이슈와 병합 요청을 상호 링크하고 이슈 닫기 패턴을 병합 요청 설명에 추가합니다. 대부분의 경우, 이는 Closes #ID로 보입니다. 여기서 ID는 이슈의 ID입니다. 여러분의 프로젝트가 [닫는 패턴과 구성되어 있다면 (../issues/managing_issues.md#default-closing-pattern), 병합 요청이 병합될 때 이슈가 닫힙니다.

파일을 추가, 편집 또는 업로드할 때

파일을 추가, 편집 또는 업로드할 때 병합 요청을 생성할 수 있습니다.

  1. 파일을 추가, 편집 또는 업로드합니다.
  2. 커밋 메시지에 커밋 이유를 입력합니다.
  3. 타겟 브랜치를 선택하거나 이름을 입력하여 새 브랜치를 생성합니다.
  4. 이 변경 사항으로 새 병합 요청 시작 확인란을 선택하거나 토글합니다. 이 확인란 또는 토글은 타겟이 소스 브랜치와 다른 경우 또는 소스 브랜치가 보호된 경우에만 표시됩니다.
  5. 파일 업로드를 선택합니다.
  6. 필드를 작성하고 병합 요청 생성을 선택합니다.

브랜치를 생성할 때

브랜치를 생성할 때 병합 요청을 생성할 수 있습니다.

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
  2. 코드 > 브랜치를 선택합니다.
  3. 브랜치 이름을 입력하고 새 브랜치를 선택합니다.
  4. 파일 목록 위에서 병합 요청 만들기를 선택합니다. 병합 요청이 생성됩니다. 기본 브랜치가 타겟입니다.
  5. 필드를 작성하고 병합 요청 생성을 선택합니다.

포크에서 작업할 때

본인의 포크에서 주 프로젝트로 기여하려면 병합 요청을 생성할 수 있습니다.

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 포크를 찾습니다.
  2. 코드 > 병합 요청를 선택하고 새 병합 요청을 선택합니다.
  3. 소스 브랜치에서 여러분의 변경 사항을 포함한 포크의 브랜치를 선택합니다.

  4. 타겟 브랜치:

    1. 타겟 프로젝트를 선택합니다. (포크가 아닌 상위 프로젝트를 선택하십시오.)
    2. 상위 저장소의 브랜치를 선택합니다.
    note
    자주 상류로 변경을 기여할 경우, 포크에 대한 기본 타겟 프로젝트 설정을 고려하세요.
  5. 브랜치 비교 및 계속를 선택합니다.
  6. 병합 요청 생성을 선택합니다. 병합 요청은 포크가 아닌 대상 프로젝트에 생성됩니다.

여러분의 작업이 병합되면 포크를 연결 해제하십시오 만약 더 이상 기여하지 않을 경우.

자세한 내용은 포킹 워크플로 문서를 확인하세요.

기본 대상 프로젝트 설정

기본적으로 포크에서 시작된 병합 요청은 상위 프로젝트가 아닌 포크된 프로젝트를 대상으로 지정합니다.

상위 프로젝트가 아닌 포크된 프로젝트를 기본 대상으로 설정하려면 포크된 프로젝트를 구성할 수 있습니다.

필수 사항:

  • 포크에서 작업 중이어야 합니다.
  • 최소한 Developer 역할이 있거나 프로젝트에서 병합 요청을 생성할 수 있어야 합니다.
  • 상위 프로젝트가 병합 요청을 생성할 수 있어야 합니다.
  • 포크의 가시성 설정이 상위 저장소와 일치하거나 더 엄격해서는 안 됩니다. 예를 들어: 이 설정은 포크가 비공개이지만 상위 저장소가 공개인 경우에는 표시되지 않습니다.

다음을 수행하려면:

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
  2. 설정 > 병합 요청을 선택합니다.
  3. 대상 프로젝트 섹션에서 기본 대상 프로젝트로 사용할 옵션을 선택합니다.
  4. 변경 사항 저장을 선택합니다.

이메일 보내기로

이메일 메시지를 통해 GitLab에 병합 요청을 생성할 수 있습니다. 병합 요청의 대상 브랜치는 프로젝트의 기본 브랜치입니다.

필수 사항:

  • 병합 요청은 현재 프로젝트를 대상으로 지정해야 합니다. 상위 프로젝트가 아니어야 합니다.
  • GitLab 관리자가 들어오는 이메일을 구성해야 합니다. 이 설정은 GitLab.com에서 활성화되어 있습니다.
  • GitLab 관리자가 이메일로 회신을 구성해야 합니다. 이 설정은 GitLab.com에서 활성화되어 있습니다.
  • 최소한 Developer 역할이 있거나 프로젝트에서 병합 요청을 생성할 수 있어야 합니다.

이메일을 보내어 병합 요청을 생성하려면:

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
  2. 코드 > 병합 요청을 선택합니다.
  3. 프로젝트에 병합 요청이 있는 경우 이 프로젝트에 새 병합 요청 이메일 보내기를 선택합니다.
  4. 대화 상자에서 표시된 이메일 주소를 복사합니다. 이 주소를 비공개로 유지하세요. 이 주소를 가진 사람은 당신인 것처럼 이슈나 병합 요청을 생성할 수 있습니다.

  5. 이메일을 열고 다음 정보를 포함한 메시지를 작성합니다.

    • 수신자 줄은 복사한 이메일 주소입니다.
    • 제목은 소스 브랜치 이름입니다.
    • 이메일의 본문은 병합 요청 설명입니다.
  6. 커밋을 추가하려면 메시지에 .patch 파일을 첨부합니다.
  7. 이메일을 보냅니다.

병합 요청이 생성됩니다.

이메일로 병합 요청 생성 시 첨부 파일 추가

이메일에 첨부 파일로 패치를 추가하여 병합 요청에 커밋을 추가할 수 있습니다.

  • 패치의 결합된 크기는 2MB 이하여야 합니다.
  • 패치로 고려되려면 첨부 파일의 파일 이름이 .patch로 끝나야 합니다.
  • 패치는 이름순으로 처리됩니다.
  • 제목의 소스 브랜치가 존재하지 않으면, 저장소의 HEAD나 기본 대상 브랜치에서 생성됩니다. 대상 브랜치를 수동으로 변경하려면 /target_branch 빠른 조치를 사용하세요.
  • 소스 브랜치가 이미 존재하는 경우 패치는 그 위에 적용됩니다.

문제 해결

이슈에 병합 요청을 생성할 수 있는 옵션이 표시되지 않음

이슈에서 병합 요청 생성 옵션이 표시되지 않는 경우:

  • 동일한 이름의 브랜치가 이미 존재합니다.
  • 이 브랜치에 대한 병합 요청이 이미 존재합니다.
  • 프로젝트에 활성 포크 관계가 있습니다.
  • 프로젝트가 비공개이고 이슈가 기밀이라면 버튼이 표시되지 않습니다.

이 버튼을 표시하려면 가능한 해결 방법 중 하나는 프로젝트의 포크 관계를 제거하는 것입니다. 제거된 후에는 포크 관계를 다시 복원할 수 없습니다. 이 프로젝트는 더 이상 소스 프로젝트나 다른 포크로부터 병합 요청을 수신하거나 전송할 수 없습니다.

이메일 메시지를 처리할 수 없음

이메일을 보내어 병합 요청을 생성하려고 하고 상위 프로젝트를 대상으로 지정하는 경우, GitLab은 다음과 같은 오류로 응답합니다: 

이메일 메시지가 GitLab에서 처리되지 못했습니다.

이 작업을 수행할 수 있는 권한이 없습니다. 이것이 오류라면 관리자에게 문의하십시오.