• 병합 요청 목록에서
• 이슈에서
• 파일을 추가, 편집 또는 업로드할 때
• 브랜치를 생성할 때
• 포크에서 작업할 때
  • 기본 대상 프로젝트 설정
• 이메일 전송으로
  • 이메일로 병합 요청을 생성할 때 첨부 파일 추가
• 문제 해결
  • 문제에 병합 요청을 생성할 수 있는 옵션 없음
  • 이메일 메시지를 처리할 수 없음

병합 요청 생성하기

GitLab은 Git 명령어 사용을 포함하여 병합 요청을 생성하는 다양한 방법을 제공합니다.

병합 요청 목록에서

병합 요청 목록에서 병합 요청을 생성할 수 있습니다.

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

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

이슈에서

개발 워크플로우에서 모든 병합 요청에 대해 이슈가 필요한 경우, 프로세스를 빠르게 진행하기 위해 이슈에서 직접 브랜치를 생성할 수 있습니다.
새 브랜치와 나중의 병합 요청은 이 이슈와 관련된 것으로 표시됩니다. 병합 요청을 병합한 후, 이슈는 자동으로 닫히며, 자동 이슈 닫기가 비활성화되어 있지 않은 경우:

Git 저장소가 비어 있는 경우, GitLab은:

• 기본 브랜치를 생성합니다.
• 빈 README.md 파일을 커밋합니다.
• 이슈 제목을 기반으로 한 새 브랜치를 생성하고 리디렉션합니다.
• 프로젝트가 Kubernetes와 같은 배포 서비스로 구성되어 있는 경우, GitLab은 자동 배포를 설정하라고 요청하며, .gitlab-ci.yml 파일을 생성하는 데 도움을 줍니다.

생성하는 브랜치 이름이 이슈 번호로 접두사 설정되어 있는 경우, GitLab은 이슈와 병합 요청을 상호 연결하고, 병합 요청의 설명에 이슈 닫기 패턴을 추가합니다. 대부분의 경우, 이는 Closes #ID처럼 보이며, 여기서 ID는 이슈의 ID입니다. 프로젝트가 닫기 패턴으로 구성되어 있는 경우, 병합 요청이 병합될 때 이슈가 닫힙니다.

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

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

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

브랜치를 생성할 때

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

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

포크에서 작업할 때

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

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

4. 대상 브랜치:

   1. 대상 프로젝트를 선택합니다. (포크가 아니라 업스트림 프로젝트를 선택해야 합니다.)
   2. 업스트림 리포지토리에서 브랜치를 선택합니다.

   참고: 업스트림으로 변경 사항을 자주 기여하는 경우, 포크를 위한 기본 대상 프로젝트 설정을 고려하세요.

5. 브랜치 비교 및 계속을 선택합니다.
6. 병합 요청 생성을 선택합니다. 병합 요청은 포크가 아닌 대상 프로젝트에 생성됩니다.

작업이 병합된 후, 더 이상 기여할 의사가 없다면 포크의 연결 끊기 를 수행하세요.

자세한 정보는 포크 작업 흐름 문서를 참조하세요.

기본 대상 프로젝트 설정

기본적으로 포크에서 발생한 병합 요청은 업스트림 프로젝트를 대상으로 하며, 포크된 프로젝트는 아닙니다.

포크된 프로젝트를 기본 대상으로 설정하도록 구성할 수 있습니다.

필수 조건:

• 포크에서 작업 중입니다.
• 개발자 이상의 역할이 필요하거나 프로젝트에서 병합 요청을 생성할 수 있어야 합니다.
• 업스트림 프로젝트에서 병합 요청 생성을 허용해야 합니다.
• 포크의 가시성 설정 이 업스트림 리포지토리와 일치하거나 더 엄격하지 않아야 합니다. 예를 들어: 포크가 비공개이고 업스트림이 공개인 경우 이 설정은 표시되지 않습니다.

이 작업을 수행하려면:

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

이메일 전송으로

이메일 메시지를 GitLab에 보내어 병합 요청을 생성할 수 있습니다.

병합 요청의 대상 브랜치는 프로젝트의 기본 브랜치입니다.

사전 조건:

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

이메일을 통해 병합 요청을 생성하려면:

1. 왼쪽 사이드바에서 Search or go to를 선택하고 프로젝트를 찾습니다.

2. Code > Merge requests를 선택합니다.

3. 프로젝트에 병합 요청이 있는 경우, Email a new merge request to this project를 선택합니다.

4. 대화 상자에서 표시된 이메일 주소를 복사합니다. 이 주소는 비공개로 유지하세요. 이 주소를 가진 누구나 당신인 것처럼 문제나 병합 요청을 생성할 수 있습니다.

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

   • To 라인은 복사한 이메일 주소입니다.
   • Subject는 소스 브랜치 이름입니다.
   • 이메일 본문은 병합 요청 설명입니다.

6. 커밋을 추가하려면, 메시지에 .patch 파일을 첨부합니다.

7. 이메일을 전송합니다.

병합 요청이 생성됩니다.

이메일로 병합 요청을 생성할 때 첨부 파일 추가

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

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

문제 해결

문제에 병합 요청을 생성할 수 있는 옵션 없음

다음 경우에는 문제에서 Create merge request 옵션이 표시되지 않습니다:

• 동일한 이름의 브랜치가 이미 존재합니다.
• 이 브랜치에 대한 병합 요청이 이미 존재합니다.
• 프로젝트에 활성 포크 관계가 있습니다.
• 프로젝트가 비공개이고 문제는 기밀입니다.

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

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

병합 요청을 생성하기 위해 이메일을 보내고 상위 프로젝트를 대상으로 하려고 할 때 GitLab은 다음과 같은 오류로 응답합니다:

불행히도 GitLab에 보낸 이메일 메시지를 처리할 수 없습니다.

이 작업을 수행할 수 있는 권한이 없습니다. 이 오류가 잘못되었다고 생각되면 직원에게 연락하십시오.