Get started with NuGet packages in Azure Artifacts

TFS 2018

Azure Artifacts enables developers to publish and download NuGet packages from different sources such as feeds and public registries. With Azure Artifacts, you can create feeds that can be either private, allowing you to share packages with your team and specific users, or public, enabling you to share them openly with anyone on the internet.

In this article, you'll learn how to:

• Create a new feed
• Set up your project and connect to your feed
• Publish NuGet packages
• Download packages from your feed

Prerequisites

• An Azure DevOps organization and a project. Create an organization or a project if you haven't already.

• Install the latest NuGet version.

• Install Azure Artifacts Credential Provider.

Create a feed

Azure Artifacts offers two types of feeds: project-scoped feeds and organization-scoped feeds. if you want to create a public feed, begin by creating a project-scoped feed, and then adjust the visibility settings of the project hosting your feed to public. This will effectively make your project-scoped feed accessible to the public.

Azure Artifacts comes pre-installed in TFS 2018. If this is your first time using your feed, you might be prompted to assign a license.

1. Navigate to your project http://ServerName:8080/tfs/DefaultCollection/<ProjectName>.

2. Select Build & Release, and then select Packages.

3. Select + New feed to create a new feed.

4. Provide a meaningful Name and Description for your feed. Specify the permissions for who can read and who can contribute, and decide whether to Include external packages.

5. Select Create when you're done.

   

Connect to feed

1. Navigate to your project http://ServerName:8080/tfs/DefaultCollection/<ProjectName>.

2. Select Build and Release > Packages.

3. Select your feed from the dropdown menu.

4. Select Connect to feed.

   

5. Select NuGet, and then follow the instruction to connect to your feed.

   

Download packages

1. Get the feed's source URL

1. Select Build and Release, and then select Packages.

2. Select your feed from the dropdown menu.

3. Select Connect to feed, and then copy your Source URL.

   

2. Set up Visual Studio

Windows

1. In Visual Studio, select Tools, and then Options.

2. Expand the NuGet Package Manager section, and then select Package Sources.

3. Enter the feed's Name and the Source URL, and then select the green (+) sign to add a source.

4. If you enabled upstream sources in your feed, clear the nuget.org checkbox.

5. Select OK when you're done.

   

macOS

1. Create a personal access token.

2. In visual studio, select Preferences from the menu bar.

3. Select NuGet, and then select Sources.

4. Select Add and enter your feed's name, the source URL, a userName (any string), and your personal access token.

5. Select OK to save your source.

6. If you enabled upstream sources in your feed, clear the nuget.org checkbox.

7. Select OK when you're done.

   

3. Download packages

1. In Visual Studio, right-click on your project, and then select Manage NuGet Packages.

2. Select Browse, and then select your feed from the Package source dropdown menu.

   

3. Use the search bar to search for packages from your feed.

Publish packages

Run the following command to publish your package to your feed. You can use any string for the ApiKey argument.

nuget.exe push -Source <SOURCE_NAME> -ApiKey key <PACKAGE_PATH>

Related articles

• Publish NuGet packages with Azure Pipelines
• Publish packages to NuGet.org
• NuGet.org upstream source