• Merge Request 디렉터리에서
• 이슈에서
• 파일을 추가, 편집 또는 업로드할 때
• 브랜치를 생성할 때
• 로컬에서 Git 명령을 사용할 때
• 포크를 사용하는 경우
  • 기본 타겟 프로젝트 설정
• 이메일로 전송
  • 이메일로 Merge Request을 만들 때 첨부 파일 추가
• 문제 해결
  • 이슈에 대한 Merge Request 생성 옵션이 표시되지 않음
  • 이메일 메시지가 처리되지 않음

Merge Request 생성

GitLab은 Merge Request을 생성하는 다양한 방법을 제공합니다.

Merge Request 디렉터리에서

Merge Request 디렉터리에서 Merge Request을 생성할 수 있습니다.

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

각 브랜치는 하나의 열린 Merge Request과만 연결될 수 있습니다. 만약 해당 브랜치에 이미 Merge Request이 존재한다면, 기존 Merge Request으로의 링크가 표시됩니다.

이슈에서

• 변경됨 Merge Request 생성 버튼의 동작을 GitLab 14.8에서 Merge Request 생성 양식을 열도록 변경했습니다.

만약 개발 워크플로가 모든 Merge Request에 대해 이슈를 필요로 하는 경우, 프로세스를 빠르게 진행하기 위해 이슈에서 직접 브랜치를 만들 수 있습니다. 새로운 브랜치 및 나중에 이와 관련된 Merge Request은 이 이슈와 관련이 있다고 표시됩니다. Merge Request을 Merge한 후, 이슈는 자동으로 닫힙니다. 자동 이슈 닫힘이 비활성화된 경우, 이슈는 닫히지 않습니다.

만약 Git 리포지터리가 비어 있다면, GitLab은:

• 기본 브랜치를 생성합니다.
• 비어 있는 README.md 파일을 커밋합니다.
• 이슈 제목을 기반으로 새로운 브랜치를 생성하고 해당 브랜치로 리디렉션합니다.
• 만약 프로젝트가 쿠버네티스와 같은 배포 서비스로 구성되어 있다면, GitLab은 .gitlab-ci.yml 파일 생성을 돕는 자동 배포를 설정하도록 안내합니다.

만일 만든 브랜치의 이름이 이슈 번호로 접두사가 붙은 경우, GitLab은 이슈와 Merge Request을 상호 연결하고 이슈 닫힘 패턴을 Merge Request 설명에 추가합니다. 대부분의 경우에는 Closes #ID와 같은 형태로 보입니다. 여기서 ID는 이슈의 ID입니다. 프로젝트가 닫힘 패턴으로 구성된 경우, Merge Request이 통합되면 이슈가 닫힙니다.

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

리포지터리에 파일을 추가, 편집 또는 업로드할 때 Merge Request을 생성할 수 있습니다.

1. 파일을 추가, 편집 또는 업로드합니다.
2. 커밋 메시지에 커밋의 이유를 입력합니다.
3. 대상 브랜치를 선택하거나 이름을 입력하여 새 브랜치를 만듭니다.
4. 이 변경 사항으로 새 Merge Request 시작 확인란 또는 토글을 선택합니다. 이 확인란 또는 토글은 대상이 소스 브랜치와 다를 때 또는 소스 브랜치가 보호될 때만 표시됩니다.
5. 파일 업로드를 선택합니다.
6. 필드를 입력한 후 Merge Request 생성을 선택합니다.

브랜치를 생성할 때

브랜치를 생성할 때 Merge Request을 생성할 수 있습니다.

1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
2. Code > 브랜치를 선택합니다.
3. 브랜치 이름을 입력하고 새 브랜치를 선택합니다.
4. 파일 디렉터리 상단에서 오른쪽으로 이동하여 Merge Request 만들기를 선택합니다. Merge Request이 생성됩니다. 기본 브랜치가 대상입니다.
5. 필드를 입력한 후 Merge Request 생성을 선택합니다.

로컬에서 Git 명령을 사용할 때

로컬 머신에서 Git 명령을 실행하여 Merge Request을 생성할 수 있습니다.

1. 브랜치를 생성합니다:

   git checkout -b my-new-branch
   

2. 필요한 대로 파일을 생성, 편집 또는 삭제합니다.

3. 파일을 커밋할 준비를 마치고 로컬로 커밋합니다:

   # 파일을 커밋할 준비를 함
   git add .
   # 지역에서 변경 사항을 커밋
   git commit -m "나의 커밋 메시지"
   

4. 브랜치와 커밋을 GitLab에 푸시합니다:

   git push origin my-new-branch
   

   나중에 Merge Request에서 편집해야 할 필드의 수를 줄이려면 푸시 옵션을 사용하여 필드의 값을 설정합니다.

5. git push에 대한 응답에서 GitLab은 Merge Request을 생성할 수 있는 직접적인 링크를 제공합니다:

   ...
   remote: my-new-branch에 대한 Merge Request을 생성하려면 다음을 방문하세요:
   remote:   https://gitlab.example.com/my-group/my-project/merge_requests/new?merge_request%5Bsource_branch%5D=my-new-branch
   

6. 링크를 복사하여 브라우저에 붙여넣습니다.

포크를 사용하는 경우

메인 프로젝트로 기여하기 위해 포크에서 Merge Request을 생성할 수 있습니다.

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

4. 타겟 브랜치에 대해:

   1. 타겟 프로젝트를 선택합니다. (포크가 아닌 상위 프로젝트를 선택해야 합니다.)
   2. 상위 리포지터리에서 브랜치를 선택합니다.
   상위 스트림으로 변경 사항을 주기적으로 기여하는 경우 포크의 기본 타겟 프로젝트 설정을 고려해보세요.
5. 브랜치 비교 및 계속을 선택합니다.
6. Merge Request 작성을 선택합니다. Merge Request은 포크가 아닌 타겟 프로젝트에 생성됩니다.

작업이 Merge된 후 더 이상 기여하지 않을 경우, 포크의 연결을 해제해야 합니다.

더 많은 정보는 포크 워크플로 문서를 참조하세요.

기본 타겟 프로젝트 설정

기본적으로 포크에서 시작한 Merge Request은 상위 프로젝트를 대상으로 하며, 포크 프로젝트를 대상으로 하지 않습니다.

상위 프로젝트 대신 포크 프로젝트를 기본 타겟으로 설정할 수 있습니다.

필수 요구 사항:

• 포크에서 작업 중이어야 합니다.
• 최소한 개발자 역할을 가지고 있거나 해당 프로젝트에서 Merge Request을 생성할 수 있는 권한이 있어야 합니다.
• 상위 프로젝트에서 Merge Request을 생성할 수 있어야 합니다.
• 포크의 가시성 설정이 상위 리포지터리와 일치하거나 더 엄격해서는 안 됩니다. 예를 들어: 포크가 비공개이고 상위 리포지터리가 공개된 경우에는 이 설정이 표시되지 않습니다.

다음을 수행하여 설정합니다:

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

이메일로 전송

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

필수 요구 사항:

• Merge Request은 현재 프로젝트를 대상으로 해야 합니다. 상위 프로젝트 대상이 아니어야 합니다.
• GitLab 관리자가 이메일 수신을 구성해야 합니다.
• GitLab 관리자가 이메일로 회신을 구성해야 합니다.
• 최소한 개발자 역할을 가지고 있거나 해당 프로젝트에서 Merge Request을 생성할 수 있는 권한이 있어야 합니다.

이메일을 통해 Merge Request을 생성하려면:

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

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

   • 받는 사람 라인에 복사한 이메일 주소를 입력합니다.
   • 제목은 소스 브랜치 이름입니다.
   • 이메일 본문은 Merge Request 설명입니다.
6. 커밋을 추가하려면 메시지에 .patch 파일을 첨부합니다.
7. 이메일을 전송합니다.

Merge Request이 생성됩니다.

이메일로 Merge Request을 만들 때 첨부 파일 추가

이메일로 Merge Request에 커밋을 추가하려면 이메일에 첨부 파일로 패치를 추가하세요.

• 패치의 크기 합계는 2MB 이하여야 합니다.
• 패치로 간주되려면 첨부 파일 이름이 .patch로 끝나야 합니다.
• 패치는 이름순으로 처리됩니다.
• 제목의 소스 브랜치가 존재하지 않으면 리포지터리의 HEAD 또는 기본 타겟 브랜치에서 생성됩니다. 매뉴얼으로 타겟 브랜치를 변경하려면 /target_branch 빠른 조치를 사용하세요.
• 소스 브랜치가 이미 존재하는 경우 패치가 해당 브랜치 위에 적용됩니다.

문제 해결

이슈에 대한 Merge Request 생성 옵션이 표시되지 않음

이슈에서 Merge Request 만들기 옵션이 표시되지 않는 경우:

• 동일한 이름의 브랜치가 이미 존재하는 경우.
• 해당 브랜치에 이미 Merge Request이 있는 경우.
• 프로젝트가 활성화된 포크 관계를 가지고 있는 경우.
• 프로젝트가 비공개이며 이슈가 기밀인 경우.

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

이메일 메시지가 처리되지 않음

이메일로 Merge Request을 생성하려고 하는데 상위 프로젝트를 대상으로 하려고 하면 GitLab에서 다음과 같은 오류가 발생합니다:

이메일 메시지를 GitLab에서 처리할 수 없습니다.

이 작업을 수행할 수 없습니다. 이것이 오류라고 생각하는 경우 관리자에게 문의하십시오.