Skip to content

project-setup-cargo.md

Latest commit

 

History

History
121 lines (77 loc) · 4.57 KB

project-setup-cargo.md

File metadata and controls

121 lines (77 loc) · 4.57 KB
title Connect your Cargo project to an Azure Artifacts feed
description Learn how to set up your Cargo project and connect to an Azure Artifacts feed.
ms.service azure-devops-artifacts
ms.topic how-to
ms.date 01/21/2025
monikerRange >= azure-devops-2022

Connect your Cargo project to an Azure Artifacts feed

[!INCLUDE version-gt-eq-2022]

This article guides you through setting up your Cargo project, configuring the credential provider, and connecting to an Azure Artifacts feed.

Prerequisites

Product Requirements
Azure DevOps - An Azure DevOps organization.
- An Azure DevOps project.
- Download and install rustup. You'll need Cargo version 1.74.0 or later.

Project setup

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

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

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

  4. Add the provided snippet to your cargo/config.toml in your source repository. Your config.toml file should resemble the following:

    • Project-scoped feed:

      [registries]
FEED_NAME = { index = "sparse+https://pkgs.dev.azure.com/ORGANIZATION_NAME/PROJECT_NAME/_packaging/FEED_NAME/Cargo/index/" }

    • Organization-scoped feed:

      [registries]
FEED_NAME = { index = "sparse+https://pkgs.dev.azure.com/ORGANIZATION_NAME/_packaging/FEED_NAME/Cargo/index/" }

  5. Add the following snippet to your cargo/config.toml to replace the crates.io source with your feed. Replace the placeholder with your feed name:

    [source.crates-io]
replace-with = "FEED_NAME"

Configure a credential provider

To use Cargo with Azure Artifacts, you must first set up a default credential helper. See The Cargo Book for more details.

Windows

Add the following snippet to your %USERPROFILE%.cargo\config.toml. This sets a default credential helper for the user:

[registry]
global-credential-providers = ["cargo:token", "cargo:wincred"]

Linux

Add the following snippet to your /.cargo/config.toml. This sets a default credential helper for the user:

[registry]
global-credential-providers = ["cargo:token", "cargo:libsecret"]

macOS

Add the following snippet to your /.cargo/config.toml. This sets a default credential helper for the user:

[registry]
global-credential-providers = ["cargo:token", "cargo:macos-keychain"]

Log in to the registry

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

  2. Generate a Personal access token with Packaging > Read & write scopes to authenticate with your feed.

  3. Run the following command to log in to your registry. Replace the placeholder with your feed's name, and provide the personal access token you created earlier when prompted:

PowerShell 

"Basic " + [Convert]::ToBase64String([Text.Encoding]::UTF8.GetBytes("PAT:" + (Read-Host -MaskInput "Enter PAT"))) | cargo login --registry <FEED_NAME>

Bash 

read -p "Enter PAT: " PAT; echo Basic $(echo -n PAT:$PAT | base64) | cargo login --registry <FEED_NAME>

Azure CLI

az login
az account get-access-token --query "join(' ', ['Bearer', accessToken])" --output tsv | cargo login --registry <FEED_NAME>

Next steps

[!div class="nextstepaction"] Publish Cargo packages