Partager via

Connecter votre projet Maven à un flux Azure Artifacts

  • Article

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

Avec Azure Artifacts, vous pouvez publier et restaurer en toute transparence des packages Maven à partir de flux et de registres publics. Azure Artifacts prend en charge l’amont à partir de Maven Central, google Maven Repository, Gradle Plugins et JitPack. Ce guide vous guide tout au long du processus de configuration de votre projet Maven et de la connexion à votre flux Azure Artifacts.

Prérequis

Configuration du projet

  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 Se connecter au flux, puis sélectionnez Maven dans la zone de navigation de gauche.

  4. S’il s’agit de votre première utilisation d’Azure Artifacts avec Maven, vérifiez que vous avez installé les prérequis. Sinon, sélectionnez Obtenir les outils dans le coin supérieur droit pour les installer.

  5. Suivez les instructions de la section Configuration de Project pour configurer vos fichiers pom.xml et settings.xml . Vos fichiers doivent ressembler aux exemples suivants :

    • pom.xml :

        <repositories>
    <repository>
      <id>MavenDemo</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>MavenDemo</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>

    • settings.xml :

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

  6. Générez un jeton d’accès personnel avec l’étendue de lecture et d’écriture d’empaquetage>, puis collez-le dans la <password> balise.

  1. Connectez-vous à votre collection 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 de navigation gauche.

  4. S’il s’agit de votre première utilisation d’Azure Artifacts avec Maven, vérifiez que vous avez installé les prérequis, sinon sélectionnez Obtenir les outils dans le coin supérieur droit pour les installer.

  5. Suivez les instructions de la section Configuration de Project pour configurer vos fichiers pom.xml et settings.xml . Vos fichiers doivent ressembler aux exemples suivants :

    • pom.xml :

        <repositories>
    <repository>
      <id>MavenDemo</id>
      <url>http://<SERVER_NAME>/<COLLECTION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/maven/v1</url>
      <releases>
        <enabled>true</enabled>
      </releases>
      <snapshots>
        <enabled>true</enabled>
      </snapshots>
    </repository>
  </repositories>
  <distributionManagement>
    <repository>
      <id>MavenDemo</id>
      <url>http://<SERVER_NAME>/<COLLECTION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/maven/v1</url>
      <releases>
        <enabled>true</enabled>
      </releases>
      <snapshots>
        <enabled>true</enabled>
      </snapshots>
    </repository>
  </distributionManagement>

    • settings.xml :

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

  6. Générez un jeton d’accès personnel avec l’étendue de lecture et d’écriture d’empaquetage>, puis collez-le dans la <password> balise.

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

  2. Sélectionnez Artefacts, puis sélectionnez votre flux.

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

  4. Sélectionnez Générer des informations d’identification Maven et ajoutez les informations d’identification à votre fichier settings.xml utilisateur à l’intérieur de la <servers> balise. Votre fichier se présente ainsi :

      <servers>
    <server>
      <id>server-2019-defaultcollection-demo</id>
      <username><FEED_NAME></username>
      <password>xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx</password>
    </server>
  </servers>

  5. Ajoutez le deuxième extrait de code au pom.xml de votre projet à l’intérieur des balises et <distributionManagement> des <repositories> balises. Votre fichier se présente ainsi :

      <repositories>
    <repository>
      <id>server-2019-defaultcollection-demo</id>
      <url>http://<SERVER_NAME>/<COLLECTION_NAME>/_packaging/<FEED_NAME>/maven/v1</url>
      <releases>
        <enabled>true</enabled>
      </releases>
      <snapshots>
        <enabled>true</enabled>
      </snapshots>
    </repository>
  </repositories>
  <distributionManagement>
    <repository>
      <id>server-2019-defaultcollection-demo</id>
      <url>http://<SERVER_NAME>/<COLLECTION_NAME>/_packaging/<FEED_NAME>/maven/v1</url>
      <releases>
        <enabled>true</enabled>
      </releases>
      <snapshots>
        <enabled>true</enabled>
      </snapshots>
    </repository>
  </distributionManagement>

Remarque

Si votre settings.xml fichier est partagé au sein de votre équipe, vous pouvez utiliser Maven pour chiffrer vos mots de passe.