필수 조건
- 이 가이드의 이전 단계를 모두 완료해야 합니다.
- 마이그레이션될 데이터와 가져오기 도구의 알려진 지원 제한 사항을 이해했는지 확인하세요. 자세한 내용은 1단계. Azure DevOps에서 GitHub로의 마이그레이션 이해을(를) 참조하세요.
- 필수는 아니지만 프로덕션 마이그레이션 중에는 작업을 중지하는 것이 좋습니다. Importer은(는) 델타 마이그레이션을 지원하지 않으므로 마이그레이션 중에 발생하는 변경 내용은 마이그레이션되지 않습니다. 프로덕션 마이그레이션 중에 작업을 중단하지 않도록 선택하는 경우, 이러한 변경 내용을 수동으로 마이그레이션해야 합니다.
마이그레이션 스크립트 생성
데이터 재사용 가능.엔터프라이즈-마이그레이션-도구.마이그레이션-스크립트-생성 %}
마이그레이션 스크립트를 생성하려면 gh ado2gh generate-script 명령을 실행하세요.
gh ado2gh generate-script --ado-org SOURCE --github-org DESTINATION --output FILENAME
gh ado2gh generate-script --ado-org SOURCE --github-org DESTINATION --output FILENAME
명령 내의 자리 표시자를 다음 값으로 바꿉니다.
| 자리 표시자 | 값 |
|---|---|
| SOURCE | 원본 조직의 이름 |
| 대상 | 대상 조직의 이름 |
| FILENAME | 결과 마이그레이션 스크립트의 파일 이름 터미널을 사용하는 경우 생성된 스크립트에서 PowerShell을 실행해야 하므로 .ps1 파일 확장을 사용합니다. Mac 또는 Linux용 PowerShell을 설치할 수 있습니다. |
추가 인수
| Argument | Description |
|---|---|
--target-api-url TARGET-API-URL | GHE.com로 마이그레이션하는 경우 --target-api-url TARGET-API-URL을(를) 추가합니다. 여기서 TARGET-API-URL은 엔터프라이즈 하위 도메인의 기본 API URL입니다. 예: https://api.octocorp.ghe.com |
--all | 파이프라인 재연결, 팀 생성, Azure Boards 통합 구성 등 스크립트에 추가 기능을 더합니다. |
--download-migration-logs | 마이그레이션된 각 리포지토리에 대한 마이그레이션 로그를 다운로드합니다. 마이그레이션 로그에 대한 자세한 내용은 GitHub Enterprise Importer에 대한 마이그레이션 로그 액세스을(를) 참조하세요. |
마이그레이션 스크립트 검토
스크립트를 생성한 후, 파일을 검토하고 필요에 따라 스크립트를 편집합니다.
- 마이그레이션하지 않으려는 리포지토리가 있는 경우, 해당 줄을 삭제하거나 주석 처리합니다.
- 리포지토리가 대상 조직에 다른 이름을 갖도록 하려면 해당
--target-repo플래그 값을 업데이트합니다. - 새 리포지토리의 표시 유형을 변경하려면 해당
--target-repo-visibility플래그의 값을 업데이트합니다. 기본적으로 스크립트는 원본 리포지토리와 동일한 표시 여부를 설정합니다.
시험 실행 수행
데이터 재사용 가능 항목.기업-이전-도구.마이그레이션-실행하기 %}
-
평가판 마이그레이션을 위한 테스트 조직을 만듭니다.
모든 평가판 실행에 단일 조직을 사용하거나, 의도한 각 대상 조직에 대해 하나의 테스트 조직을 만들 수 있습니다. 조직이 프로덕션이 아닌 마이그레이션 유효성 검사를 위한 것임을 명확히 하려면 조직 이름의 끝에
-sandbox을(를) 포함시키는 것이 좋습니다. 완료한 후, 테스트 조직을 삭제할 수 있습니다. -
평가판 마이그레이션을 실행합니다.
-
[AUTOTITLE](/migrations/ado/phase-6-follow-up-tasks)에서 후속 작업을 완료할 수 있는지 확인합니다. -
사용자에게 마이그레이션 결과가 유효한지 검사하도록 요청합니다.
-
평가판 마이그레이션에서 발견한 문제를 해결합니다.
-
필요에 따라 테스트 조직을 삭제합니다.
리포지토리 마이그레이션
평가판 실행이 성공했고 후속 작업을 완료할 수 있는 경우 실제 마이그레이션을 진행할 수 있습니다.
경고
마이그레이션하는 리포지토리에서 작업을 중지하는 것이 좋습니다. 마이그레이션 도중 또는 이후에 변경된 내용은 수동으로 마이그레이션해야 합니다.
여러 리포지토리를 마이그레이션하려면 생성한 스크립트를 실행합니다. 아래 명령의 FILENAME을 스크립트를 생성할 때 제공받은 파일 이름으로 바꿉니다.
-
터미널을 사용하는 경우,
./을(를) 사용하세요.Shell ./FILENAME
./FILENAME -
PowerShell을 사용하는 경우
.\을(를) 사용하세요.Shell .\FILENAME
.\FILENAME
다음 단계:
다음 및 최종 단계에서는 후속 작업을 수행하고, 로그를 확인하고, 리포지토리를 사용할 준비가 됩니다. 6단계. 후속 작업을(를) 참조하세요.