Bien démarrer avec les packages Maven et Azure Artifacts

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

Ce guide de démarrage rapide vous guide tout au long de la configuration de votre projet Maven pour vous connecter aux flux Azure Artifacts et publier et télécharger vos packages Maven.

Prérequis

• Une organisation Azure DevOps. Créez une organisation si vous n’en avez pas déjà une.
• Installez Apache Maven.
• Un flux Azure Artifacts. Créez un flux si vous n’en avez pas déjà un.

Configurer l’authentification

1. Sélectionnez Artefacts, puis sélectionnez Connecter à Flux.

   

2. Sélectionnez Maven.

3. S’il s’agit de la première utilisation d’Azure Artifacts avec Maven, sélectionnez Obtenir les outils à télécharger et installer Maven.

4. Suivez les instructions de la configuration de Project pour configurer vos fichiers pom.xml et settings.xml. Si votre fichier settings.xml est partagé au sein de votre équipe, vous pouvez utiliser Maven pour chiffrer vos mots de passe.

   

Conseil

Si vous utilisez la tâche Maven, définissez l’argument mavenAuthenticateFeed sur true pour vous authentifier automatiquement auprès de votre flux Maven.

Publier des artefacts

1. Si vous n’avez pas encore de package Maven, vous pouvez en créer un en exécutant la commande suivante :

   mvn -B archetype:generate -DarchetypeGroupId="org.apache.maven.archetypes" -DgroupId="MyGroup" -DartifactId="myFirstApp"
   

   Si vous obtenez l’erreur suivante : Vous devez spécifier une phase de cycle de vie valide ou un objectif (..), suivez les étapes ci-dessous pour ajouter un objectif à votre configuration :

   Cliquez avec le bouton droit sur votre projet, sélectionnez Exécuter en tant que>build Maven. Entrez le package dans la zone de texte Objectifs , puis sélectionnez Exécuter.

2. Accédez au chemin d’accès de votre fichier pom.xml et exécutez les commandes suivantes pour générer et déployer votre artefact Maven :

   mvn build
   mvn deploy
   

Si vous obtenez l’erreur suivante : phase de cycle de vie inconnue « build » (...) lorsque vous exécutez mvn build, vous pouvez utiliser l’IDE Eclipse pour générer votre projet maven comme suit :

1. Faites un clic droit sur votre projet.

2. Sélectionnez Exécuter en tant que, puis maven Build....

3. Écrire un package dans la zone de texte Objectifs .

4. Sélectionnez Exécuter.

   

Si vous souhaitez publier un artefact tiers, vous pouvez utiliser le mojo deploy :deploy-file . Cela peut être utilisé avec ou sans fichier POM pour déployer vos packages.

mvn deploy:deploy-file -Dpackaging="jar" -DrepositoryId="MyFeedName" -Durl="MyFeedURL" -DgroupId="MyGroup" -DartifactId="myFirstApp" -Dversion="jarFileVersion" -Dfile="jarFileLocalPath"

Remarque

Si votre organisation utilise un pare-feu ou un serveur proxy, veillez à autoriser les URL et adresses IP du domaine Azure Artifacts.

Installer des artefacts

1. Accédez à Azure Artifacts, puis sélectionnez le package que vous souhaitez installer et copier l’extrait de code <dependency> .

2. Ouvrez votre fichier pom.xml et collez votre code à l’intérieur de la <dependencies> balise.

3. Exécutez mvn install à partir du même chemin que votre fichier pom.xml.

Articles connexes

• Configurer les autorisations
• Utiliser les vues de flux pour partager des packages
• Configurer des sources amont