Partager via


Configurer des sources en amont

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

Avec les sources en amont d’Azure Artifacts, vous pouvez simplifier la gestion de vos packages à l’aide d’un seul flux pour stocker les packages que vous publiez et ceux que vous utilisez à partir de flux externes et de registres publics tels que npmjs.com, NuGet.org. Lorsqu’une source en amont est activée sur votre flux, Azure Artifacts enregistre automatiquement une copie de tout package installé par un collaborateur ou une version ultérieure en amont.

Remarque

Les instantanés Maven ne sont pas pris en charge dans les sources en amont.

Activer les sources en amont dans un nouveau flux

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

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

  3. Fournissez un nom pour votre flux et sélectionnez ses paramètres de visibilité et d’étendue. Veillez à cocher la case Inclure les packages provenant de sources publiques courantes pour activer les sources en amont.

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

    Capture d’écran montrant comment créer un flux.

Remarque

Vous devez être propriétaire du flux ou administrateur de flux pour ajouter ou supprimer des sources en amont.

Activer les sources en amont dans un flux existant

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

  2. Sélectionnez le bouton l’icône d’engrenage d’icône d’engrenage pour accéder à vos paramètres de flux.

  3. Sélectionnez Sources en amont, puis ajoutez une source en amont.

  4. Sélectionnez Source publique, puis sélectionnez une source publique dans le menu déroulant.

  5. Sélectionnez Ajouter lorsque vous avez terminé, puis sélectionnez Enregistrer une fois de plus dans le coin supérieur droit pour conserver vos modifications.

Remarque

Les sources publiques en amont personnalisées sont uniquement prises en charge avec les registres npm.

Ajouter un flux dans la même organisation qu’une source en amont

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

  2. Sélectionnez le boutond’engrenage icône d’engrenage d’icône d’engrenage pour accéder aux paramètres de votre flux.

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

  4. Sélectionnez Flux Azure Artifacts dans cette organisation.

  5. Sélectionnez le flux souhaité dans le menu déroulant pour l’ajouter en tant que source en amont. Sélectionnez ensuite l’affichageet choisissez le ou les types de package que vous souhaitez utiliser. Si vous le souhaitez, vous pouvez également modifier le nom de votre source en amont.

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

    Capture d’écran montrant comment ajouter un flux dans votre organisation en tant que source en amont.

Ajouter un flux dans une autre organisation en tant que source en amont

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

  2. Sélectionnez le boutond’engrenage icône d’engrenage d’icône d’engrenage pour accéder aux paramètres de votre flux.

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

  4. Sélectionnez Flux Azure Artifacts dans une autre organisation.

  5. Entrez votre localisateur de flux Azure Artifacts au format suivant :

    • Flux délimité par l’organisation :

      azure-feed://ORGANIZATION_NAME/FEED_NAME@VIEW
      
    • Flux délimité par le projet :

      azure-feed://ORGANIZATION_NAME/PROJECT_NAME/FEED_NAME@VIEW
      
  6. Sélectionnez le ou les types de package que vous souhaitez utiliser et fournissez un nom pour votre source en amont.

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

    Capture d’écran montrant comment ajouter un flux dans une autre organisation en tant que source en amont.

Remarque

Pour ajouter un flux à partir d’une autre organisation en tant que source en amont, le propriétaire du flux cible doit partager l’affichage cible avec tous les flux et les personnes dans les organisations associées à mon locataire Microsoft Entra en accédant au Sélectionner le bouton de sélection à droite de l’affichage >Spécifié.

Exemples

Remarque

Vous devez être un lecteur de flux et en amont (collaborateur), un éditeur de flux (contributeur) ou un propriétaire de flux pour installer de nouveaux packages en amont. Une copie de chaque package en amont est enregistrée dans le flux lors de la première utilisation. Les packages déjà enregistrés à partir de sources en amont peuvent être utilisés par les lecteurs de flux.

Questions fréquentes (FAQ)

Q : Je n'arrive pas à trouver mon package alors que je le vois dans l'un des upstreams de mon flux ?

R : Les packages provenant de sources en amont deviennent disponibles dans le flux peu après leur publication, mais ils n’apparaissent que pour les lecteurs une fois qu’ils sont enregistrés dans le flux.

Un package est enregistré lorsqu’un utilisateur disposant d’un flux et d’un lecteur en amont (collaborateur) ou d’autorisations supérieures installe cette version du package. Azure Artifacts enregistre ensuite automatiquement une copie du package dans le flux, le rendant disponible définitivement pour tous les lecteurs et visibles dans l’interface utilisateur web.

Q : Je ne trouve pas le flux que je souhaite configurer en tant que source en amont ?

R : Vérifiez que le propriétaire du flux a partagé une vue en tant que source en amont. Pour plus d’informations, consultez Ajouter un flux dans une autre organisation en tant que source en amont.

Q : Qu'est-ce que l'affichage des flux ?

R : Les vues de flux vous permettent de partager un sous-ensemble de versions de package qui ont été testées et validées, à l’exclusion de celles qui sont toujours en cours de développement ou qui ne répondent pas aux critères de qualité. Pour plus de détails, voir Qu'est-ce qu'une vue de flux ?

Q : Un utilisateur disposant du rôle Lecteur de flux peut-il télécharger des packages à partir d’une source en amont ?

R : Non. Le lecteur de flux ne peut télécharger que les packages déjà enregistrés dans le flux. Les packages sont enregistrés lorsqu’un lecteur de flux et en amont (collaborateur),un éditeur de flux (contributeur) ou un propriétaire de flux les installe en amont.

Q : Que se passe-t-il si un utilisateur supprime ou annule la publication d’un package enregistré à partir d’une source en amont ?

R : Le package devient indisponible pour le téléchargement et son numéro de version est réservé définitivement. Il ne sera plus synchronisé à partir de l’amont, mais les versions antérieures et ultérieures restent inchangées.

Q : Que se passe-t-il si un utilisateur déprécie un package enregistré à partir d’une source en amont ?

R : Un message d’avertissement est ajouté aux métadonnées du package. Cet avertissement s’affiche chaque fois que le package est affiché ou installé à partir du flux.