Skip to main content
Skip to content

Understand migrations from Azure DevOps to GitHub

GitHub Enterprise Importer can automate migrating from Azure DevOps.

About migrations from Azure DevOps Cloud

You can use GitHub Enterprise Importer to migrate repositories from Azure DevOps to GitHub Enterprise Cloud (GitHub.com or GHE.com).

You can only use GitHub Enterprise Importer to migrate from Azure DevOps Cloud, not from Azure DevOps Server. If you currently use Azure DevOps Server and want to migrate to GitHub, you can migrate to Azure DevOps Cloud first. For more information, see Migrate to Azure DevOps on the Azure site.

Before you create your enterprise account on GitHub, decide whether your enterprise will use Enterprise Managed Users. This affects how your members authenticate and how you manage identities and access. See GitHub Enterprise Cloud におけるエンタープライズ種別の選択.

To learn more about the differences between GitHub and Azure DevOps, see Key differences between Azure DevOps and GitHub.

Alternative tooling for migrations to GHE.com

This journey describes migrations with GitHub Enterprise Importer. If downtime is a concern, Enterprise Live Migrations is an alternative tool that keeps repositories available to developers for most of the migration. See GitHub Enterprise Server から GHE.com へのライブ マイグレーションについて.

ELM for Azure DevOps is in パブリック プレビュー and only supports migrations to GHE.com, not GitHub.com. For more information, see Enterprise live migrations overview in the Microsoft Learn documentation.

Support for Azure Pipelines and Azure Boards

Both Azure Pipelines and Azure Boards can be fully integrated with your GitHub experience. You can configure your enterprise account and Azure DevOps so you can keep using these services while also benefitting from having your repositories hosted on GitHub.

If you want to migrate Azure Pipelines to GitHub Actions, contact your GitHub account manager.

Data that is migrated

GitHub Enterprise Importer currently supports migrating the following repository data from Azure DevOps to GitHub Enterprise Cloud.

  • Git source (including commit history)
  • Pull requests
  • User history for pull requests
  • Work item links on pull requests
  • Attachments on pull requests
  • Branch policies for the repository (user-scoped branch policies and cross-repo branch policies are not included)

移行されたデータに関する制限

移行できる GitHub Enterprise Importer には制限があります。 GitHubの制限に起因するものもあれば、GitHub Enterprise Importer自体の制限によるものです。

GitHub の制限事項

  • 1 つの Git コミットに対する 2 GiB サイズの制限: Git リポジトリ内の 1 つのコミットは、2 GiB を超える可能性はありません。 いずれかのコミットが 2 GiB を超える場合は、コミットを 2 GiB 以下の小さなコミットに分割する必要があります。
  • 1 回のプッシュで 2 GiB のサイズ制限: 1 回のプッシュは 2 GiB より大きくすることはできません。 大きいプッシュは、 pack exceeds maximum allowed size エラーで失敗します。
  • Git 参照の 255 バイトの制限: 255 バイトを超える名前を持つ Git 参照 (一般に "ref" と呼ばれる) は 1 つもありません。 通常、これは、参照の長さ 255 文字を超えることはできませんが、絵文字などの ASCII 以外の文字が複数のバイトを消費する可能性があることを意味します。 いずれかの Git 参照が大きすぎる場合は、明確なエラー メッセージが返されます。
  • 100 MiB ファイル サイズの制限: 移行が完了すると、Git リポジトリ内の 1 つのファイルは 100 MiB を超えなくなります。 リポジトリの移行中に、この制限は 400 MiB に引き上げられます。 Git LFSを使用して大きなファイルを格納することを検討してください。

GitHub Enterprise Importer の制限事項

  • Git リポジトリの 40 GB のサイズ制限 (パブリック プレビュー): この制限はソース コードにのみ適用されます。 リポジトリ アーカイブが制限を超えているかどうかをチェックするには、git-sizer ツールを使用して出力の合計 BLOB サイズを確認します。 git-sizer ツールは、大きなファイル、BLOB サイズ、コミット サイズ、移行に影響する恐れがあるツリー数に関連する潜在的な問題を特定することにも役立ちます。
  • **400 MiB ファイル サイズの制限:**GitHub Enterprise Importerを使用してリポジトリを移行する場合、Git リポジトリ内の 1 つのファイルが 400 MiB を超える可能性はありません。 大きなファイルを格納するために Git LFS を使用することを検討してください。
  • **Git LFSオブジェクトは移行されません:**ImporterはGit LFSを使用するリポジトリを移行できますが、LFS オブジェクト自体は移行されません。 これらは、移行完了後にフォローアップ タスクとして移行先にプッシュできます。
  • 遅延コード検索機能: リポジトリ移行後の検索インデックスの再作成には数時間かかることがあります。また、インデックスの再作成が完了するまで、コード検索で予期しない結果が返される可能性があります。
  • Organization 用に構成されたルールセットによって移行が失敗する可能性がある: たとえば、コミット作成者のメール アドレスが @monalisa.cat で終わるように要求するルールを構成し、移行するリポジトリにこのルールに準拠していないコミットが含まれている場合、移行は失敗します。
  • マネキンの内容が検索できない場合あり: マネキンは、インポートされた内容 (問題、pull request、コメントなど) が関連付けられているプレースホルダー ユーザーです。 割り当てられた問題など、マネキンに関連付けられている内容を検索しても、問題が見つからない可能性があります。 マネキンが回収されると、新しい所有者を介してコンテンツが見つかります。