HOWTO: Migrate from Jfrog Artifactory to ProGet
Migrating a JFrog Artifactory 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 Jfrog Artifactory repositories to ProGet, offering several methods depending on the package type.
Generating Your API Token
Migrating your packages from JFrog Artifactory using any of the methods listed in this article will require a JFrog Artifactory API token. This step is also required to find the URL you will need for configuring a connector, covered later in this article.
This article will explain how to acquire an API token from a NuGet repository, although doing so for other packages is conceptually the same.
From JFrog Artifactory, navigate to "Artifacts" and select your "local" NuGet repository. In this case, named test-nuget-local
. From here select "Set Me Up".
Next, select "Generate Token & Create Instructions", and copy the API token generated. If you plan to configure a connector, also copy the URL.
Migrating NuGet, NPM or Maven Packages from Jfrog Artifactory 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 Jfrog Artifactiory username and the API token we generated above, along with the server URL of your repository (e.g. example.jfrog.io
).
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 Jfrog Artifactory
As we will be connecting to our Jfrog Artifactiory 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 "Jfrog Artifactory", which will configure ProGet to migrate your packages from Jfrog Artifactory.
Step 3: Migrate Your Packages
Now enter your Artifactory Server URL (e.g. https://example.jfrog.io
), your username and the API 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-local
. Then select "Confirm Import".
Finally, select "Begin Import". ProGet will now migrate all of your Jfrog Artifactory 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 Jfrog Artifactory, 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 Artifactory
To download your packages from Artifactory, start by navigating to Packages, and then search by name (or filter by package type).
Select a package you want to download and then select the download icon. Repeat this step as necessary for all packages you want to migrate to ProGet.
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 Jfrog Artifactory 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 Jfrog Artifactory, however connecting to any other package repository is conceptually the same.
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 as well as your full connector URL (e.g. https://example.jfrog.io/artifactory/api/pypi/test-pypi-local
) and API Token, both of which you will have copied in this step.
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.
ProGet can connect to any repositories — including Jfrog’s artifactory — which makes migration and parallel usage easy, but you can also use our professional services to help with the migration, and we have a Migration Guide from Jfrog to ProGet.