Bien démarrer avec les packages Maven dans Azure Artifacts

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

Les packages Maven sont des fichiers binaires Java créés à l’aide de l’outil de génération Apache Maven. Avec les flux Azure Artifacts, vous pouvez stocker plusieurs types de packages dans un seul flux. Les packages stockés peuvent ensuite être restaurés pour générer votre projet ou partagés avec votre équipe et vos clients. Les flux Azure Artifacts prennent également en charge l’utilisation de packages à partir de registres publics tels que Maven Central, Google Maven Repository, Gradle Plugins et JitPack via des sources en amont.

Cet article vous guide tout au long de la configuration de votre projet Maven, de sa connexion à un flux Azure Artifacts et de la publication et de la restauration de vos packages Maven.

Prérequis

Créer un flux

Si vous disposez déjà d’un flux, vous pouvez passer à la section suivante. Sinon, créez un flux comme suit :

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

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

3. Fournissez un nom pour votre flux, sélectionnez la visibilité pour définir qui peut afficher vos packages, puis choisissez l’étendue du flux. Si vous souhaitez inclure des packages à partir de registres publics tels que Maven Central ou Google Maven Repository, cochez Include packages à partir de sources publiques courantes.

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

Se connecter à un flux

Maintenant que vous disposez d’un flux, vous devez configurer votre fichier de configuration pour vous authentifier auprès de votre flux. Vous devez également créer un jeton d’accès personnel pour vous authentifier auprès d’Azure DevOps. Suivez les étapes ci-dessous pour authentifier et vous connecter à votre flux :

1. Générez un jeton d'accès personnel avec les autorisations d'empaquetage> et de lecture et d'écriture. Copiez votre PAT et enregistrez-le dans un emplacement sécurisé, car vous en aurez besoin dans les étapes suivantes.

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

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

4. Sélectionnez Se connecter au flux, puis sélectionnez Maven dans le volet de navigation gauche.

5. S’il s’agit de la première utilisation d’Azure Artifacts avec Maven sur cet ordinateur, vérifiez que vous avez installé les prérequis.

6. Ouvrez votre fichier pom.xml et ajoutez l'extrait de code fourni dans la section configuration du projet, à l'intérieur des sections <repositories> et <distributionManagement>. Votre pom.xml doit ressembler à ce qui suit :

       <repositories>
           <repository>
               <id>FEED_NAME</id>
               <url>https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/maven/v1</url>
               <releases>
               <enabled>true</enabled>
               </releases>
               <snapshots>
               <enabled>true</enabled>
               </snapshots>
           </repository>
       </repositories>
       <distributionManagement>
           <repository>
               <id>FEED_NAME</id>
               <url>https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/maven/v1</url>
               <releases>
               <enabled>true</enabled>
               </releases>
               <snapshots>
               <enabled>true</enabled>
               </snapshots>
           </repository>
       </distributionManagement>
   

7. Ouvrez votre settings.xml de niveau utilisateur et ajoutez votre PAT dans la <password> balise. Ce fichier doit être conservé localement afin de ne pas le valider dans votre code source pour ne pas exposer vos informations d’identification. Votre fichier settings.xml doit ressembler à ce qui suit :

       <servers>
           <server>
               <id>MavenDemo</id>
               <username><ORGANIZATION_NAME></username>
               <password>[PERSONAL_ACCESS_TOKEN]</password>
           </server>
       </servers>
   

Publier des packages

Maintenant que vous avez authentifié avec votre flux, vous êtes prêt à publier et restaurer des packages :

1. Si vous n’avez pas encore généré votre package, ouvrez une fenêtre d’invite de commandes et accédez au répertoire de votre projet où se trouve votre fichier pom.xml , puis exécutez la commande suivante pour empaqueter votre projet. Cette commande compile votre code, exécute des tests inclus et empaquet votre projet dans un format distribuable (tel qu’un fichier JAR).

   mvn package
   

2. Exécutez la commande suivante à partir de votre répertoire de projet pour publier votre package dans votre flux :

   mvn deploy
   

3. Une fois votre package publié, il sera bientôt disponible dans votre flux Azure Artifacts.

   

Restaurer des packages

Pour restaurer des packages à partir de votre flux, exécutez la mvn install commande à partir de votre répertoire de projet pour installer toutes les dépendances répertoriées dans votre pom.xml. Si le package que vous souhaitez installer à partir de votre flux n’est pas dans votre pom.xml, voici comment l’ajouter et la restaurer à partir de 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 le package que vous souhaitez installer, accédez à Vue d’ensemble>Maven, puis copiez l’extrait de code de dépendance. Il doit ressembler à ceci :

   <dependency>
     <groupId>MyGroup</groupId>
     <artifactId>MavenQuickStartDemo</artifactId>
     <version>1.0-SNAPSHOT</version>
   </dependency>
   

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

5. Exécutez la commande suivante à partir du répertoire où se trouve votre fichier pom.xml pour restaurer vos packages :

   mvn install
   

Contenu connexe

• Publier des artefacts Maven avec Azure Pipelines (Classic/YAML)

• Utiliser des packages de Maven Central

• Utiliser des sources en amont dans un flux public