GraphQL を使用して Azure DevOps から GitHub Enterprise Cloud にリポジトリを移行する

メモ

ADO2GH extension of the GitHub CLI を使用して移行を実行することもできます。「フェーズ 1: Azure DevOps から GitHub への移行について」を参照してください。

手順 0: GitHub GraphQL API を使う準備をする

GraphQL クエリを作成するには、独自のスクリプトを記述するか、Insomnia などの HTTP クライアントを使う必要があります。

認証方法など、GitHub GraphQL API の概要については、「GraphQLでの呼び出しの作成」を参照してください。

すべての GraphQL クエリを、移行先に送信します。データ所在地付き GitHub Enterprise Cloud に移行する場合は、GHE.com のエンタープライズのサブドメインのエンドポイントにクエリを送信してください。

手順 1: 移行先の`ownerId` を取得する

GitHub Enterprise Cloud の Organization 所有者として、GetOrgInfo クエリを使って、移行されたリポジトリを所有する Organization の ownerId (Organization ID とも呼ばれます) を取得します。移行先を識別するには、ownerId が必要です。

`GetOrgInfo` クエリ

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

クエリ変数	説明
`login`	Organization の名前。

`GetOrgInfo` の応答

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

この例では、MDEyOk9yZ2FuaXphdGlvbjU2MTA= が Organization ID つまり ownerId であり、次のステップでそれを使います。

手順 2: 移行元の場所を特定する

移行元を特定するためのイントロを次に示します。

移行ソースは ADO 組織です。

          `createMigrationSource` ミューテーション

mutation createMigrationSource($name: String!, $ownerId: ID!) {
  createMigrationSource(input: {name: $name, url: "https://dev.azure.com", ownerId: $ownerId, type: AZURE_DEVOPS}) {
    migrationSource {
      id
      name
      url
      type
    }
  }
}

メモ

type には AZURE_DEVOPS を使用するようにしてください。

クエリ変数	説明
`name`	移行元の名前。この名前は自分の参照用であるため、任意の文字列を使用できます。
`ownerId`	GitHub Enterprise Cloud での Organization の Organization ID。

          `createMigrationSource` 応答

{
  "data": {
    "createMigrationSource": {
      "migrationSource": {
        "id": "MS_kgDaACQxYmYxOWU4Yi0wNzZmLTQ3NTMtOTdkZC1hNGUzZmYxN2U2YzA",
        "name": "Azure DevOps Source",
        "url": "https://dev.azure.com",
        "type": "AZURE_DEVOPS"
      }
    }
  }
}

この例では、MS_kgDaACQxYmYxOWU4Yi0wNzZmLTQ3NTMtOTdkZC1hNGUzZmYxN2U2YzA が移行元 ID であり、次の手順で使います。

手順 3: リポジトリの移行を開始する

リポジトリ移行を開始する

          `startRepositoryMigration` ミューテーション

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

クエリ変数	説明
`sourceId`	`createMigrationSource` ミューテーションから返された移行元の `id`。
`ownerId`	GitHub Enterprise Cloud での Organization の Organization ID。
`repositoryName`	GitHub Enterprise Cloud 上で Organization が所有するどのリポジトリでも現在使われていない一意のカスタムリポジトリ名。移行が完了または停止すると、このリポジトリにエラーログ issue が作成されます。
`continueOnError`	移行の失敗を引き起こさないエラーが発生したときに移行を続行できるようにする移行設定。 `true` または `false` である必要があります。 Importer が Git ソースを移動できない場合、または Importer が接続を失い、移行を完了するために再接続できない場合を除き、移行が続けられるように、`continueOnError` を `true` に設定することを強くお勧めします。
`githubPat`	GitHub Enterprise Cloud 上の移行先 Organization の personal access token。
`accessToken`	移行元の personal access token。
`targetRepoVisibility`	新しいリポジトリの可視性。 `private`、`public`、または `internal` にする必要があります。設定されていない場合、リポジトリはプライベートとして移行されます。
`sourceRepositoryUrl`	`https://dev.azure.com/{organization}/{project}/_git/{repository}` 形式を使ったソースリポジトリの URL。

personal access token の要件については、「フェーズ 2：アクセスを管理する」をご覧ください。

次のステップでは、startRepositoryMigration ミューテーションから返された移行 ID を使って、移行の状態を調べます。

手順 4: 移行の状態を確認する

移行エラーを検出し、移行が行われていることを確認するには、getMigration クエリを使って移行の状態を調査できます。また、getMigrations を使うと、複数の移行の状態を調べることもできます。

getMigration クエリから返される状態を調べて、移行が queued、in progress、failed、または completed であるかどうかを確認できます。移行が失敗した場合、Importer によってエラーの原因が示されます。

`getMigration` クエリ

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

クエリ変数	説明
`id`	`startRepositoryMigration` ミューテーションが返した移行の `id`。

手順 5: 移行を検証し、エラーログを確認する

データ再利用可能.企業移行ツール.移行ログを検証 %}

詳細については、次を参照してください。

        [AUTOTITLE](/migrations/ado/phase-6-follow-up-tasks)

        [AUTOTITLE](/migrations/ado/key-differences-between-azure-devops-and-github)

GraphQL を使用して Azure DevOps から GitHub Enterprise Cloud にリポジトリを移行する

この記事で