Bitbucket Server로부터 프로젝트 가져오기
Bitbucket Server에서 프로젝트를 GitLab로 가져오세요.
사전 요구 사항
- GitLab 16.0에서 도입된 메인테이너 역할 요구 사항이 개발자 역할 대신 사용되며, GitLab 15.11.1 및 GitLab 15.10.5로 백포팅되었습니다.
- Bitbucket Server 가져오기 소스 을 활성화해야 합니다. 활성화되어 있지 않다면 GitLab 관리자에게 활성화할 것을 요청하세요. Bitbucket Server 가져오기 소스는 GitLab.com에서 기본적으로 활성화되어 있습니다.
- 가져오기할 대상 그룹에서 적어도 Maintainer 역할이 있어야 합니다.
- 관리자 액세스를 갖는 Bitbucket Server 인증 토큰이 필요합니다. 관리자 액세스 없이는 일부 데이터가 가져와지지 않습니다.
리포지터리 가져오기
Bitbucket 리포지터리를 가져오려면:
- GitLab에 로그인합니다.
- 왼쪽 사이드바 상단에서 새로 만들기 ()를 선택하고 새 프로젝트/리포지터리를 선택합니다.
- 프로젝트 가져오기를 선택합니다.
- Bitbucket Server를 선택합니다.
- Bitbucket에 로그인하고 GitLab이 Bitbucket 계정에 액세스하도록 허용합니다.
- 가져올 프로젝트를 선택하거나 모든 프로젝트를 가져올 수 있습니다. 프로젝트를 이름으로 필터링하고 가져올 각 프로젝트에 대해 네임스페이스를 선택할 수 있습니다.
- 프로젝트를 가져오려면:
- 처음 가져오기: 가져오기를 선택합니다.
- 다시 가져오기: 다시 가져오기를 선택합니다. 새 이름을 지정하고 다시 다시 가져오기를 선택합니다. 다시 가져오기하면 소스 프로젝트의 새 복사본이 생성됩니다.
가져와지는 항목
- 리포지터리 설명
- Git 리포지터리 데이터
- 풀 리퀘스트
- 풀 리퀘스트 코멘트, 사용자 언급, 리뷰어, 승인 및 머지 이벤트
- LFS 오브젝트
가져오기 시, 리포지터리 공개 액세스는 유지됩니다. Bitbucket에서 리포지터리가 비공개이면 GitLab에서도 비공개로 생성됩니다.
폐쇄되거나 머지된 풀 리퀘스트가 가져와질 때, 리포지터리에 존재하지 않는 커밋 SHAs는 Bitbucket 서버에서 가져와져 풀 리퀘스트에 연결된 커밋을 확인합니다:
- 소스 커밋 SHAs는
refs/merge-requests/<iid>/head형식의 참조로 저장됩니다. - 대상 커밋 SHAs는
refs/keep-around/<SHA>형식의 참조로 저장됩니다.
소스 커밋이 리포지터리에 존재하지 않는 경우, 커밋 메시지에 SHA를 포함한 커밋이 대신 사용됩니다.
가져와지지 않는 항목
다음 항목은 가져와지지 않습니다:
- 마크다운의 첨부 파일
- 할 일 디렉터리
- 이모지 반응
가져와지지만 변경되는 항목
다음 항목은 가져올 때 변경됩니다:
- GitLab은 임의의 코드 라인에 코멘트를 허용하지 않습니다. 허용되지 않는 Bitbucket 코멘트는 Merge Request에 코멘트로 삽입됩니다.
- 여러 스레드 레벨은 하나의 스레드로 축소되며 인용문은 원래 코멘트의 일부로 추가됩니다.
- 프로젝트 필터링은 모호한 검색을 지원하지 않습니다. 시작 지점 또는 완전 일치 문자열만 지원됩니다.
사용자 할당
bitbucket_server_import_stage_import_users라는 특성 플래그를 활성화할 수 있습니다. GitLab.com 및 GitLab Dedicated에서는 이 기능을 사용할 수 없습니다.이슈 및 풀 리퀘스트를 가져올 때, 가져오기기는 저자의 이메일 주소를 GitLab 사용자 데이터베이스에서 확인된 이메일 주소로 찾으려 시도합니다. 그러한 사용자가 없다면, 프로젝트 작성자가 저자로 설정됩니다. 가져오기는 코멘트에 원래 생성자를 표시하는 노트를 추가합니다.
풀 리퀘스트 설명과 코멘트의 @언급은 사용자의 이메일 주소를 사용하여 Bitbucket Server의 사용자 프로필과 일치시킵니다.
GitLab에서 동일한 이메일 주소를 가진 사용자를 찾을 수 없다면, @언급은 정적으로 생성됩니다.
사용자가 일치되려면, 해당 사용자는 적어도 프로젝트에 읽기 액세스를 제공하는 GitLab 역할이 있어야 합니다.
프로젝트가 공개되어 있다면, GitLab은 프로젝트에 초대된 사용자만 일치시킵니다.
가져오기기는 해당하는 네임스페이스(그룹)을 생성하지 않은 경우 새로 생성합니다. 네임스페이스가 사용 중이면, 리포지터리는 가져오기 프로세스를 시작한 사용자의 네임스페이스 하에 가져옵니다.
가져오기기는 다음을 찾으려 시도합니다:
- GitLab 사용자 데이터베이스에서 이메일 주소로 리뷰어를 찾습니다. 그들이 GitLab에 없다면, 리뷰어로 추가하지 않습니다.
- 사용자 이름 또는 이메일로 승인자를 찾습니다. 그들이 GitLab에 없다면, 승인은 풀 리퀘스트에 추가되지 않습니다.
사용자 할당: 사용자 이름에 의한 할당
- 프로덕션 용도로 권장되지 않음.
bitbucket_server_user_mapping_by_username라는 특성 플래그를 활성화할 수 있습니다. 이 기능은 프로덕션 용도로 사용할 준비가 되지 않았습니다.이 기능을 활성화하면 가져오기기가 GitLab 사용자 데이터베이스에서 저자의:
사용자 이름slug표시 이름
로 사용자를 찾으려 시도합니다. 그런 속성과 일치하는 사용자가 없다면, 프로젝트 작성자를 저자로 설정합니다.
문제 해결
일반
GUI 기반의 가져오기 도구가 작동하지 않으면 다음을 시도할 수 있습니다:
- GitLab 가져오기 API를 사용합니다. Bitbucket Server 엔드포인트.
- 리포지터리 미러링을 설정합니다. 자세한 오류 출력을 제공합니다.
Bitbucket Cloud에 대한 문제 해결 방법은 문제 해결 섹션을 참조하세요.
가져와진 LFS 오브젝트
프로젝트 가져오기가 완료되었지만 LFS 오브젝트를 다운로드하거나 복제할 수 없는 경우, 특수 문자가 포함된 암호나 개인 액세스 토큰을 사용하고 있을 수 있습니다. 자세한 내용은 이 이슈를 참조하세요.
유효하지 않거나 해결되지 않는 호스트 주소로 인한 가져오기 실패, 또는 가져오기 URL이 차단된 경우
프로젝트 가져오기가 Import url is blocked와 같은 오류 메시지로 실패하면, 초기적 접속에도 불구하고, 비트버킷 서버나 리버스 프록시가 올바르게 구성되지 않았을 수 있습니다.
이 문제를 해결하려면, 프로젝트 API를 사용하여 새로 생성된 프로젝트를 확인하고 프로젝트의 import_url 값을 찾아보세요.
이 값은 가져오기에 사용할 비트버킷 서버에게 제공된 URL을 나타냅니다. 이 URL이 공개적으로 확인될 수 없다면, 확인되지 않는 주소 오류를 얻을 수 있습니다.
이 문제를 해결하려면, 프록시 서버에 대한 비트버킷 서버의 인식이 유지되도록 하세요. 왜냐하면 프록시 서버는 비트버킷이 URL을 구성하고 사용하는 방식에 영향을 미칠 수 있기 때문입니다. 더 많은 정보는 Atlassian 문서를 참조하세요.
도움말