Configurer un flux interne en tant que source en amont

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

Les sources en amont d’Azure Artifacts simplifient la gestion des packages en permettant aux développeurs de stocker des packages à partir de plusieurs sources dans un seul flux. Lorsqu’un package est installé pour la première fois à partir d’une source en amont, Azure Artifacts enregistre automatiquement une copie dans votre flux pour garantir un accès continu, même si la source en amont devient temporairement indisponible. Ce tutoriel vous guide tout au long de la configuration d’un flux interne de la même organisation qu’une source en amont dans Azure Artifacts.

Prerequisites

Créer un flux

Si vous n’avez pas encore de flux, procédez comme suit pour en créer un et ajouter des registres publics courants en tant que sources en amont :

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

2. Sélectionnez Artefacts, puis créez un flux.

3. Entrez un nom pour le flux et choisissez les paramètres de visibilité et d’étendue appropriés.

4. Sélectionnez Inclure des packages à partir de sources publiques courantes pour ajouter des registres publics communs en tant que sources en amont.

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

Se connecter à votre flux

Procédez comme suit pour configurer votre projet et l’authentification avec votre flux. Cet exemple utilise un projet Rust. Pour d’autres technologies, consultez les liens de configuration du projet dans la section suivante.

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

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

   

3. Dans le volet de navigation gauche, sélectionnez Cargo.

4. Dans la section Configuration du projet , copiez le premier extrait de code et ajoutez-le au fichier cargo/config.toml dans votre référentiel source. Votre fichier config.toml doit ressembler à ce qui suit :

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

5. Configurer un fournisseur d’informations d’identification

6. Connectez-vous au Registre

Configuration du projet pour d’autres types de package

Si vous utilisez une autre technologie, utilisez les liens ci-dessous pour suivre les instructions de configuration de projet appropriées pour vous connecter à votre flux :

Configurer le flux en amont

Procédez comme suit pour configurer un flux interne de la même organisation qu’une source en amont :

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

2. Sélectionnez Artefacts, puis sélectionnez le flux que vous avez créé précédemment dans le menu déroulant de flux.

3. Sélectionnez pour accéder aux paramètres du fil d’actualité.

4. Sélectionnez Sources en amont, puis sélectionnez Ajouter en amont.

5. Sous l’onglet Type , sélectionnez le flux Azure Artifacts dans cette organisation.

6. Sous l’onglet Configuration , dans le menu déroulant Flux , sélectionnez le flux que vous souhaitez ajouter en tant que source en amont. Sélectionnez l’affichage souhaité, puis choisissez le ou les types de package à inclure et mettez éventuellement à jour le nom de la source en amont.

7. Sélectionnez Ajouter quand vous avez terminé.

   

8. Sélectionnez Enregistrer pour appliquer vos modifications.

   

Installer des packages à partir de l’amont

L’exemple suivant illustre un scénario où Test_Feed a configuré CargoDemoFeed en tant que source en amont. À des fins de démonstration, Test_Feed est vide et ne contient aucun package.

Lorsqu'un collaborateur (ou personne de rang supérieur) installe un package depuis Test_Feed qui est disponible en amont dans CargoDemoFeed, Azure Artifacts copie ce package dans le flux en aval de Test_Feed et le télécharge dans le flux normal cargo install. Après cette première copie, tous les téléchargements futurs de ce package à partir de Test_Feed nécessitent uniquement des autorisations lecteur de flux (ou supérieure), car ces téléchargements ultérieurs ne modifient pas le flux en aval. Seule la première installation copie le package de l’amont vers l’aval, de sorte que seule l’action initiale nécessite des autorisations élevées.

1. Connectez-vous à Azure DevOps, puis accédez au projet qui héberge le flux en amont (dans cet exemple, CargoDemoFeed).

2. Sélectionnez Artefacts, puis dans le menu déroulant, sélectionnez le flux en amont (CargoDemoFeed).

3. Recherchez le package que vous souhaitez installer et notez son nom. Dans cet exemple, atomic-waker est le nom du package. Vous pouvez également rechercher des packages en amont directement à partir de votre flux en aval dans l’interface utilisateur d’Azure Artifacts. Pour plus d’informations, consultez les packages de recherche à partir de sources en amont .

4. Accédez à la racine de votre projet et ouvrez votre Cargo.toml. Ajoutez le package sous [dépendances]. Étant donné qu'il s'agit d'une dépendance de crate privée, vous devez spécifier le nom du registre dans votre fichier Cargo.toml. Cargo utilise crates.io comme registre par défaut, sauf indication contraire. Ajoutez la dépendance comme suit :

   CRATE_NAME = { version = "VERSION_NUMBER", registry = "FEED_NAME" }
   
   # Example:
   # [dependencies]
   # atomic-waker = { version = "1.1.2", registry = "Test_Feed" }
   

5. Ouvrez une invite de commandes locale, naviguez jusqu'à la racine de votre projet, puis exécutez la commande suivante pour construire votre projet et télécharger le crate :

   cargo build
   

6. Une fois la build terminée, revenez à Azure DevOps>Artifacts et sélectionnez votre flux de consommation (dans cet exemple, Test_Feed).

7. Vérifiez que le package que vous avez installé localement apparaît désormais dans votre flux en aval. Azure Artifacts enregistre automatiquement une copie du package lorsqu’il est installé à partir d’une source en amont.

   

Contenu connexe

• Protection contre les packages publics malveillants

• Utiliser des packages de Maven Central

• Gérer les autorisations