Partager via


Utiliser des packages de Maven Central

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

L’utilisation des sources en amont d’Azure Artifacts vous permet d'utiliser un flux unique pour héberger à la fois vos paquets et ceux issus de registres publics tels que Maven Central. Lorsque les sources en amont sont activées, Azure Artifacts enregistre automatiquement une copie d’un package installé à partir d’une source en amont. Cela garantit que votre processus de développement peut continuer en toute transparence même si un registre public subit une panne.

Remarque

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

Prérequis

Produit Exigences
Azure DevOps - Une organisation Azure DevOps .
- Un projet Azure DevOps .
- Téléchargez et installez Apache Maven.

Créer un flux

Si vous disposez déjà d’un flux Azure Artifacts, passez à la section suivante. Dans le cas contraire, procédez comme suit pour en créer un :

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

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

  3. Fournissez un nom pour votre flux, définissez la visibilité pour contrôler qui peut accéder à vos packages, puis choisissez l’étendue du flux. Veillez à vérifier Inclure des packages provenant de sources publiques courantes pour activer les sources en amont et autoriser la consommation de packages à partir de registres publics.

  4. Sélectionnez Créer pour terminer la création du flux.

Ajouter Maven Central en amont

Si vous avez coché les sources en amont lors de la configuration de votre flux, Maven Central doit déjà être ajouté en tant que source en amont. Sinon, vous pouvez l’ajouter manuellement en procédant comme suit :

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

  2. Sélectionnez Artefacts, puis sélectionnez le bouton d’icône d’engrenage dans le 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é.

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

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

Se connecter à votre flux

Avant de pouvoir commencer à enregistrer des packages à partir de sources en amont, vous devez d’abord configurer votre projet et vous connecter à votre 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 Maven dans le volet gauche.

  4. Vérifiez que vous avez installé les prérequis, puis suivez les étapes décrites dans la section Configuration du projet pour configurer vos fichierspom.xml et settings.xml et vous connecter à votre flux. Pour plus d’informations, consultez la configuration du projet - Maven .

Utiliser des packages de Maven Central

L’exemple suivant montre comment utiliser le package Apache HttpClient à partir de Maven Central à l’aide de la ligne de commande.

Remarque

Pour enregistrer des packages depuis les flux amont, vous devez avoir le rôle Lecteur de flux et en amont (Collaborateur) ou supérieur. Pour plus d’informations, consultez rôles de flux et autorisations .

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

  2. Recherchez Apache HttpClient. Sélectionnez le package, puis sélectionnez la version que vous souhaitez installer.

  3. Sous l’onglet Maven , copiez l’extrait <dependency> de code :

    <dependency>
      <groupId>org.apache.httpcomponents.client5</groupId>
      <artifactId>httpclient5</artifactId>
      <version>5.5.1</version>
    </dependency>
    
  4. Ouvrez votre fichier pom.xml et collez l’extrait de code à l’intérieur de la <dependencies> balise, puis enregistrez votre fichier.

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

    mvn install
    

Afficher les packages enregistrés

Maintenant que vous avez installé un package à partir de Maven Central, vous pouvez voir comment Azure Artifacts a enregistré automatiquement une copie de ce package dans votre flux. Vous pouvez filtrer votre vue de flux pour voir les packages enregistrés à partir de différentes sources en amont.

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

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

  3. Dans la liste déroulante source, sélectionnez Maven Central pour filtrer les packages à partir de cet amont.

  4. Le package Apache HttpClient* que vous avez enregistré à l’étape précédente est désormais disponible dans votre flux.

    Capture d’écran montrant le package Apache HttpClient 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 vos fichiers projet : mvn eclipse:eclipse -DdownloadSources=true -DdownloadJavadocs=true