Migrate data from Azure DevOps Server to Azure DevOps Services

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019 | TFS 2018

The data migration tool for Azure DevOps provides a high fidelity way to migrate collection databases from Azure DevOps Server to Azure DevOps Services. It's recommended that you download the migration guide and tool if you're looking to use this service to import your collection(s). The guide serves as a walk through of the different steps involved in an import. Providing best practices, checklists, and helpful tips to make your import as easy as possible. The guide should be used in conjunction with the more technical documentation referenced below to successfully import to Azure DevOps Services.

Supported Azure DevOps Server versions for import

Important

It can take up to 2-3 weeks after a new RTW version of Azure DevOps Server is released for import support to come online for that version. It's important to take this into consideration when choosing to upgrade shortly after a new RTW Azure DevOps Server release.

The data migration tool for Azure DevOps supports the two latest releases of Azure DevOps Server at a given time. Releases include updates and major releases. Currently the following versions of Azure DevOps Server are supported for import:

  • Azure DevOps Server 2020.1.2
  • Azure DevOps Server 2020.1.1

Note

The data migration tool doesn't support imports from Azure DevOps Server release candidates (RC). If you're planning on importing your collection database to Azure DevOps Services using this service, it's important that you don't upgrade your production database to an RC release. If you do upgrade, then you will need to wait and upgrade to the release to web (RTW) version when it's available or restore a backup copy of your database from a previous Azure DevOps Server version to import.

Normal release cadence for new Azure DevOps Server versions is once every three-to-four months. Meaning that support for a given version of Azure DevOps Server for migration to Azure DevOps Services should last for anywhere between six-to-eight months. It's important to ensure that your planning accounts for this support window to avoid having to suddenly upgrade to migrate.

Preview features

Note

If you're not including preview features when running the migration tool, then you will need to re-run the migration tool prepare to generate a new import.json to queue an import. You DO NOT need to include preview features when you re-generate your import.json.

If you had previously been including preview features then you DO NOT need to take any additional actions after Monday, April 23, 2020.

The following features can be included with your import, but are currently in a preview state.

  • Analytics - Note this is only supported for Azure DevOps Server 2019 and later.

When queueing an import you can elect to include preview features with your import. If you do, data related to these features will be copied into your new organization along with all your other data. Should you choose to not include these features then their data will not be copied.

For a list of items not included with an import, see the migration guide and tool.

Data migration tool for Azure DevOps resources

In general you should use the Migration guide and tool when going through an import. When it's required, the guide links back to the following articles. These articles offer deeper technical knowledge on various import topics.

Import process

Troubleshooting

Q & A

Q: Will my Personal Access Tokens also migrate when I migrate from on-premises to Azure DevOps Services?

A: No. Your tokens will not migrate and you will need to regenerate your Personal Access Tokens on Azure DevOps Services.

Q: If I have feedback or additional questions is there somewhere I can reach out?

A: You can search the developer community portal to see if your question is asked and answered and if not, please open up a new issue. If you need assistance with a failed import, please contact Azure DevOps customer support.