Skip to main content
설명서에 자주 업데이트를 게시하며 이 페이지의 번역이 계속 진행 중일 수 있습니다. 최신 정보는 영어 설명서를 참조하세요.
All products
마이그레이션

Bitbucket 서버에서 GitHub Enterprise Cloud로 리포지토리 마이그레이션

이 문서의 내용

GitHub CLI를 사용하여 Bitbucket Server에서 GitHub Enterprise Cloud로 리포지토리를 마이그레이션할 수 있습니다.

참고: GitHub Enterprise Importer를 사용하여 Bitbucket Server에서 마이그레이션하는 작업은 현재 프라이빗 베타로 제공되며 변경될 수 있습니다. 베타에 대한 액세스를 요청하려면 Bitbucket 서버 마이그레이션 대기 목록 조인을 참조하세요.

GitHub Enterprise Importer을(를) 사용하여 리포지토리 마이그레이션 정보

GitHub CLI을 사용하여 BitBucket Server instance 개별 리포지토리 또는 모든 리포지토리를 마이그레이션할 수 있습니다.

현재 GitHub API를 사용하여 Bitbucket 서버에서 마이그레이션하는 것은 지원되지 않습니다.

사전 요구 사항

  • Importer의 알려진 지원 제한 사항을 이해하려면 "GitHub Enterprise Importer 정보"을 검토하세요.
  • 마이그레이션의 평가판 실행을 수행하고 곧 프로덕션 마이그레이션을 완료하는 것이 좋습니다. 평가판 실행 모범 사례에 대한 자세한 내용은 "GitHub Enterprise Importer를 사용하여 마이그레이션 실행 준비"을 참조하세요.
  • 필수는 아니지만 프로덕션 마이그레이션 중에 작업을 중지하는 것이 좋습니다. Importer은(는) 델타 마이그레이션을 지원하지 않으므로 마이그레이션 중에 발생하는 모든 변경 내용은 마이그레이션되지 않습니다. 프로덕션 마이그레이션 중에 작업을 중단하지 않도록 선택하는 경우 이러한 변경 내용을 수동으로 마이그레이션해야 합니다.
  • GitHub.com의 대상 organization 경우 조직 소유자 또는 마이그레이션자 역할이 있어야 합니다. 자세한 내용은 "GitHub Enterprise Importer에 대한 마이그레이션자 역할 부여"을 참조하세요.
  • 관리자 또는 슈퍼 관리자 권한이 있는 Bitbucket 서버 계정의 사용자 이름 및 암호가 필요합니다.

1단계: BBS2GH extension of the GitHub CLI 설치

첫 번째 마이그레이션인 경우 BBS2GH extension of the GitHub CLI을(를) 설치해야 합니다. GitHub CLI에 대한 자세한 내용은 "GitHub CLI 정보.

  1. GitHub CLI을(를) 설치합니다. GitHub CLI에 대한 설치 지침은 GitHub CLI 리포지토리를 참조하세요.

    참고: GitHub CLI의 버전 2.4.0 이상이 필요합니다. 명령을 사용하여 설치한 gh --version 버전을 확인할 수 있습니다.

  2. BBS2GH extension을(를) 설치합니다.

    Shell
    gh extension install github/gh-bbs2gh

BBS2GH extension에 대한 도움이 필요할 때마다 명령과 함께 플래그를 --help 사용할 수 있습니다. 예를 들어 은 gh bbs2gh --help 사용 가능한 모든 명령을 나열하고 gh bbs2gh migrate-repo --help 명령에 사용할 수 있는 migrate-repo 모든 옵션을 나열합니다.

2단계: BBS2GH extension of the GitHub CLI 업데이트

BBS2GH extension of the GitHub CLI은(는) 매주 업데이트됩니다. To make sure you're using the latest version, update the extension.

Shell
gh extension upgrade github/gh-bbs2gh

3단계: 환경 변수 설정

BBS2GH extension을(를) 사용하여 GitHub Enterprise Cloud로 마이그레이션하려면 먼저 대상 organization 액세스할 수 있는 personal access token을 만든 다음 personal access token를 환경 변수로 설정해야 합니다.

또한 Bitbucket Server 사용자 이름 및 암호에 대한 환경 변수를 설정하고, Bitbucket Server instance Windows에서 실행되는 경우 SMB 암호를 설정해야 합니다.

  1. GitHub Enterprise Cloud에서 대상 organization 인증할 personal access token을 만들고 기록하여 토큰이 모든 요구 사항을 충족하는지 확인합니다. 자세한 내용은 "GitHub Enterprise Importer에 대한 액세스 관리"을 참조하세요.

  2. 환경 변수를 설정하고, TOKEN을 위에서 기록한 personal access token로 바꾸고, USERNAME을 관리자 또는 슈퍼 관리자 권한이 있는 Bitbucket Server 계정의 사용자 이름으로 바꾸고, PASSWORD를 Bitbucket 서버 계정의 암호로 바꿉니다.

    • 터미널을 사용하는 경우 명령을 사용합니다 export .

      Shell
      export GH_PAT="TOKEN"
export BBS_USERNAME="USERNAME"
export BBS_PASSWORD="PASSWORD"
# If your Bitbucket Server instance runs on Windows
export SMB_PASSWORD="PASSWORD"

    • PowerShell을 사용하는 경우 명령을 사용합니다 $env .

      Shell
      $env:GH_PAT="TOKEN"
$env:BBS_USERNAME="USERNAME"
$env:BBS_PASSWORD="PASSWORD"
# If your Bitbucket Server instance runs on Windows
$env:SMB_PASSWORD="PASSWORD"

4단계: Blob Storage 설정

많은 Bitbucket Server 인스턴스가 방화벽 뒤에 있기 때문에 GitHub CLI는 인터넷에서 연결할 수 있는 데이터를 저장하는 중간 위치로 Blob Storage를 사용합니다.

먼저 마이그레이션하려는 데이터의 보관 파일을 생성하고 방화벽 뒤에서 Blob Storage로 데이터를 푸시합니다.

GitHub CLI은 다음 Blob Storage 공급자를 지원합니다.

  • AWS(Amazon Web Services) S3
  • Azure Blob Storage

마이그레이션을 실행하려면 데이터를 저장하기 위해 선택한 클라우드 공급자를 사용하여 스토리지 컨테이너를 설정해야 합니다.

AWS S3 스토리지 버킷 설정

AWS에서 S3 버킷을 설정합니다. 자세한 내용은 AWS 설명서에서 버킷 만들기 를 참조하세요.

또한 버킷에 대한 액세스 권한이 있는 AWS 액세스 키 및 비밀 키가 read-write 필요합니다.

참고: 마이그레이션이 완료된 후 GitHub Enterprise Importer은(는) AWS에서 보관 파일을 삭제하지 않습니다. 스토리지 비용을 줄이려면 일정 기간 후에 보관 파일의 자동 삭제를 구성하는 것이 좋습니다. 자세한 내용은 AWS 설명서 의 버킷에 수명 주기 구성 설정을 참조하세요.

마이그레이션을 실행할 준비가 되면 GitHub CLI(지역, 액세스 키, 비밀 키 및 세션 토큰(필요한 경우))에 AWS 자격 증명을 제공해야 합니다. 인수로 전달하거나 , , AWS_ACCESS_KEY_ID``AWS_SECRET_ACCESS_KEY및 AWS_SESSION_TOKEN라는 AWS_REGION환경 변수를 설정할 수 있습니다.

또한 인수를 사용하여 --aws-bucket-name S3 버킷의 이름을 전달해야 합니다.

Azure Blob Storage 스토리지 계정 설정

In Azure, create a storage account and make a note of your connection string. For more information, see Manage storage account access keys in Microsoft Docs.

Note: GitHub Enterprise Importer does not delete your archive from Azure Blob Storage after your migration is finished. To reduce storage costs, we recommend configuring auto-deletion of your archive after a period of time. For more information, see Optimize costs by automatically managing the data lifecycle in Microsoft Docs.

마이그레이션을 실행할 준비가 되면 GitHub CLI에 연결 문자열을 인수로 전달하거나 라는 AZURE_STORAGE_CONNECTION_STRING환경 변수를 사용하여 에 전달할 수 있습니다.

5단계: 리포지토리 마이그레이션

명령을 사용하여 리포지토리를 마이그레이션할 gh bbs2gh migrate-repo 수 있습니다.

리포지토리를 마이그레이션하는 경우 기본적으로 BBS2GH extension of the GitHub CLI는 다음 단계를 수행합니다.

  1. Bitbucket Server instance 연결하고 리포지토리당 마이그레이션 보관 파일을 생성합니다.
  2. SFTP(Linux) 또는 SMB(Windows)를 사용하여 BBS2GH extension of the GitHub CLI을(를) 실행 중인 컴퓨터로 Bitbucket 서버 instance 마이그레이션 보관 파일을 다운로드합니다.
  3. 선택한 Blob Storage 공급자에 마이그레이션 보관 파일을 업로드합니다.
  4. Blob Storage 공급자와 함께 저장된 보관 파일의 URL을 사용하여 GitHub Enterprise Cloud에서 마이그레이션을 시작합니다.
  5. 마이그레이션 보관 파일을 삭제합니다.

또는 GitHub CLI를 사용하여 보관 파일을 생성하고, 해당 보관 파일을 수동으로 다운로드한 다음, GitHub CLI를 사용하여 마이그레이션을 계속할 수 있습니다.

GitHub CLI에서 마이그레이션 보관 파일을 다운로드할 수 있도록 허용

단일 리포지토리를 마이그레이션하려면 명령을 사용합니다 gh bbs2gh migrate-repo .

액세스할 수 있는 컴퓨터에서 다음 단계를 수행해야 합니다.

  • HTTPS를 통해 Bitbucket 서버 instance
  • Bitbucket 서버 instance Linux에서 실행되는 경우 Bitbucket 서버는 SFTP를 통해 instance. 일반적으로 SSH를 통해 서버에 액세스할 수 있는 경우 SFTP를 사용할 수도 있습니다.
  • Bitbucket 서버 instance Windows에서 실행되는 경우 Bitbucket 서버는 SMB를 통해 instance.
  • 선택한 Blob Storage 공급자
Shell
gh bbs2gh migrate-repo --bbs-server-url BBS-SERVER-URL \
  --bbs-project PROJECT --bbs-repo CURRENT-NAME \
  --github-org DESTINATION --github-repo NEW-NAME \
  # Use the following options if your Bitbucket Server instance runs on Linux
  --ssh-user SSH-USER --ssh-private-key PATH-TO-KEY
  # Use the following options if your Bitbucket Server instance runs on Windows
  --smb-user SMB-USER
  # Use the following option if you're using AWS S3 as your blob storage provider
  --aws-bucket-name AWS-BUCKET-NAME

위의 명령에서 자리 표시자를 다음 값으로 바꿉 있습니다.

자리 표시자 | 값 | ----------- | ----- | BBS-SERVER-URL | The URL for your Bitbucket Server instance PROJECT | 마이그레이션하려는 리포지토리의 Bitbucket Server 프로젝트의 키 CURRENT-NAME | 마이그레이션할 리포지토리의 이름 DESTINATION | 대상 조직의 이름 NEW-NAME | 마이그레이션된 리포지토리에 사용할 이름 SSH-USER | Bitbucket Server instance Linux에서 실행되는 경우 SFTP를 통해 Bitbucket 서버에 연결할 때 사용할 사용자 이름입니다. PATH-TO-KEY | Bitbucket Server 인스턴스가 Linux에서 실행되는 경우 SSH 프라이빗 키의 경로(예: ~/.ssh/id_rsa)입니다. SSH 키 요구 사항은 "AUTOTITLE"을 참조하세요. SMB-USER | Bitbucket Server 인스턴스가 Windows에서 실행되는 경우 SMB를 통해 Bitbucket 서버에 연결할 때 사용할 사용자 이름입니다. AWS-BUCKET-NAME | The bucket name for your AWS S3 bucket

참고: 를 언급하는 Renci.SshNet동안 오류가 발생하면 CLI에서 마이그레이션 보관 파일을 다운로드하기 위해 서버에 SFTP를 연결하는 데 문제가 있습니다. 이러한 문제를 해결하는 방법에 대한 자세한 내용은 "GitHub Enterprise Importer를 사용하여 마이그레이션 문제 해결.

수동으로 마이그레이션 보관 파일 다운로드

기본적으로 BBS2GH extension of the GitHub CLI는 SFTP 또는 SMB를 사용하여 Bitbucket 서버 instance 마이그레이션 보관 파일을 다운로드하는 등 전체 마이그레이션을 수행합니다.

그러나 일부 고객은 서버가 SFTP 액세스를 제공하지 않기 때문에 마이그레이션 보관 파일을 수동으로 다운로드하는 것을 선호합니다. 이 경우 GitHub CLI를 사용하여 보관 파일을 생성하고, 해당 보관 파일을 수동으로 다운로드한 다음, GitHub CLI를 사용하여 마이그레이션을 계속할 수 있습니다.

액세스할 수 있는 컴퓨터에서 다음 단계를 수행해야 합니다.

  • HTTPS를 통해 Bitbucket 서버 instance
  • 선택한 Blob Storage 공급자

먼저 다음 인수와 함께 명령을 사용합니다 gh bbs2gh migrate-repo .

Shell
gh bbs2gh migrate-repo --bbs-server-url BBS-SERVER-URL \
  --bbs-project PROJECT \
  --bbs-repo CURRENT-NAME

위의 명령에서 자리 표시자를 다음 값으로 바꿉 있습니다.

자리 표시자 | 값 | ----------- | ----- | BBS-SERVER-URL | The URL for your Bitbucket Server instance PROJECT | 마이그레이션하려는 리포지토리의 Bitbucket Server 프로젝트의 키 CURRENT-NAME | 마이그레이션할 리포지토리의 이름

마이그레이션 보관 파일이 생성되고 해당 경로가 명령 출력에 인쇄됩니다.

[12:14] [INFO] Export completed. Your migration archive should be ready on your
instance at $BITBUCKET_SHARED_HOME/data/migration/export/Bitbucket_export_9.tar

일반적으로 는 $BITBUCKET_SHARED_HOME Linux 및 C:\Atlassian\ApplicationData\Bitbucket\Shared Windows에서 로 /var/atlassian/application-data/bitbucket/shared 설정되지만 서버 구성에 따라 다를 수 있습니다. 공유 홈 디렉터리를 식별하는 데 도움이 되도록 "GitHub Enterprise Importer를 사용하여 마이그레이션 문제 해결"을 참조하세요.

Bitbucket Server instance 마이그레이션 보관 파일을 다운로드하고 GitHub CLI을(를) 실행 중인 컴퓨터에 보관 파일을 저장합니다.

마이그레이션 보관 파일을 GitHub로 가져오려면 다른 인수 집합과 함께 명령을 다시 사용합니다 gh bbs2gh migrate-repo .

Shell
gh bbs2gh migrate-repo --archive-path ARCHIVE-PATH \
  --github-org DESTINATION --github-repo NEW-NAME \
  # Use the following option if you're using AWS S3 as your blob storage provider
  --aws-bucket-name AWS-BUCKET-NAME

위의 명령에서 자리 표시자를 다음 값으로 바꿉 있습니다.

자리 표시자 | 값 | ----------- | ----- | ARCHIVE-PATH | instance 다운로드한 Bitbucket Server 마이그레이션 보관 파일의 경로입니다. DESTINATION | 대상 조직의 이름 NEW-NAME | 마이그레이션된 리포지토리에 사용할 이름 AWS-BUCKET-NAME | The bucket name for your AWS S3 bucket

6단계: 마이그레이션 유효성 검사 및 오류 로그 검사

마이그레이션이 완료되면 마이그레이션 로그를 검토하는 것이 좋습니다. 자세한 내용은 "GitHub Enterprise Importer에 대한 마이그레이션 로그 액세스"을 참조하세요.

사운드 확인을 위해 마이그레이션된 리포지토리를 검토하는 것이 좋습니다.

7단계: 여러 리포지토리 마이그레이션

여러 리포지토리를 한 번에 GitHub Enterprise Cloud로 마이그레이션하려면 GitHub CLI를 사용하여 마이그레이션 스크립트를 생성합니다. 결과 스크립트에는 리포지토리당 하나씩 마이그레이션 명령 목록이 포함됩니다.

참고: 스크립트를 생성하면 PowerShell 스크립트가 출력됩니다. 터미널을 사용하는 경우 파일 확장명에서 스크립트 .ps1 를 출력하고 Mac 또는 Linux 용 PowerShell을 설치하여 실행해야 합니다.

마이그레이션 스크립트 생성

HTTPS를 통해 Bitbucket Server instance 액세스할 수 있는 컴퓨터에서 이 단계를 수행해야 합니다.

마이그레이션 스크립트를 생성하려면 명령을 실행합니다 gh bbs2gh generate-script .

Shell
gh bbs2gh generate-script --bbs-server-url BBS-SERVER-URL \
  --github-org DESTINATION \
  --output FILENAME \
  # Use the following options if your Bitbucket Server instance runs on Linux
  --ssh-user SSH-USER --ssh-private-key PATH-TO-KEY
  # Use the following options if your Bitbucket Server instance runs on Windows
  --smb-user SMB-USER

스크립트가 마이그레이션된 각 리포지토리에 대한 마이그레이션 로그를 다운로드하도록 하려면 플래그를 추가합니다 --download-migration-logs . 마이그레이션 로그에 대한 자세한 내용은 "GitHub Enterprise Importer에 대한 마이그레이션 로그 액세스"을 참조하세요.

위의 명령에서 자리 표시자를 다음 값으로 바꿉 있습니다.

자리 표시자 | 값 | ----------- | ----- | BBS-SERVER-URL | The URL for your Bitbucket Server instance DESTINATION | 대상 조직의 이름 FILENAME | 결과 마이그레이션 스크립트의 파일 이름

터미널을 사용하는 경우 생성된 스크립트에서 .ps1 PowerShell을 실행해야 하므로 파일 확장자를 사용합니다. Mac 또는 Linux용 PowerShell을 설치할 수 있습니다. SSH-USER | Bitbucket Server instance Linux에서 실행되는 경우 SFTP를 통해 Bitbucket 서버에 연결할 때 사용할 사용자 이름입니다. PATH-TO-KEY | Bitbucket Server 인스턴스가 Linux에서 실행되는 경우 SSH 프라이빗 키의 경로(예: ~/.ssh/id_rsa)입니다. SSH 키 요구 사항은 "AUTOTITLE"을 참조하세요. SMB-USER | Bitbucket Server 인스턴스가 Windows에서 실행되는 경우 SMB를 통해 Bitbucket 서버에 연결할 때 사용할 사용자 이름입니다.

마이그레이션 스크립트 검토

스크립트를 생성한 후 파일을 검토하고 필요에 따라 스크립트를 편집합니다.

  • 마이그레이션하지 않으려는 리포지토리가 있는 경우 해당 줄을 삭제하거나 주석 처리합니다.
  • 기본적으로 GitHub의 리포지토리 이름은 규칙을 따릅니다 projectKey-repositoryName . 예를 들어 키 OS가 있는 프로젝트의 일부 open-source 인 라는 airports Bitbucket Server 리포지토리는 GitHub에서 호출 OS-airports 됩니다. 리포지토리가 GitHub에 다른 이름을 갖도록 하려면 해당 --github-repo 플래그의 값을 업데이트합니다.

마이그레이션 스크립트 실행

리포지토리를 마이그레이션하려면 생성된 스크립트를 실행합니다.

액세스할 수 있는 컴퓨터에서 다음 단계를 수행해야 합니다.

  • HTTPS를 통해 Bitbucket 서버 instance
  • Bitbucket 서버 instance Linux에서 실행되는 경우 Bitbucket 서버는 SFTP를 통해 instance. 일반적으로 SSH를 통해 서버에 액세스할 수 있는 경우 SFTP를 사용할 수도 있습니다.
  • Bitbucket 서버 instance Windows에서 실행되는 경우 Bitbucket 서버는 SMB를 통해 instance.
  • 선택한 Blob Storage 공급자

스크립트를 실행하기 전에 Blob Storage 공급자에 인증할 추가 환경 변수를 설정해야 합니다.

  • AWS S3의 경우 다음 환경 변수를 설정합니다.
    • AWS_ACCESS_KEY: 버킷에 대한 액세스 키
    • AWS_SECRET_KEY: 버킷의 비밀 키
    • AWS_REGION: 버킷이 있는 AWS 지역
    • AWS_SESSION_TOKEN: AWS 임시 자격 증명을 사용하는 경우 세션 토큰(AWS 설명서에서 AWS 리소스와 함께 임시 자격 증명 사용 참조)
  • Azure Blob Storage Azure Storage 계정의 연결 문자열로 설정합니다AZURE_STORAGE_CONNECTION_STRING.

스토리지 계정 액세스 키를 사용하는 연결 문자열만 지원됩니다. SAS(공유 액세스 서명)를 사용하는 연결 문자열은 지원되지 않습니다. 스토리지 계정 액세스 키에 대한 자세한 내용은 Azure 설명서에서 스토리지 계정 액세스 키 관리를 참조하세요.

여러 리포지토리를 마이그레이션하려면 위에서 생성한 스크립트를 실행합니다. 아래 명령의 FILENAME을 스크립트를 생성할 때 제공한 파일 이름으로 바꿉니다.

  • 터미널을 사용하는 경우 를 사용합니다 ./.
    Shell
    ./FILENAME
  • PowerShell을 사용하는 경우 를 사용합니다 .\.
    Shell
    .\FILENAME