Freigeben über


Verwenden von Paketen aus Maven Central

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

Mithilfe von Azure Artifacts-Upstreamquellen können Sie einen einzelnen Feed verwenden, um sowohl die Pakete zu hosten, die Sie erstellen, als auch Pakete aus öffentlichen Registrierungen wie Maven Central. Wenn Sie Ihrem Feed Upstreamquellen hinzufügen, speichert Azure Artifacts eine Kopie eines pakets, das aus dem Upstream installiert ist. Dies stellt eine kontinuierliche Zugänglichkeit für Ihre Entwicklung sicher, auch wenn ein öffentliches Register einen Ausfall hat. Darüber hinaus unterstützt Azure Artifacts verschiedene andere Maven-Upstreamquellen, darunter das Google Maven Repository, Gradle Plugins und JitPack.

Voraussetzungen

  • Ein Azure DevOps-organization und ein Projekt. Erstellen Sie ein organization oder ein Projekt, falls noch nicht geschehen.

  • Ein Azure Artifacts-Feed.

Hinweis

Maven-Momentaufnahmen werden mit Maven-Upstream-Quellen nicht unterstützt.

Aktivieren von Upstreamquellen

Wenn Sie noch keinen Feed haben, befolgen Sie diese Anweisungen, um einen feed zu erstellen, und stellen Sie sicher, dass Sie das Kontrollkästchen für upstream-Quellen aktivieren, um sie zu aktivieren. Wenn Sie bereits über einen Feed verfügen, fahren Sie mit dem nächsten Schritt fort, um Maven Central als upstream-Quelle hinzuzufügen.

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

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

  3. Geben Sie einen Namen für Ihren Feed an, wählen Sie die Option Sichtbarkeit aus, die definiert, wer Ihre Pakete anzeigen kann, überprüfen Sie Einschließen von Paketen aus allgemeinen öffentlichen Quellen, wenn Sie Pakete aus Quellen wie nuget.org oder npmjs.comeinschließen möchten, und für Bereichentscheiden Sie, ob der Feed auf Ihr Projekt oder die gesamte Organisation festgelegt werden soll.

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

    Screenshot, der die Auswahlen zum Erstellen eines neuen Feeds in Azure DevOps Services zeigt.

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

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

  3. Geben Sie einen Namen für Ihren Feed an, wählen Sie die Option Sichtbarkeit aus, die definiert, wer Ihre Pakete anzeigen kann, überprüfen Sie Einschließen von Paketen aus allgemeinen öffentlichen Quellen, wenn Sie Pakete aus Quellen wie nuget.org oder npmjs.comeinschließen möchten, und für Bereichentscheiden Sie, ob der Feed auf Ihr Projekt oder die gesamte Organisation festgelegt werden soll.

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

    Screenshot, der die Auswahl zum Erstellen eines neuen Feeds in Azure DevOps 2022 zeigt.

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

    Screenshot der Auswahlmöglichkeiten zum Erstellen eines neuen Feeds in Azure DevOps 2020.

Hinweis

Standardmäßig wird dem Builddienst für das Projekt (z. B. projectName Build Service (orgName)) beim Erstellen eines neuen Feeds die Rolle Feed und Upstream-Reader (Mitarbeiter) zugewiesen.

Hinzufügen von Maven Central upstream

Wenn Sie beim Erstellen Ihres Feeds das Kontrollkästchen "Upstreamquellen " aktiviert haben, sollte Maven Central bereits als Upstreamquelle hinzugefügt werden. Wenn nicht, können Sie es manuell mit den folgenden Schritten hinzufügen:

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

  2. Wählen Sie Artefakte aus, und wählen Sie dann Zahnradsymbol in der oberen rechten Ecke, um zu Ihren Feedeinstellungen zu navigieren.

  3. Wählen Sie Upstreamquellen und dann "Upstream hinzufügen" aus.

  4. Wählen Sie "Öffentliche Quelle", wählen Sie "Maven Central (https://repo.maven.apache.org/maven2/)" aus dem Dropdownmenü und dann "Hinzufügen" aus, wenn Sie fertig sind.

    Screenshot, der zeigt, wie Maven central upstream source hinzugefügt wird.

  5. Wählen Sie "Speichern" in der oberen rechten Ecke aus, um Ihre Änderungen zu speichern.

    Screenshot, der zeigt, wie Upstreamquellen gespeichert werden.

Paket aus Maven Central speichern

Bevor Sie Pakete aus Maven Central speichern, stellen Sie sicher, dass Sie Ihr Projekt für die Verbindung mit Ihrem Feed eingerichtet haben. Wenn Sie dies noch nicht getan haben, befolgen Sie die Anweisungen im Projektsetup , um Ihr Maven-Projekt einzurichten und eine Verbindung mit Ihrem Feed herzustellen. Im folgenden Beispiel wird veranschaulicht, wie Die Kotlin Datetime-Bibliothek mithilfe der Befehlszeile aus Maven Central gespeichert wird.

Wenn Sie stattdessen Ihre Pakete mit Azure Pipelines speichern/wiederherstellen möchten, führen Sie die Schritte im Lernprogramm "Maven Wiederherstellen von Maven-Paketen mit Azure Pipelines (YAML/Classic)" aus.

  1. Navigieren Sie zu Maven Central unter https://mvnrepository.com/.

  2. Suchen Sie nach der Kotlin Datetime-Bibliothek. Wählen Sie das Kotlinx Datetime-Paket und dann die Version aus, die Sie installieren möchten.

  3. Kopieren Sie den <dependency> Codeausschnitt aus dem Tab "Maven".

    <dependency>
        <groupId>org.jetbrains.kotlinx</groupId>
        <artifactId>kotlinx-datetime-jvm</artifactId>
        <version>0.4.1</version>
        <scope>runtime</scope>
    </dependency>
    
  4. Öffnen Sie die pom.xml Datei, fügen Sie den Codeausschnitt in Ihr <dependencies> Tag ein, und speichern Sie die Datei.

  5. Führen Sie den folgenden Befehl aus demselben Pfad wie Ihre pom.xml Datei aus, um Ihre Abhängigkeiten zu installieren:

    mvn install
    

Hinweis

Um Pakete von Upstreams zu speichern, müssen Sie über die Rolle Feed and Upstream Reader (Mitarbeiter) oder höher verfügen. Weitere Informationen finden Sie unter "Berechtigungen verwalten" .

Anzeigen gespeicherter Pakete

Sie können die Pakete, die Sie von Upstreams gespeichert haben, anzeigen, indem Sie die Quelle Maven Central aus dem Dropdownmenü auswählen.

  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 Maven Central aus dem Quelldropdownmenü aus, um nach Paketen aus diesem Upstream zu filtern.

  4. Das Kotlinx Datetime-Paket , das wir im vorherigen Schritt gespeichert haben, ist jetzt in unserem Feed verfügbar. Azure Artifacts hat automatisch eine Kopie in unserem Feed gespeichert, wenn wir den Mvn-Installationsbefehl ausgeführt haben.

Screenshot eines Pakets, das aus Maven Central gespeichert wurde.

Tipp

Wenn Maven nicht alle Abhängigkeiten herunter lädt, führen Sie den folgenden Befehl aus dem Projektverzeichnis aus, um die Dateien Ihres Projekts neu zu generieren: mvn eclipse:eclipse -DdownloadSources=true -DdownloadJavadocs=true