Aan de slag met Maven-pakketten in Azure Artifacts

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

Met Azure Artifacts kunnen ontwikkelaars hun afhankelijkheden van één feed beheren en tegelijkertijd controle bieden over het delen van pakketten. Met Azure Artifacts-feeds kunt u Maven-pakketten publiceren en herstellen en upstream-bronnen instellen voor het verbruik van pakketten uit openbare registers zoals Maven Central, Google Maven Repository, Gradle Plugins en JitPack. In dit artikel wordt u begeleid bij het instellen van uw Maven-project, het maken van verbinding met een Azure Artifacts-feed en het publiceren en herstellen van uw Maven-pakketten.

Vereisten

• Maak een Azure DevOps-organisatie en een project als u dat nog niet hebt gedaan.

• Download en installeer Apache Maven.

Een feed maken

1. Meld u aan bij uw Azure DevOps-organisatie en ga vervolgens naar uw project.

2. Selecteer Artefacten en selecteer vervolgens Feed maken.

3. Voer voor Naam een beschrijvende naam in voor uw feed.

   Selecteer voor Zichtbaarheid een optie om aan te geven wie pakketten in de feed kan bekijken.

   Als u pakketten uit openbare bronnen wilt opnemen, schakelt u het selectievakje onder Upstream-bronnen in.

   Geef voor Bereik op of het bereik van uw feed het project of de organisatie is.

4. Selecteer Maken wanneer u klaar bent.

   

Notitie

Standaard is voor nieuw gemaakte feeds de buildservicewaarde van het project ingesteld op Feed en Upstream Reader (Samenwerker).

Verbinding maken met een feed

1. Meld u aan bij uw Azure DevOps-organisatie en navigeer vervolgens naar uw project.

2. Selecteer Artefacten en selecteer vervolgens uw feed in de vervolgkeuzelijst.

3. Selecteer Verbinding maken met feed en selecteer vervolgens Maven in het linkernavigatiegebied.

4. Als dit de eerste keer is dat u Azure Artifacts met Maven gebruikt, controleert u of u de vereisten hebt geïnstalleerd. Selecteer anders De hulpprogramma's in de rechterbovenhoek ophalen om ze te installeren.

5. Volg de instructies in de sectie Project-installatie om uw pom.xml - en settings.xml-bestanden in te stellen. Uw bestanden moeten er ongeveer uitzien als in de volgende voorbeelden:

   • 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. Genereer een persoonlijk toegangstoken met het lees- en schrijfbereik voor pakketten>en plak deze in de <password> tag.

Pakketten publiceren

1. Open een opdrachtpromptvenster en navigeer naar de projectmap waar het pom.xml-bestand zich bevindt en voer vervolgens de volgende opdracht uit om uw project te verpakken. Met deze opdracht compileert u uw code, voert u tests uit die zijn opgenomen en verpakt u uw project in een distribueerbare indeling (zoals een JAR-bestand).

   mvn package
   

2. Voer de volgende opdracht uit vanuit uw projectmap om uw pakket te publiceren naar uw feed:

   mvn deploy
   

3. Nadat het pakket is geïmplementeerd, is het binnenkort beschikbaar in uw feed.

   

Notitie

Als uw organisatie een firewall of een proxyserver gebruikt, moet u ervoor zorgen dat u URL's en IP-adressen van Azure Artifacts-domeinen toestaat.

Pakketten herstellen

1. Navigeer naar Artefacten in uw Azure DevOps-project, selecteer uw feed in de vervolgkeuzelijst en selecteer vervolgens het pakket dat u wilt installeren.

2. Navigeer naar Overzicht>Maven en kopieer vervolgens het afhankelijkheidsfragment.

3. Open het pom.xml-bestand en plak het fragment in de <dependencies> tag.

4. Voer de volgende opdracht uit vanuit de map waar uw pom.xml bestand zich bevindt om uw pakketten te herstellen:

   mvn install
   

Verwante artikelen:

• Maven-artefacten publiceren met Azure Pipelines
• Pakketten van Maven Central gebruiken
• Upstream-bronnen gebruiken in een openbare feed