Bitbucket Cloud importer 개발 문서

전제 조건

Bitbucket에 인증되어 있어야 합니다.

GitLab Development Kit (GDK)를 사용하는 경우 GDK에서 Bitbucket 인증 설정을 참조하세요.
그렇지 않은 경우 Bitbucket OmniAuth 공급자 지침을 참조하세요.

코드 구조

이 import 기능의 코드베이스는 다음 디렉터리로 나뉘어 있습니다:

lib/gitlab/bitbucket_import: 이 디렉터리에는 리소스를 가져오는 데 사용되는 클래스 등 대부분의 코드가 포함되어 있습니다.
app/workers/gitlab/bitbucket_import: 이 디렉터리에는 Sidekiq 워커가 포함되어 있습니다.

아키텍처 개요

Bitbucket Cloud 프로젝트를 가져올 때, 작업은 각 단계로 나뉘며, 각 단계에는 실행되는 일련의 Sidekiq 작업이 포함됩니다. 각 단계 사이에는 현재 단계의 모든 작업이 완료되었는지 주기적으로 확인하는 작업이 예약되며, 이 경우 가져오기 프로세스가 다음 단계로 진행됩니다. 이 작업을 처리하는 워커는 Gitlab::BitbucketImport::AdvanceStageWorker입니다.

단계

1. Stage::ImportRepositoryWorker

이 워커는 리포지터리, 위키 및 라벨을 가져와서 완료되면 다음 단계를 예약합니다.

2. Stage::ImportPullRequestsWorker

이 워커는 모든 풀 리퀘스트를 가져옵니다. 각 풀 리퀘스트마다 Gitlab::BitbucketImport::ImportPullRequestWorker 워커를 위한 작업이 예약됩니다.

3. Stage::ImportPullRequestsNotesWorker

이 워커는 모든 Merge Request의 노트(코멘트)를 가져옵니다.

각 Merge Request에 대해 Gitlab::BitbucketImport::ImportPullRequestNotesWorker 워커를 위한 작업이 예약되어 Merge Request의 모든 노트를 가져옵니다.

4. Stage::ImportIssuesWorker

이 워커는 모든 이슈를 가져옵니다. 각 이슈마다 Gitlab::BitbucketImport::ImportIssueWorker 워커를 위한 작업이 예약됩니다.

5. Stage::ImportIssuesNotesWorker

이 워커는 모든 이슈의 노트(코멘트)를 가져옵니다.

각 이슈에 대해 Gitlab::BitbucketImport::ImportIssueNotesWorker 워커를 위한 작업이 예약되어 이슈의 모든 노트를 가져옵니다.

5. Stage::FinishImportWorker

이 워커는 가져오기 프로세스를 완료하고 가져오기가 완료되었음을 표시하는 등 일부 정리 작업을 수행합니다.

재시도 및 재시도

요청을 처리하기 위해, 요청은 Bitbucket::ExponentialBackoff로 래핑됩니다. 이 래퍼는 요율 제한 오류를 catch하고 최대 세 번까지 지연 후 재시도합니다.

GDK에서 Bitbucket 인증 설정

GDK에서 Bitbucket 인증을 설정하려면:

Bitbucket OAuth 자격 증명을 만들기 위해 단계 9까지 문서를 따릅니다.

config/gitlab.yml에 자격 증명을 추가하세요:

# config/gitlab.yml
   
development:
  <<: *base
  omniauth:
    providers:
    - { name: 'bitbucket',
        app_id: '...',
        app_secret: '...' }

gdk restart를 실행하세요.
GDK에 로그인하여 <gdk-url>/-/profile/account로 이동하고 Bitbucket을 연결하세요.