Partager via


Utiliser des packages de Maven Central

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

L’utilisation de sources en amont Azure Artifacts vous permet d’utiliser un flux unique pour héberger les packages que vous produisez et les packages à partir de registres publics tels que Maven Central. Lorsque vous ajoutez des sources en amont à votre flux, Azure Artifacts enregistre une copie de n’importe quel package installé en amont. Cela garantit une accessibilité continue pour votre développement, même si un registre public subit une panne. En outre, Azure Artifacts prend en charge différentes autres sources en amont Maven, notamment le dépôt Google Maven, gradle plugins et JitPack.

Prérequis

  • Un organization Azure DevOps et un projet. Créez un organization ou un projet si ce n’est pas déjà fait.

  • Un flux Azure Artifacts.

Remarque

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

Activer des sources en amont

Si vous n’avez pas encore de flux, suivez ces instructions pour en créer un et vérifiez que vous cochez la case sources en amont pour les activer. Si vous disposez déjà d’un flux, passez à l’étape suivante pour ajouter Maven Central en tant que source en amont.

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

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

  3. Pour Nom, entrez un nom descriptif pour votre flux.

    Pour visibilité, sélectionnez une option pour indiquer qui peut afficher les packages dans le flux.

    Si vous souhaitez inclure des packages à partir de sources publiques, cochez la case sous Sources en amont.

    Pour Étendue, spécifiez si l’étendue de votre flux est le projet ou l’organisation.

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

    Capture d’écran montrant les sélections pour la création d’un flux dans Azure DevOps Services.

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

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

  3. Pour Nom, entrez un nom descriptif pour votre flux.

    Pour visibilité, sélectionnez une option pour indiquer qui peut afficher les packages dans le flux.

    Si vous souhaitez inclure des packages à partir de sources publiques, cochez la case sous Sources en amont.

    Pour Étendue, spécifiez si l’étendue de votre flux est le projet ou l’organisation.

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

    Capture d’écran montrant les sélections permettant de créer un flux dans Azure DevOps 2022.

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

    Capture d’écran montrant les sélections pour la création d’un flux dans Azure DevOps 2020.

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

  2. Sélectionnez Artefacts, puis nouveau flux.

  3. Pour Nom, entrez un nom descriptif pour votre flux.

    Pour visibilité, sélectionnez une option pour indiquer qui peut afficher les packages dans le flux.

    Si vous souhaitez inclure des packages à partir de sources publiques, sélectionnez l’option Utiliser des packages à partir de sources publiques via cette option de flux .

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

    Capture d’écran montrant les sélections pour la création d’un flux dans Azure DevOps 2019.

Remarque

Par défaut, les flux nouvellement créés ont la valeur du service de build de leur projet définie sur Feed and Upstream Reader (Collaborateur).

Ajouter Maven Central en amont

Si vous avez coché la case sources en amont lors de la création de votre flux, Maven Central doit déjà être ajouté en tant que source en amont. Si ce n’est pas le cas, vous pouvez l’ajouter manuellement en procédant comme suit :

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

  2. Sélectionnez Artefacts, puis sélectionnez le d’engrenage icône d’engrenage coin supérieur droit pour accéder à vos paramètres de flux.

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

  4. Sélectionnez Source publique, sélectionnez Maven Central (https://repo.maven.apache.org/maven2/) dans le menu déroulant, puis sélectionnez Ajouter lorsque vous avez terminé.

    Capture d’écran montrant comment ajouter une source en amont centrale Maven.

  5. Sélectionnez Enregistrer dans le coin supérieur droit pour enregistrer vos modifications.

    Capture d’écran montrant comment enregistrer des sources en amont.

Enregistrer le package à partir de Maven Central

Avant d’enregistrer des packages à partir de Maven Central, vérifiez que vous avez configuré votre projet pour vous connecter à votre flux. Si vous ne l’avez pas déjà fait, suivez les instructions de la configuration du projet pour configurer votre projet Maven et vous connecter à votre flux.

Dans cet exemple, nous allons enregistrer la bibliothèque Datetime Kotlin à partir de Maven Central.

  1. Accédez à Maven Central à l’adresse https://mvnrepository.com/.

  2. Recherchez la bibliothèque Datetime Kotlin. Sélectionnez le package Datetime Kotlinx, puis sélectionnez la version que vous souhaitez installer.

  3. Copiez l’extrait de code <dependency> à partir de l’onglet Maven .

    <dependency>
        <groupId>org.jetbrains.kotlinx</groupId>
        <artifactId>kotlinx-datetime-jvm</artifactId>
        <version>0.4.1</version>
        <scope>runtime</scope>
    </dependency>
    
  4. Ouvrez votre fichier pom.xml et collez l’extrait de code à l’intérieur de votre <dependencies> balise, puis enregistrez votre fichier.

  5. Exécutez la commande suivante à partir du même chemin que votre fichier pom.xml pour installer vos dépendances :

    mvn install
    

Remarque

Pour enregistrer des packages à partir d’amont, vous devez disposer du rôle Flux et Lecteur en amont (Collaborateur) ou supérieur. Pour plus d’informations, consultez Gérer les autorisations .

Afficher les packages enregistrés

Vous pouvez afficher les packages que vous avez enregistrés en amont en sélectionnant la source Maven Central dans le menu déroulant.

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

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

  3. Sélectionnez Maven Central dans le menu déroulant source pour filtrer les packages à partir de cet amont.

  4. Le package Datetime Kotlinx que nous avons enregistré à l’étape précédente est désormais disponible dans notre flux. Azure Artifacts a enregistré automatiquement une copie dans notre flux lors de l’exécution de la commande d’installation mvn.

Capture d’écran montrant un package enregistré à partir de Maven Central.

Conseil

Si Maven ne télécharge pas toutes vos dépendances, exécutez la commande suivante à partir du répertoire du projet pour régénérer les fichiers de votre projet : mvn eclipse:eclipse -DdownloadSources=true -DdownloadJavadocs=true