Publier et restaurer des packages Cargo

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022

En utilisant Azure Artifacts, vous pouvez publier et restaurer des packages Cargo à partir de vos propres flux et registres publics tels que crates.io. Utilisez Azure Artifacts pour héberger des caisses internes, vous connecter aux registres en amont et gérer l’accès aux packages à partir d’un seul flux. Ce guide de démarrage rapide vous guide tout au long de la création d’un flux, de la configuration de votre projet Cargo et de la publication et de la consommation de packages Cargo à l’aide de Azure Artifacts.

Prérequis

Créer un flux

Si vous disposez déjà d’un flux Azure Artifacts, accédez à la section suivante. Dans le cas contraire, procédez comme suit pour créer un flux. Azure Artifacts recommande d’utiliser un flux pour consommer des crates provenant de registres publics tels que crates.io, et un flux distinct pour publier des crates internes.

1. Connectez-vous à Azure DevOps, puis accédez à votre projet.

2. Sélectionnez Artifacts, puis sélectionnez Créer un flux.

3. Entrez un nom pour votre flux, choisissez sa visibilité, puis sélectionnez une étendue. Vérifiez que vous activez la case à cocher Sources en amont pour inclure des packages à partir de registres publics.

4. Sélectionnez Créer lorsque vous avez terminé.

Se connecter à un flux

Avant de pouvoir publier ou restaurer des packages à partir de votre flux, vous devez d’abord configurer votre projet pour s’authentifier et se connecter au flux.

1. Connectez-vous à Azure DevOps, puis accédez à votre projet.

2. Sélectionnez Artefacts, puis sélectionnez votre flux dans le menu déroulant.

3. Sélectionnez Se connecter au flux, puis sélectionnez Cargo dans le volet de navigation gauche.

4. Suivez les étapes décrites dans la section d’installation de Project pour configurer votre config.toml fichier.

5. Sur la même page, suivez les instructions de la section Configurer un fournisseur d’informations d’identification et connectez-vous aux sections du Registre pour configurer le fournisseur d’informations d’identification et vous connecter à votre flux. Pour obtenir des étapes détaillées, consultez Cargo - Configuration du projet.

[unstable]
registry-auth = true

rustup default nightly

Publier des packages

Avant de publier un package Cargo, assurez-vous que vous avez effectué les étapes de connexion à un flux afin de pouvoir vous authentifier auprès de votre flux Azure Artifacts.

Dans le répertoire qui contient votre fichier Cargo.toml , exécutez la commande suivante pour publier votre package :

cargo publish

Si vous rencontrez GLib-GObject-CRITICAL - libsecret-CRITICAL une erreur, veillez à suivre les étapes suivantes :

1. Vérifiez que libsecret est installé :

   sudo apt update && sudo apt install libsecret-1-0
   

2. Assurez-vous que gnome-keyring est en cours d’exécution :

   gnome-keyring-daemon --start --components=secrets
   

3. Mettez à jour Rust vers la dernière version stable et définissez stable comme chaîne d’outils par défaut :

   rustup update  
   rustup default stable  
   

4. Si le problème persiste, réexécutez cargo publish avec la journalisation détaillée pour obtenir plus d’informations :

   RUST_LOG=debug cargo publish --registry <REGISTRY_NAME>
   

Restaurer des packages

Avant de restaurer les dépendances, vérifiez que vous avez effectué les étapes de connexion à un flux afin de pouvoir vous authentifier auprès de votre flux Azure Artifacts.

1. Vérifiez que vos dépendances sont répertoriées dans la [dependencies] section de votre Cargo.toml fichier.

2. Si vous consommez des packages directement depuis votre flux privé Azure Artifacts, spécifiez explicitement le registre comme suit :

   [dependencies]
   CRATE_NAME = { version = "VERSION_NUMBER", registry = "FEED_NAME" }
   

3. Si vous faites référence à des crates de crates.io via votre flux upstream à l’aide de la configuration replace-with, indiquez-les comme suit :

   [dependencies]
   CRATE_NAME = "VERSION_NUMBER"
   

4. Exécutez la commande suivante dans votre répertoire de projet pour générer votre projet et restaurer vos dépendances à partir du flux :

   cargo build
   

Les crates téléchargées sont mises en cache localement dans ~/.cargo/registry/cache/<registry-hash>/, où registry-hash est un identifiant unique basé sur l’URL de votre flux.

Contenu connexe

• Supprimer/retirer des paquets Cargo

• En amont des flux internes

• Autorisations de flux