Freigeben über


Erste Schritte mit Maven-Paketen in Azure Artifacts

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

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

Einen Feed erstellen

  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. Bereitstellung einer Name für Ihren Feed, wählen Sie die Sichtbarkeit Option, die festlegt, wer Ihre Pakete einsehen kann, überprüfen Sie Pakete aus allgemeinen öffentlichen Quellen einbeziehen wenn Sie Pakete aus Quellen wie nuget.org or npmjs.com, und für Scope, entscheiden Sie, ob der Feed für Ihr Projekt oder für die gesamte Organisation bestimmt sein soll.

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

    Screenshot der Auswahl zum Erstellen eines neuen Feeds in Azure DevOps Services.

  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. Bereitstellung einer Name für Ihren Feed, wählen Sie die Sichtbarkeit Option, die festlegt, wer Ihre Pakete einsehen kann, überprüfen Sie Pakete aus allgemeinen öffentlichen Quellen einbeziehen wenn Sie Pakete aus Quellen wie nuget.org or npmjs.com, und für Scope, entscheiden Sie, ob der Feed für Ihr Projekt oder für die gesamte Organisation bestimmt sein soll.

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

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

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

    Screenshot der Auswahl 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.

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 >, und fügen Sie es dann in das Tag ein.

  1. Melden Sie sich bei Ihrer Azure DevOps-Sammlung 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, andernfalls wählen Sie "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>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. Generieren Sie ein persönliches Zugriffstoken mit >, und fügen Sie es dann in das 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.

    Screenshot eines Maven-Pakets, das in einem Feed bereitgestellt wird.

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