Erste Schritte mit Maven-Paketen in Azure Artifacts

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

Mit Azure Artifacts können Entwickler ihre Abhängigkeiten aus einem einzigen Feed verwalten und gleichzeitig die Kontrolle über die Paketfreigabe bereitstellen. Mit Azure Artifacts-Feeds können Sie Maven-Pakete veröffentlichen und wiederherstellen und upstream-Quellen einrichten, um Pakete aus öffentlichen Registern wie Maven Central, Google Maven Repository, Gradle Plugins und JitPack zu nutzen. Dieser Artikel führt Sie durch das Einrichten Ihres Maven-Projekts, das Herstellen einer Verbindung mit einem Azure Artifacts-Feed sowie das Veröffentlichen und Wiederherstellen Ihrer Maven-Pakete.

Voraussetzungen

• Erstellen Sie eine Azure DevOps-Organisation und ein Projekt, sofern noch nicht geschehen.

• Laden Sie Apache Maven herunter und installieren Sie sie.

Einen Feed erstellen

1. Melden Sie sich bei Ihrer Azure DevOps-Organisation an, und wechseln Sie dann zu Ihrem Projekt.

2. Wählen Sie Artefakte und dann Ihren Feed erstellen aus.

3. Geben Sie für "Name" einen beschreibenden Namen für Ihren Feed ein.

   Wählen Sie für sichtbarkeit eine Option aus, um anzugeben, wer Pakete innerhalb des Feeds anzeigen kann.

   Wenn Sie Pakete aus öffentlichen Quellen einschließen möchten, aktivieren Sie das Kontrollkästchen unter Upstreamquellen.

   Geben Sie für "Scope" an, ob der Bereich Ihres Feeds das Projekt oder die Organisation ist.

4. Wählen Sie Erstellen, wenn Sie fertig sind.

   

Hinweis

Standardmäßig haben neu erstellte Feeds den Builddienstwert ihres Projekts auf Feed und Upstream Reader (Mitarbeiter) festgelegt.

Herstellen einer Verbindung mit einem Feed

1. Melden Sie sich bei Ihrer Azure DevOps-Organisation an, und navigieren Sie dann zu Ihrem Projekt.

2. Wählen Sie Artefakte und dann Ihren Feed im Dropdownmenü aus.

3. Wählen Sie "Mit Feed verbinden" und dann " Maven " im linken Navigationsbereich aus.

4. Wenn Sie Azure Artifacts mit Maven zum ersten Mal verwenden, stellen Sie sicher, dass Sie die erforderlichen Komponenten installiert haben. Wählen Sie andernfalls "Tools in der oberen rechten Ecke abrufen" aus, um sie zu installieren.

5. Folgen Sie den Anweisungen im Abschnitt "Project-Setup ", um Ihre pom.xml und settings.xml Dateien einzurichten. Ihre Dateien sollten den folgenden Beispielen ähneln:

   • 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. Generieren Sie ein persönliches Zugriffstoken mit Lese- und Schreibbereich zum Verpacken>, und fügen Sie es dann in das <password> Tag ein.

Veröffentlichen von Paketen

1. Öffnen Sie ein Eingabeaufforderungsfenster, und navigieren Sie zu Ihrem Projektverzeichnis, in dem sich Ihre pom.xml Datei befindet, und führen Sie dann den folgenden Befehl aus, um Ihr Projekt zu verpacken. Dieser Befehl kompiliert Ihren Code, führt Tests ein und packt Ihr Projekt in ein verteilungsfähiges Format (z. B. eine JAR-Datei).

   mvn package
   

2. Führen Sie den folgenden Befehl aus Ihrem Projektverzeichnis aus, um Ihr Paket in Ihrem Feed zu veröffentlichen:

   mvn deploy
   

3. Nachdem Sie Ihr Paket erfolgreich bereitgestellt haben, steht es in Kürze in Ihrem Feed zur Verfügung.

   

Hinweis

Wenn Ihre Organisation eine Firewall oder einen Proxy-Server verwendet, stellen Sie sicher, dass Sie Azure Artifacts-Domänen-URLs und IP-Adressen zulassen.

Pakete wiederherstellen

1. Navigieren Sie zu Artefakten in Ihrem Azure DevOps-Projekt, wählen Sie Ihren Feed aus dem Dropdownmenü aus, und wählen Sie dann das Paket aus, das Sie installieren möchten.

2. Navigieren Sie zu "Overview>Maven", und kopieren Sie dann den Abhängigkeitsausschnitt.

3. Öffnen Sie die pom.xml Datei, und fügen Sie den Codeausschnitt in das <dependencies> Tag ein.

4. Führen Sie den folgenden Befehl aus dem Verzeichnis aus, in dem sich Ihre pom.xml Datei befindet, um Ihre Pakete wiederherzustellen:

   mvn install
   

Verwandte Artikel

• Veröffentlichen von Maven-Artefakten mit Azure Pipelines
• Verwenden von Paketen aus Maven Central
• Verwenden von Upstreamquellen in einem öffentlichen Feed