Bitbucket Cloud에서 프로젝트 가져오기

Tier: Free, Premium, Ultimate Offering: GitLab.com, 자체관리, GitLab Dedicated
  • Bitbucket Cloud로부터 병렬 가져오기는 GitLab 16.6에서 도입되었습니다. 기본적으로 비활성화된 bitbucket_parallel_importer라는 플래그와 함께.
  • GitLab 16.6에서 GitLab.com에 활성화되었습니다.
  • GitLab 16.7에서 일반 사용 가능해졌습니다. 피처 플래그 bitbucket_parallel_importer가 제거되었습니다.

Bitbucket Cloud에서 프로젝트를 GitLab으로 가져옵니다.

Bitbucket 가져오기는 다음을 가져올 수 있습니다:

  • 리포지터리 설명
  • Git 리포지터리 데이터
  • 이슈
  • 이슈 코멘트
  • 풀 리퀘스트
  • 풀 리퀘스트 코멘트
  • 마일스톤
  • 위키
  • 라벨
  • LFS 오브젝트

가져올 때:

  • 풀 리퀘스트 및 이슈에 대한 참조가 보존됩니다.
  • 리포지터리 공개 액세스가 유지됩니다. Bitbucket에서 리포지터리가 비공개인 경우 GitLab에서도 비공개로 생성됩니다.
note
Bitbucket Cloud 가져오기는 Bitbucket.org에서만 작동하며 Bitbucket Server(Stash)와는 호환되지 않습니다. Bitbucket Server에서 프로젝트를 가져오려면 Bitbucket Server 가져오기를 사용하세요.

이슈, 풀 리퀘스트 및 코멘트가 가져올 때, Bitbucket 가져오기는 작성자/담당자의 Bitbucket 별명을 사용하고 GitLab에서 동일한 Bitbucket 신원을 찾습니다. 일치하지 않거나 GitLab 데이터베이스에서 사용자가 찾을 수 없는 경우, 프로젝트 생성자(대부분 가져오기 프로세스를 시작한 현재 사용자)가 작성자로 설정되지만 이슈에 대한 원래의 Bitbucket 작성자에 대한 참조가 유지됩니다.

풀 리퀘스트의 경우:

  • 소스 SHA가 리포지터리에 존재하지 않는 경우, 가져오기는 소스 커밋을 Merge 커밋 SHA로 설정하려고 시도합니다.
  • Merge Request 담당자는 작성자로 설정됩니다. 리뷰어는 GitLab에서 Bitbucket 신원과 일치하는 사용자 이름으로 설정됩니다.
  • 승인은 가져오지 않습니다.
  • GitLab의 Merge Request은 열림, 닫힘, 또는 Merge됨 중 하나일 수 있습니다.

이슈의 경우:

  • Bitbucket의 이슈 유형에 해당하는 라벨이 추가됩니다. bug, enhancement, proposal, 또는 task 중 하나입니다.
  • Bitbucket의 이슈가 해결됨, 유효하지 않음, 중복, 해결하지 않음 또는 닫힘 중 하나였다면, GitLab에서 해당 이슈가 닫힙니다.

가져오기 시, 새로운 네임스페이스(그룹)가 존재하지 않으면 생성되거나 네임스페이스가 이미 사용 중인 경우, 프로젝트가 가져오기 프로세스를 시작한 사용자의 네임스페이스 아래로 가져옵니다.

사전 요구 사항

  • 개정자 역할의 요구 사항은 GitLab 16.0에서 도입되었으며 GitLab 15.11.1 및 GitLab 15.10.5로 역이 되었습니다.
  • Bitbucket Cloud 통합이 활성화되어 있어야 합니다. 이 통합이 활성화되지 않은 경우, GitLab 관리자에게 활성화해 달라고 요청하세요. Bitbucket Cloud 통합은 GitLab.com에서 기본적으로 활성화되어 있습니다.
  • Bitbucket Cloud 가져오기 소스가 활성화되어 있어야 합니다. 비활성화된 경우, GitLab 관리자에게 활성화해 달라고 요청하세요. Bitbucket Cloud 가져오기 소스는 GitLab.com에서 기본적으로 활성화되어 있습니다.
  • 가져오기할 대상 그룹에 대한 최소한의 유지자(Maintainer) 역할이 있어야 합니다.
  • Bitbucket에서의 풀 리퀘스트가 동일한 소스 및 대상 프로젝트를 가져야 하며 프로젝트의 포크(fork)가 아니어야 합니다. 그렇지 않으면 풀 리퀘스트가 빈 Merge Request으로 가져와집니다.

사용자 매핑 기여에 대한 요구 사항

유저의 기여를 매핑하기 위해서, 각 사용자는 프로젝트 가져오기 전에 다음을 완료하여야 합니다:

  1. Bitbucket 계정 설정의 사용자 이름이 Atlassian 계정 설정의 공개 이름과 일치하는지 확인하세요. 일치하지 않는 경우, Atlassian 계정 설정에서 공개 이름을 Bitbucket 계정 설정의 사용자 이름과 일치하도록 수정하세요.

  2. GitLab 프로필 서비스 로그인에서 Bitbucket 계정을 연결하세요.

  3. 공개 이메일을 설정하세요.

Bitbucket 리포지터리 가져오기

  1. GitLab에 로그인하세요.
  2. 왼쪽 사이드바 상단에서 Create new () 및 New project/repository를 선택하세요.
  3. 프로젝트 가져오기를 선택하세요.
  4. Bitbucket Cloud를 선택하세요.

  5. Bitbucket에 로그인하고 GitLab에 Bitbucket 액세스 권한을 부여하세요.

    액세스 부여

  6. 가져올 프로젝트를 선택하거나 모든 프로젝트를 가져올 수 있습니다. 프로젝트 이름으로 필터링하고 각 프로젝트의 가져올 네임스페이스를 선택할 수 있습니다.

  7. 프로젝트를 가져오려면:
    • 처음인 경우: 가져오기를 선택하세요.
    • 다시인 경우: 새 이름을 지정하고 다시 재가져오기를 선택하세요. 다시 가져오기는 소스 프로젝트의 새 사본을 생성합니다.

Bitbucket Cloud 앱 비밀번호 생성

GitLab REST API를 사용하여 Bitbucket Cloud 리포지터리를 가져오려면 Bitbucket Cloud 앱 비밀번호를 만들어야 합니다.

Bitbucket Cloud 앱 비밀번호를 생성하려면:

  1. https://bitbucket.org/account/settings/로 이동하세요.
  2. 액세스 관리 섹션에서 앱 비밀번호를 선택하세요.
  3. 앱 비밀번호 만들기를 선택하세요.
  4. 비밀번호 이름을 입력하세요.

  5. 적어도 다음 권한을 선택하세요: 

    계정: 이메일, 읽기
프로젝트: 읽기
리포지터리: 읽기
풀 리퀘스트: 읽기
이슈: 읽기
위키: 읽기 및 쓰기
  6. 만들기를 선택하세요.

문제 해결

여러 개의 Bitbucket 계정을 보유한 경우

올바른 계정으로 로그인했는지 확인하세요.

잘못된 계정으로 가져오기 프로세스를 시작한 경우 다음 단계를 따르세요:

  1. Bitbucket 계정으로부터 GitLab에 대한 액세스를 취소하여 보이는 프로세스를 역으로 진행하세요: Bitbucket 리포지터리 가져오기.

  2. Bitbucket 계정에서 로그아웃하세요. 이전 단계에서 링크된 절차를 따르세요.

사용자 매핑이 이름 일치에도 실패하는 경우

사용자 매핑이 작동하려면, Bitbucket 계정 설정의 사용자 이름이 Atlassian 계정 설정의 공개 이름과 일치해야 합니다. 이러한 이름이 일치하지만 사용자 매핑이 실패하는 경우, 사용자는 Bitbucket 계정을 GitLab 프로필 서비스 로그인에 연결한 후 Bitbucket 사용자 이름을 수정한 것일 수 있습니다.

이를 해결하려면 사용자가 GitLab 데이터베이스에서의 Bitbucket 외부 UID가 현재의 Bitbucket 공개 이름과 일치하는지 확인하고, 일치하지 않는 경우 다시 연결해야 합니다:

  1. 인증된 사용자를 가져오기 위해 API 사용.

  2. API 응답에는 identities 속성에 GitLab 데이터베이스에 존재하는 Bitbucket 계정이 포함됩니다. 현재의 Bitbucket 공개 이름과 extern_uid가 일치하지 않으면 사용자는 GitLab 프로필 서비스 로그인에서 Bitbucket 계정을 다시 연결해야 합니다.

  3. 다시 연결한 후, 사용자는 API를 사용하여 GitLab 데이터베이스의 extern_uid가 현재의 Bitbucket 공개 이름과 일치하는지 다시 확인해야 합니다.

그러면 가져오기는 가져오기된 프로젝트를 삭제하고 다시 가져와야 합니다.