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

Tier: Free, Premium, Ultimate Offering: GitLab.com, Self-managed, GitLab Dedicated
  • 병렬로 Bitbucket Cloud로부터 가져오기는 GitLab 16.6에서 도입되었습니다 flag인 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가 저장소에 없는 경우, 가져오기는 소스 커밋을 병합 커밋 SHA로 설정하려고 시도합니다.
  • 병합 요청 담당자는 작성자로 설정됩니다. 리뷰어는 GitLab에서 Bitbucket 식별과 일치하는 사용자명으로 설정됩니다.
  • 승인은 가져오지 않습니다.
  • GitLab의 병합 요청은 열림, 닫힘, 또는 병합됨 중 하나일 수 있습니다.

이슈의 경우:

  • 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에서 활성화되어 있습니다.
  • 가져오기할 대상 그룹에서 적어도 유지관리자 역할이 있어어아 합니다.
  • Bitbucket에서의 풀 리퀘스트는 동일한 소스 및 대상 프로젝트를 가져야 하며 프로젝트의 포크가 아니어야 합니다. 그렇지 않을 경우, 풀 리퀘스트는 빈 병합 요청으로 가져와집니다.

사용자 매핑된 기여 요구 사항

사용자 기여가 매핑되려면, 각 사용자는 프로젝트 가져오기 전에 다음을 완료해야 합니다:

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

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

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

Bitbucket 저장소 가져오기

  1. GitLab에 로그인하세요.
  2. 왼쪽 사이드바의 맨 위에서 새로 만들기 () 및 새 프로젝트/저장소를 선택하세요.
  3. 프로젝트 가져오기를 선택하세요.
  4. Bitbucket Cloud를 선택하세요.

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

    액세스 허용

  6. 가져오거나 모든 프로젝트를 가져올 프로젝트를 선택하세요. 프로젝트를 이름별로 필터링하고 각 프로젝트를 가져오기 위해 해당하는 네임스페이스를 선택할 수 있습니다.

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

문제 해결

여러 개의 Bitbucket 계정이 있는 경우

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

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

  1. Bitbucket 저장소 가져오기 절차를 역으로 진행하여 GitLab이 Bitbucket 계정에 대한 액세스를 취소합니다.

  2. Bitbucket 계정에서 로그아웃합니다. 이전 단계에서 링크된 절차를 따릅니다.

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

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

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

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

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

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

이후 가져오기자는 가져온 프로젝트를 삭제한 다음 다시 가져와야 합니다.