Skip to content

project-setup-universal-packages.md

Latest commit

 

History

History
82 lines (53 loc) · 4.2 KB

project-setup-universal-packages.md

File metadata and controls

82 lines (53 loc) · 4.2 KB
title Connect to an Azure Artifacts feed - Universal Packages
description Lean how to set up your project and connect to an Azure Artifacts feed to manage your Universal Packages.
ms.service azure-devops-artifacts
ms.topic how-to
ms.custom pat-reduction
ms.date 01/22/2025
monikerRange azure-devops

Connect to an Azure Artifacts feed - Universal Packages

[!INCLUDE version-eq-azure-devops]

Universal Packages allow developers to store various types of packages beyond the traditional ones like NuGet, npm packages by bundling files into a single Universal Package. Using the Azure CLI, they can then publish their Universal Packages directly from the command line to their Azure Artifacts feed. Universal Packages can vary in size reaching up to 4 TiB, but they must always have a name and a version number. This article guides you through setting up your project and connecting to an Azure Artifacts feed to manage your Universal Packages.

Prerequisites

Product Requirements
Azure DevOps - An Azure DevOps organization.
- An Azure DevOps project.
- Download and install Azure CLI.
- Install the Azure DevOps extension version 0.14.0 or higher.

Install Azure DevOps extension

Ensure that you have Azure CLI installed, then follow the steps below to install the Azure DevOps extension for managing Azure DevOps services from the command line.

  1. Run the following command to install the Azure DevOps extension:

    az extension add --name azure-devops

  2. Run the following command if the Azure DevOps extension is already installed and you want to update it to the latest version:

    az extension update --name azure-devops

Connect to a feed

  1. Sign in to your Azure DevOps organization, and then navigate to your project.

  2. Select Artifacts, and then select your feed from the dropdown menu.

  3. Select Connect to feed, and then select Universal Packages from the left navigation pane.

  4. In the Project setup section, select Windows if you're using a Windows device, otherwise select Other.

    Windows

    1. Run the following command to sign in to the Azure CLI:

      az login

    2. Run the following command to set your project and organization as the CLI's default configuration:

      az devops configure --defaults project=<YOUR_PROJECT_NAME> organization=https://dev.azure.com/<YOUR_ORGANIZATION_NAME>

    [!TIP] If you're having troubles logging in with your Microsoft Entra or MSA identity, switch to the Other tab and follow the instructions to authenticate with a Personal Access Token.

    Other

    1. Generate a Personal Access Token with Packaging > Read & write scopes, and copy it to your clipboard.

    2. Run the following command to log in, then when prompted paste the Personal Access Token you created in the previous step, and press Enter.

      az devops login --organization https://dev.azure.com/<YOUR_ORGANIZATION_NAME>

Next steps

[!div class="nextstepaction"] Publish Universal Packages