HOWTO: Migrate from Azure DevOps to ProGet
Migrating an Azure DevOps repository to ProGet can be done in a matter of minutes using ProGet’s Feed Importer feature. This feature allows packages from a remote feed to be downloaded to a local feed.
This article will guide you through how to use the Feed Importer feature to migrate packages from your Azure DevOps repositories to ProGet, offering several methods depending on the package type.
Generating your Personal Access Token
Migrating your packages from Azure DevOps using any of the methods listed in this article will require a Personal Access Token.
From Azure DevOps, navigate to "Settings" and select "Personal Access Tokens".
Now select "New Token" from the top right and then configure the details of your token. Once this is done select "Create".
Finally, make sure you copy the Personal Access Token provided.
Migrating NuGet, NPM or Maven Packages from Azure DevOps to ProGet
Migrating your NuGet, NPM or Maven packages can be done quickly and easily, in only a few clicks. All you will need is your Azure DevOps organization name and the Personal Access Token we generated above.
Step 1: Create a New Feed
To begin we'll create a new feed that we will import our existing packages to. Start by navigating to "Feeds" and selecting "New Feed".
Then select the package type. In this case, we will select "NuGet (.NET) Packages".
Step 2: Connect to Azure DevOps
As we will be connecting to our Azure DevOps repository, select "Connect to Another Feed".
Next, select "Import Packages from Another Feed".
Then name your feed. In this case, we will call it internal-nuget.
Now select "Azure Artifacts", which will configure ProGet to migrate your packages from Azure DevOps.
Step 3: Migrate Your Packages
Now enter your organization name and the Personal Access Token you generated here.
Next, select the repository of your NuGet packages. ProGet will automatically filter your NuGet repository from others, making it easier to find and select. In this case, our repository name is test-nuget. Then select "Confirm Import".
Finally, select "Begin Import". ProGet will now migrate all of your Azure DevOps packages. Navigate to "Feeds" and the internal-nuget feed you created, where it will list all migrated packages.
Migrating Other Packages to ProGet
Due to limitations in API, other packages (e.g. PyPi, Conda, etc) will require alternative approaches to migrate your packages. However, these too remain quick and easy to do. For these packages, you have two choices:
- Upload packages in bulk from another source
- Configure a connector to allow tools to download/pull packages directly from ProGet
Uploading via Bulk Upload
Using ProGet's bulk upload function you can download packages from Azure DevOps, and then upload them in bulk to ProGet. Here we will show how to bulk upload PyPi packages, although uploading other packages is conceptually the same.
Step 1: Download Packages from Azure DevOps
To download your packages from Azure DevOps, start by navigating to "Artifacts", select the appropriate feed (e.g. test-pypi), and then select the package you want to download. In this case, we want to download dummy-py-library
From here, select the file name to download the package.
Step 2: Upload Packages in Bulk
From ProGet, navigate to the feed you want to upload your packages to. If you need to create one follow these steps earlier in this article. From here select "Add Package".
Then select "Bulk Package Import/File Copy".
Next, specify the source of your packages, and select "Import".
Navigating back to the feed, we can see all packages have been uploaded.
Configuring a Connector
An alternative to bulk importing is to set up a connector to your Azure DevOps repository in ProGet. This will allow you to access "legacy" packages if needed by using tools to pull or download packages directly from ProGet, while primarily using the feed to store current versions of packages you are using.
In this article we will connect to a Pypi repository in Azure DevOps, however connecting to any other package repository is conceptually the same.
Step 1: Find Your Connector URL in Azure DevOps
To create a connector you will need your feed-specific connector URL. From Azure DevOps navigate to "Artifacts", select the appropriate feed and then select "Connect to Feed".
For a PyPi feed, select "Twine". Then copy the repository URL from the "Project Setup" section.
Step 2: Configure Your Connector in ProGet
In ProGet, navigate to the feed you want to configure a connector with. If you need to create one follow these steps earlier in this article. From here select "Manage Feed".
From here navigate to "Connectors" and select "add".
Now enter your username, the connector URL from Step 1 and your Personal Access Token you generated here.
Finally, select the "Advanced" tab and check the "Search using package match only", which will allow you to search for packages by name. Then, select "Save".
You have now configured a connector, allowing tools to pull/download packages from ProGet directly.
