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

API를 사용하도록 선택하는 경우 사용자 고유의 스크립트를 작성하거나 불면증과 같은 HTTP 클라이언트를 사용해야 합니다. "REST API 시작" 및 "GraphQL을 사용하여 통화 구성"에서 GitHub의 API를 시작하는 방법에 대해 자세히 알아볼 수 있습니다.

API를 사용하여 GitHub Enterprise Server에서 GitHub Enterprise Cloud(으)로 리포지토리를 마이그레이션하려면 다음과 같이 하세요.

1. 원본 및 대상 조직 모두에 대한 personal access token 만들기
2. GitHub Enterprise Cloud 관련 대상 조직의 ownerId 가져오기
3. GitHub의 GraphQL API를 통해 마이그레이션 원본을 설정하여 마이그레이션이 어디에서 왔는지 식별합니다
4. 마이그레이션하려는 각 리포지토리에 대해 다음 단계를 반복합니다.
   • GitHub Enterprise Server 인스턴스의 REST API를 사용하여 리포지토리에 대한 마이그레이션 보관 파일을 생성합니다
   • GitHub을(를) 통해 액세스할 수 있는 위치에 마이그레이션 보관 파일을 업로드합니다
   • 마이그레이션 대상에 대한 GraphQL API를 사용하여 보관 URL을 전달하여 마이그레이션을 시작합니다.
   • GraphQL API를 통해 마이그레이션 상태 확인
   • 마이그레이션 유효성 검사 및 오류 로그 검사

GitHub CLI을(를) 사용하는 방법에 대한 지침을 보려면 페이지 맨 위에 있는 도구 전환기를 사용합니다.

1단계. personal access token 만들기

1. GitHub Enterprise Cloud에서 대상 조직에 대해 인증할 personal access token (classic)을(를) 만들고 기록하여 토큰이 모든 요구 사항을 충족하는지 확인합니다. 자세한 내용은 "GitHub 제품 간의 마이그레이션에 대한 액세스 관리"을(를) 참조하세요.
2. 원본 조직에 대해 인증할 personal access token을(를) 만들고 기록하여 이 토큰이 동일한 요구 사항을 모두 충족하는지 확인합니다.

2단계: 대상 조직에 대한 ownerId 가져오기

GitHub Enterprise Cloud의 조직 소유자는 마이그레이션된 리포지토리를 소유하려는 조직의 조직 ID라고도 하는 GetOrgInfo 쿼리를 ownerId에 반환합니다. 마이그레이션 대상을 식별하려면 ownerId이(가) 필요합니다.

GetOrgInfo 쿼리

query(
  $login: String!
){
  organization (login: $login)
  {
    login
    id
    name
    databaseId
  }
}

GetOrgInfo 응답

{
  "data": {
    "organization": {
      "login": "Octo",
      "id": "MDEyOk9yZ2FuaXphdGlvbjU2MTA=",
      "name": "Octo-org",
      "databaseId": 5610
    }
  }
}

이 예제에서는 MDEyOk9yZ2FuaXphdGlvbjU2MTA=이(가) 다음 단계에서 사용할 조직 ID 또는 ownerId입니다.

3단계: Blob Storage 설정

GitHub Enterprise Server 3.8 버전 이상에 대한 많은 GitHub Enterprise Server 인스턴스가 방화벽 뒤에 있기 때문에 Blob Storage를 중간 위치로 사용하여 GitHub에서 액세스할 수 있는 데이터를 저장합니다.

먼저 지원되는 클라우드 공급자를 사용하여 Blob Storage를 설정한 다음 GitHub Enterprise Server 인스턴스의 관리 콘솔에서 설정을 구성해야 합니다.

지원되는 클라우드 공급자를 사용한 Blob Storage 설정

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

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

AWS S3 스토리지 버킷 설정

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

또한 다음 권한이 있는 AWS 액세스 키 및 비밀 키가 필요합니다.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "VisualEditor0",
            "Effect": "Allow",
            "Action": [
                "s3:PutObject",
                "s3:GetObject",
                "s3:ListBucketMultipartUploads",
                "s3:AbortMultipartUpload",
                "s3:ListBucket",
                "s3:DeleteObject",
                "s3:ListMultipartUploadParts"
            ],
            "Resource": [
                "arn:aws:s3:::github-migration-bucket",
                "arn:aws:s3:::github-migration-bucket/*"
            ]
        }
    ]
}

Azure Blob Storage 계정

Azure에서 스토리지 계정을 만들고 연결 문자열을 기록해 둡니다. 자세한 내용은 Microsoft Docs의 스토리지 계정 액세스 키 관리를 참조하세요.

GitHub Enterprise Server 인스턴스의 관리 콘솔에서 Blob Storage 구성

AWS S3 스토리지 버킷 또는 Azure Blob Storage 스토리지 계정을 설정한 후 관리 콘솔의 GitHub Enterprise Server 인스턴스에서 Blob Storage를 구성합니다. 관리 콘솔에 대한 자세한 내용은 "관리 콘솔에서 인스턴스 등록"을 참조하세요.

1. 페이지의 오른쪽 상단에 있는 GitHub Enterprise Server의 관리 계정에서 을 클릭합니다.

2. "사이트 관리자" 페이지에 아직 없는 경우 왼쪽 위 모서리에서 사이트 관리자를 클릭합니다. 1. " 사이트 관리자" 사이드바에서 관리 콘솔 을 클릭합니다.

3. 관리 콘솔 로그

4. 위쪽 탐색 모음에서 설정을 클릭합니다.

5. 마이그레이션에서 {% data variables.product.company_short %} 마이그레이션 사용을 클릭합니다.

6. 필요에 따라 GitHub Actions에 대해 구성한 스토리지 설정을 가져오려면 작업에서 스토리지 설정 복사를 선택합니다. 자세한 내용은 "Azure Blob Storage에서 GitHub Actions 사용" 및 "Amazon S3 스토리지에서 GitHub Actions 사용"을 참조하세요.

   참고: 스토리지 설정을 복사한 후에도 GitHub Enterprise Importer에서 작동하도록 클라우드 스토리지 계정의 구성을 업데이트해야 할 수 있습니다. 특히 GitHub의 IP 주소가 허용 목록에 있는지 확인해야 합니다. 자세한 내용은 "GitHub 제품 간의 마이그레이션에 대한 액세스 관리"을(를) 참조하세요.

7. GitHub Actions에서 스토리지 설정을 가져오지 않는 경우 Azure Blob Storage 또는 Amazon S3 중 하나를 선택하고 필요한 세부 정보를 입력합니다.

   참고: Amazon S3를 사용하는 경우, 버킷이 있는 AWS 지역의 표준 엔드포인트로 "AWS 서비스 URL"을 설정해야 합니다. 예를 들어 버킷이 eu-west-1 지역에 있는 경우, "AWS 서비스 URL"이 https://s3.eu-west-1.amazonaws.com이(가) 됩니다. GitHub Enterprise Server 인스턴스의 네트워크에서 이 호스트에 대한 액세스를 허용해야 합니다. 게이트웨이 엔드포인트는 지원되지 않습니다(예: bucket.vpce-0e25b8cdd720f900e-argc85vg.s3.eu-west-1.vpce.amazonaws.com). 게이트웨이 엔드포인트에 대한 자세한 내용은 AWS 설명서에서 Amazon S3용 게이트웨이 엔드포인트를 참조하세요.

8. 스토리지 설정 테스트를 클릭합니다.

9. 설정 저장을 클릭합니다.

네트워크 액세스 허용

스토리지 계정에 방화벽 규칙을 구성한 경우 마이그레이션 대상의 IP 범위에 대한 액세스를 허용했는지 확인합니다. "GitHub 제품 간의 마이그레이션에 대한 액세스 관리" 항목을 참조하세요.

4단계: GitHub Enterprise Cloud에서 마이그레이션 원본 설정

createMigrationSource 쿼리를 사용하여 마이그레이션 원본을 설정할 수 있습니다. GetOrgInfo 쿼리에서 수집된 조직 ID 또는 조직 ID를 ownerId에 제공해야 합니다.

마이그레이션 원본은 GitHub Enterprise Server의 조직입니다.

createMigrationSource 변형

mutation createMigrationSource($name: String!, $url: String!, $ownerId: ID!) {
  createMigrationSource(input: {name: $name, url: $url, ownerId: $ownerId, type: GITHUB_ARCHIVE}) {
    migrationSource {
      id
      name
      url
      type
    }
  }
}

createMigrationSource 응답

{
  "data": {
    "createMigrationSource": {
      "migrationSource": {
        "id": "MS_kgDaACRjZTY5NGQ1OC1mNDkyLTQ2NjgtOGE1NS00MGUxYTdlZmQwNWQ",
        "name": "GHES Source",
        "url": "https://my-ghes-hostname.com",
        "type": "GITHUB_ARCHIVE"
      }
    }
  }
}

이 예제에서 MS_kgDaACRjZTY5NGQ1OC1mNDkyLTQ2NjgtOGE1NS00MGUxYTdlZmQwNWQ은(는) 이후 단계에서 사용할 마이그레이션 원본 ID입니다.

5단계: GitHub Enterprise Server 인스턴스에서 마이그레이션 보관 파일 생성

REST API를 사용하여 GitHub Enterprise Server에서 두 가지 "마이그레이션"을 시작합니다. 하나는 리포지토리의 Git 원본 보관 파일을 생성하고, 다른 하나는 리포지토리의 메타데이터 보관 파일(예: 문제 및 끌어오기 요청)을 생성합니다.

Git 원본 보관 파일을 생성하려면 https://HOSTNAME/api/v3/orgs/ORGANIZATION/migrations에 POST을(를) 요청하고, HOSTNAME을(를) GitHub Enterprise Server 인스턴스의 호스트 이름 및 조직 로그인이 포함된 ORGANIZATION으(로) 바꿉니다.

본문에서 마이그레이션할 단일 리포지토리를 지정합니다. 요청은 다음과 같이 표시됩니다.

POST /api/v3/orgs/acme-corp/migrations HTTP/1.1
Accept: application/vnd.github+json
Authorization: Bearer <TOKEN>
Content-Type: application/json
Host: github.acmecorp.net

{
  "repositories": ["repository_to_migrate"],
  "exclude_metadata": true
}

메타데이터 보관 파일을 생성하려면 다음 본문을 사용하여 동일한 URL에 유사한 요청을 보냅니다.

{
  "repositories": ["repository_to_migrate"],
  "exclude_git_data": true,
  "exclude_releases": false,
  "exclude_owner_projects": true
}

이러한 두 API 호출은 각각 시작한 마이그레이션의 ID를 포함하여 JSON 응답을 반환합니다.

HTTP/1.1 201 Created

{
  "id": 123,
  // ...
}

자세한 내용은 "조직 마이그레이션 시작"을 참조하세요.

데이터 양에 따라 보관 파일을 생성하는 데 시간이 걸릴 수 있습니다. 마이그레이션의 state이(가) exported(으)로 변경될 때까지 "조직 마이그레이션 상태 가져오기" API를 사용하여 두 마이그레이션의 상태를 정기적으로 검사할 수 있습니다.

GET /api/v3/orgs/acme-corp/migrations/123 HTTP/1.1
Accept: application/vnd.github+json
Authorization: Bearer <TOKEN>
Host: github.acmecorp.net

HTTP/1.1 200 OK
Content-Type: application/json

{
  "id": 123,
  "state": "exported",
  // ...
}

자세한 내용은 "조직 마이그레이션 상태 가져오기"를 참조하세요.

마이그레이션의 state이(가) exported(으)로 이동한 후 "조직 마이그레이션 보관 다운로드" API를 사용하여 마이그레이션의 URL을 가져올 수 있습니다.

GET /api/v3/orgs/acme-corp/migrations/123/archive HTTP/1.1
Accept: application/vnd.github+json
Authorization: Bearer <TOKEN>
Host: github.acmecorp.net

HTTP/1.1 302 Found
Location: https://media.github.acmecorp.net/migrations/123/archive/cca2ebe9-7403-4ffa-9b6a-4c9e16c94410?token=AAAAABEWE7JP4H2HACKEGMTDOYRC6

API는 다운로드 가능한 보관 파일이 있는 URL로 리디렉션되는 Location 헤더와 함께 302 Found 응답을 반환합니다. Git 원본용 파일과 메타데이터용 파일의 두 파일을 다운로드합니다.

자세한 내용은 "조직 마이그레이션 보관 파일 다운로드"를 참조하세요.

두 마이그레이션이 모두 완료되고 보관 파일을 다운로드한 후에는 다음 단계로 이동할 수 있습니다.

6단계: 마이그레이션 보관 파일 업로드

데이터를 GitHub Enterprise Cloud(으)로 가져오려면 GraphQL API를 사용하여 컴퓨터의 각 리포지토리(Git 원본 및 메타데이터)에 대한 보관 파일을 GitHub(으)로 전달해야 합니다.

GitHub Enterprise Server 3.7 이하를 사용하는 경우 먼저 GitHub에 따라 액세스할 수 있는 보관 파일에 대한 URL을 생성해야 합니다. 대부분의 고객은 Amazon S3 또는 Azure Blob Storage와 같은 클라우드 공급자의 Blob Storage 서비스에 보관 파일을 업로드한 다음 각각에 대해 단기 URL을 생성하도록 선택합니다.

GitHub Enterprise Server 3.8 이상을 사용하는 경우 인스턴스는 보관 파일을 업로드하고 URL을 생성합니다. 이전 단계의 Location 헤더는 단기 URL을 반환합니다.

GitHub의 IP 범위가 허용 목록에 필요할 수 있습니다. 자세한 내용은 "GitHub 제품 간의 마이그레이션에 대한 액세스 관리"을(를) 참조하세요.

7단계: 리포지토리 마이그레이션 시작

마이그레이션을 시작하면 단일 리포지토리와 함께 제공되는 데이터가 사용자가 식별하는 새로운 GitHub 리포지토리로 마이그레이션됩니다.

동일한 원본 조직에서 한 번에 여러 리포지토리를 이동하려는 경우 여러 마이그레이션을 큐에 대기시킬 수 있습니다. 최대 5개까지의 리포지토리 마이그레이션을 동시에 실행할 수 있습니다.

startRepositoryMigration 변형

mutation startRepositoryMigration (
  $sourceId: ID!,
  $ownerId: ID!,
  $repositoryName: String!,
  $continueOnError: Boolean!,
  $accessToken: String!,
  $githubPat: String!,
  $gitArchiveUrl: String!,
  $metadataArchiveUrl: String!,
  $sourceRepositoryUrl: URI!,
  $targetRepoVisibility: String!
){
  startRepositoryMigration( input: {
    sourceId: $sourceId,
    ownerId: $ownerId,
    repositoryName: $repositoryName,
    continueOnError: $continueOnError,
    accessToken: $accessToken,
    githubPat: $githubPat,
    targetRepoVisibility: $targetRepoVisibility
    gitArchiveUrl: $gitArchiveUrl,
    metadataArchiveUrl: $metadataArchiveUrl,
    sourceRepositoryUrl: $sourceRepositoryUrl,
  }) {
    repositoryMigration {
      id
      migrationSource {
        id
        name
        type
      }
      sourceUrl
    }
  }
}

personal access token 요구 사항은 "GitHub 제품 간의 마이그레이션에 대한 액세스 관리"을 참조하세요.

다음 단계에서는 startRepositoryMigration 변형에서 반환된 마이그레이션 ID를 사용하여 마이그레이션 상태를 검사합니다.

8단계: 마이그레이션 상태 확인

마이그레이션 오류를 감지하고 마이그레이션이 작동하는지 확인하려면 getMigration 쿼리를 사용하여 마이그레이션 상태를 검사할 수 있습니다. getMigrations(으)로 여러 마이그레이션의 상태를 검사할 수도 있습니다.

getMigration 쿼리는 상태를 반환하여 마이그레이션이 queued, in progress, failed 또는 completed일지 알려줍니다. 마이그레이션에 실패한 경우 Importer은(는) 실패의 원인을 제공합니다.

getMigration 쿼리

query (
  $id: ID!
){
  node( id: $id ) {
    ... on Migration {
      id
      sourceUrl
      migrationSource {
        name
      }
      state
      failureReason
    }
  }
}

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

마이그레이션이 완료되면, 마이그레이션 로그 리포지토리를 검사하는 것이 좋습니다. 이 문제는 대상 리포지토리의 GitHub에서 생성됩니다.

마지막으로, 마이그레이션된 리포지토리에서 건전성 검사를 검토하는 것이 좋습니다.