Utiliser des packages à partir du référentiel Google Maven

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

Avec Azure Artifacts, les développeurs peuvent permettre aux sources en amont d’utiliser des packages à partir de registres publics tels que le dépôt Google Maven. Lorsqu’une source en amont est activée, Azure Artifacts enregistre automatiquement une copie de tout package installé sur le flux par les utilisateurs disposant d’autorisations Feed et Lecteur en amont (Collaborateur) ou ultérieures. Azure Artifacts prend également en charge d’autres sources en amont Maven, notamment Maven Central, Gradle Plugins et JitPack.

Prérequis

Produit Exigences
Azure DevOps - Une Azure DevOps organisation.
- Projet Azure DevOps .

Créer un flux

Si vous disposez déjà d’un flux Azure Artifacts, passez à la section suivante. Sinon, créez-en un en suivant les étapes suivantes :

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

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

  3. Entrez un nom pour votre flux, définissez la visibilité pour contrôler qui peut afficher les packages, puis choisissez l’étendue du flux. Sélectionnez Inclure des packages à partir de sources publiques courantes pour activer les sources en amont et autoriser la consommation à partir de registres publics.

  4. Sélectionnez Créer pour terminer.

Ajouter la source d'origine du référentiel Google Maven

Si vous avez sélectionné Inclure des packages à partir de sources publiques courantes lors de la création de votre flux, le dépôt Google Maven 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 et accédez à votre projet.

  2. Sélectionnez Artefacts, puis sélectionnez l’icône d’engrenage dans le coin supérieur droit pour ouvrir Paramètres du flux.

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

  4. Sélectionnez Source publique, puis Sélectionnez Dépôt Google Maven (https://maven.google.com/web/index.html).

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

Enregistrer des packages à partir du référentiel Google Maven

Avant de commencer, vérifiez que votre projet Maven est configuré pour vous connecter à votre flux de Azure Artifacts. Si vous ne l’avez pas encore fait, suivez les instructions de la configuration du projet pour configurer votre projet Maven et vous authentifier auprès de votre flux.

L’exemple suivant montre comment installer Multipaz, une infrastructure d’identité open source, à partir du référentiel Google Maven.

  1. Accédez au dépôt Google Mavenhttps://maven.google.com.

  2. Recherchez le package Multipaz : org.multipaz, puis sélectionnez le package et la version que vous souhaitez utiliser.

  3. Copiez les valeurs ID de groupe, ID d’artefact et Version du package.

  4. Remplacez les espaces réservés dans l’extrait de code suivant par les valeurs que vous venez de copier :

    <dependency>
        <groupId>GROUP_ID</groupId>
        <artifactId>ARTIFACT_ID</artifactId>
        <version>VERSION</version>
    </dependency>
    
  5. Ouvrez votre fichier pom.xml , collez l’extrait de code de dépendance dans la <dependencies> section, puis enregistrez votre fichier.

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

    mvn install
    

Une fois la commande terminée, Maven résout la dépendance par le biais de votre flux de Azure Artifacts. Si le package n’est pas déjà présent dans le flux, Azure Artifacts le récupère à partir du dépôt Google Maven et enregistre une copie. Les installations suivantes téléchargent le package directement à partir de Azure Artifacts au lieu du registre public.

Remarque

Vous devez avoir le rôle Feed and Upstream Reader (Collaborateur) ou un rôle supérieur pour enregistrer les packages depuis l'upstream. Pour plus d’informations, consultez rôles de flux et autorisations .

Afficher les packages enregistrés

Après avoir installé un package à partir d’une source en amont, vous pouvez confirmer que Azure Artifacts enregistré une copie dans votre flux :

  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 le menu déroulant Source , sélectionnez Dépôt Google Maven pour afficher les packages enregistrés à partir de cet amont.

  4. Le package Multipaz que vous avez installé dans la section précédente est désormais disponible dans votre flux. Azure Artifacts enregistré automatiquement une copie lorsque vous avez exécuté la commande d’installation mvn.

    Capture d’écran montrant le package Multipaz à partir du dépôt Google Maven enregistré dans le flux.

Conseil

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