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

데이터를 엔터프라이즈로 마이그레이션

마이그레이션 보관을 생성한 후 대상 GitHub Enterprise Server 인스턴스로 데이터를 가져올 수 있습니다. 대상 인스턴스에 변경 내용을 영구적으로 적용하기 전에 잠재적 충돌에 대한 변경 내용을 검토할 수 있습니다.

가져온 데이터를 GitHub Enterprise Server에 적용

데이터를 엔터프라이즈로 마이그레이션하려면 먼저 데이터를 준비하고 충돌을 해결해야 합니다. 자세한 내용은 "엔터프라이즈로의 데이터 마이그레이션 준비"를 참조하세요.

데이터를 준비하고 충돌을 해결한 후에는 가져온 데이터를 GitHub Enterprise Server에 적용할 수 있습니다.

  1. 사이트 관리자로 대상 GitHub Enterprise Server 인스턴스에 SSH합니다.

    $ ssh -p 122 admin@HOSTNAME
  2. ghe-migrator import 명령을 사용하여 가져오기 프로세스를 시작합니다. 필요한 사항:

    $ ghe-migrator import /home/admin/MIGRATION-GUID.tar.gz -g MIGRATION-GUID -u USERNAME -p TOKEN
    
    > Starting GitHub::Migrator
    > Import 100% complete /
    • 마이그레이션 파일을 스테이징할 위치를 지정하려면 --staging-path=/full/staging/path를 사용하여 명령을 추가합니다. 기본값은 /data/user/tmp입니다.

마이그레이션 데이터 검토

기본적으로 ghe-migrator audit에서는 모든 레코드를 반환합니다. 또한 다음을 기준으로 레코드를 필터링할 수 있습니다.

  • 레코드 유형.
  • 레코드 상태.

레코드 유형은 마이그레이션된 데이터에 있는 레코드 유형과 일치합니다.

레코드 유형 필터

레코드 형식필터 이름
사용자user
조직organization
리포지토리repository
Teamsteam
마일스톤milestone
프로젝트 보드project
문제issue
문제 설명issue_comment
끌어오기 요청pull_request
끌어오기 요청 검토pull_request_review
커밋 설명commit_comment
끌어오기 요청 검토 설명pull_request_review_comment
릴리스release
끌어오기 요청 또는 문제에 대해 수행된 작업issue_event
보호된 분기protected_branch

레코드 상태 필터

레코드 상태설명
export레코드를 내보냅니다.
import레코드를 가져옵니다.
map레코드를 매핑합니다.
rename레코드의 이름을 변경합니다.
merge레코드를 병합합니다.
exported레코드를 내보냈습니다.
imported레코드를 가져왔습니다.
mapped레코드를 매핑했습니다.
renamed레코드의 이름을 변경했습니다.
merged레코드를 병합했습니다.
failed_export레코드를 내보내지 못했습니다.
failed_import레코드를 가져오지 못했습니다.
failed_map레코드를 매핑하지 못했습니다.
failed_rename레코드의 이름을 변경하지 못했습니다.
failed_merge레코드를 병합하지 못했습니다.

감사된 레코드 필터링

ghe-migrator audit 명령을 사용하면 -m 플래그를 사용하여 레코드 형식을 기준으로 필터링할 수 있습니다. 마찬가지로 -s 플래그를 사용하여 가져오기 상태를 필터링할 수 있습니다. 이 명령은 다음과 같습니다.

$ ghe-migrator audit -m RECORD_TYPE -s STATE -g MIGRATION-GUID

예를 들어 성공적으로 가져온 모든 조직과 팀을 보려면 다음을 입력합니다.

$ ghe-migrator audit -m organization,team -s mapped,renamed -g MIGRATION-GUID
> model_name,source_url,target_url,state
> organization,https://gh.source/octo-org/,https://ghe.target/octo-org/,renamed

실패한 모든 가져오기를 감사하는 것이 좋습니다. 이렇게 하려면 다음을 입력하세요.

$ ghe-migrator audit -s failed_import,failed_map,failed_rename,failed_merge -g MIGRATION-GUID
> model_name,source_url,target_url,state
> user,https://gh.source/octocat,https://gh.target/octocat,failed
> repository,https://gh.source/octo-org/octo-project,https://ghe.target/octo-org/octo-project,failed

실패한 가져오기에 관한 우려 사항이 있다면 GitHub Enterprise Support에 문의하세요.

GitHub Enterprise Server에서의 가져오기 완료

마이그레이션이 대상 인스턴스에 적용되고 마이그레이션을 검토한 후에는, 리포지토리의 잠금을 해제하고 원본에서 삭제합니다. 원본 데이터를 삭제하기 전에 2주 정도 대기하여 모든 요소가 예상대로 작동하는지 확인하는 것이 좋습니다.

대상 인스턴스에서 리포지토리 잠금 해제

  1. your GitHub Enterprise Server instance에 SSH합니다. 인스턴스가 여러 노드로 구성된 경우(예: 고가용성 또는 지역 복제가 구성된 경우) 주 노드에 대한 SSH를 수행합니다. 클러스터를 사용하는 경우 임의 노드에 대해 SSH를 수행할 수 있습니다. SSH 액세스에 대한 자세한 내용은 “관리 셸(SSH) 액세스”를 참조하세요.

    $ ssh -p 122 admin@HOSTNAME
    1. `ghe-migrator unlock` 명령을 사용하여 가져온 모든 리포지토리의 잠금을 해제합니다. 마이그레이션 GUID가 필요합니다.
    $ ghe-migrator unlock -g MIGRATION-GUID
    > Unlocked octo-org/octo-project

원본에서 리포지토리 잠금 해제

GitHub.com에서 조직의 리포지토리 잠금 해제

GitHub.com 조직에서 리포지토리의 잠금을 해제하려면 DELETE 요청을 마이그레이션 잠금 해제 엔드포인트로 보냅니다. 필요한 사항:

  • 인증용 액세스 토큰
  • 마이그레이션의 고유 id
  • 잠금 해제할 리포지토리의 이름
curl -H "Authorization: Bearer GITHUB_ACCESS_TOKEN" -X DELETE \
  -H "Accept: application/vnd.github.wyandotte-preview+json" \
  https://api.github.com/orgs/ORG-NAME/migrations/ID/repos/REPO_NAME/lock

GitHub.com에서 조직의 리포지토리 삭제

GitHub.com 조직의 리포지토리를 잠금 해제한 후에는 리포지토리 삭제 엔드포인트를 사용하여, 이전에 마이그레이션한 모든 리포지토리를 삭제해야 합니다. 인증용 액세스 토큰이 필요합니다.

curl -H "Authorization: Bearer GITHUB_ACCESS_TOKEN" -X DELETE \
  https://api.github.com/repos/ORG-NAME/REPO_NAME

GitHub Enterprise Server 인스턴스에서 리포지토리 잠금 해제

  1. your GitHub Enterprise Server instance에 SSH합니다. 인스턴스가 여러 노드로 구성된 경우(예: 고가용성 또는 지역 복제가 구성된 경우) 주 노드에 대한 SSH를 수행합니다. 클러스터를 사용하는 경우 임의 노드에 대해 SSH를 수행할 수 있습니다. SSH 액세스에 대한 자세한 내용은 “관리 셸(SSH) 액세스”를 참조하세요.

    $ ssh -p 122 admin@HOSTNAME
    1. `ghe-migrator unlock` 명령을 사용하여 가져온 모든 리포지토리의 잠금을 해제합니다. 마이그레이션 GUID가 필요합니다.
    $ ghe-migrator unlock -g MIGRATION-GUID
    > Unlocked octo-org/octo-project