Restaurer des packages Maven à partir de votre flux Azure Artifacts

Article
11/21/2024

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

Avec Azure Artifacts, vous pouvez publier et restaurer des packages Maven à partir du flux Azure Artifacts et des registres publics. Cet article vous guide tout au long de la configuration de votre projet Maven, de la connexion à votre flux Azure Artifacts et de la restauration de vos packages Maven.

Prérequis

Une organisation Azure DevOps. Créez-en un gratuitement.
Un projet Azure DevOps. Créez un nouveau projet si vous n'en avez pas déjà un.
Un flux Azure Artifacts. Créez-en un gratuitement.
Téléchargez et installez Apache Maven.

Se connecter à un flux

Connectez-vous à votre organisation Azure DevOps puis accédez à votre projet.
Sélectionnez Artefacts, puis sélectionnez votre flux dans le menu déroulant.
Sélectionnez Se connecter au flux, puis sélectionnez Maven dans la zone de navigation de gauche.
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.

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>

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.

Connectez-vous à votre collection Azure DevOps puis accédez à votre projet.
Sélectionnez Artefacts, puis sélectionnez votre flux dans le menu déroulant.
Sélectionnez Se connecter au flux, puis sélectionnez Maven dans le volet de navigation gauche.
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.

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>

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.

Connectez-vous à votre collection Azure DevOps puis accédez à votre projet.
Sélectionnez Artefacts, puis sélectionnez votre flux.
Sélectionnez Se connecter au flux, puis sélectionnez Maven dans le volet de navigation gauche.
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>
```

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>

Conseil

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