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을 연결하세요.