Kom igång med Maven-paket i Azure Artifacts

  • Artikel

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

Med Azure Artifacts kan utvecklare hantera sina beroenden från en enda feed och samtidigt ge kontroll över paketdelning. Med Azure Artifacts-feeds kan du publicera och återställa Maven-paket och konfigurera överordnade källor för att använda paket från offentliga register som Maven Central, Google Maven Repository, Gradle Plugins och JitPack. Den här artikeln beskriver hur du konfigurerar ditt Maven-projekt, ansluter till ett Azure Artifacts-flöde och publicerar och återställer dina Maven-paket.

Förutsättningar

Skapa en feed

  1. Logga in på din Azure DevOps-organisation och gå sedan till projektet.

  2. Välj Artefakter och välj sedan Skapa feed.

  3. Som Namn anger du ett beskrivande namn för feeden.

    För Synlighet väljer du ett alternativ för att ange vem som kan visa paket i flödet.

    Om du vill inkludera paket från offentliga källor markerar du kryssrutan under Överordnade källor.

    För Omfång anger du om omfånget för ditt flöde är projektet eller organisationen.

  4. Välj Skapa när du är klar.

    Skärmbild som visar val för att skapa en ny feed i Azure DevOps Services.

  1. Logga in på Azure DevOps-servern och gå sedan till projektet.

  2. Välj Artefakter och välj sedan Skapa feed.

  3. Som Namn anger du ett beskrivande namn för feeden.

    För Synlighet väljer du ett alternativ för att ange vem som kan visa paket i flödet.

    Om du vill inkludera paket från offentliga källor markerar du kryssrutan under Överordnade källor.

    För Omfång anger du om omfånget för ditt flöde är projektet eller organisationen.

  1. Välj Skapa när du är klar.

    Skärmbild som visar val för att skapa en ny feed i Azure DevOps 2022.

  1. Välj Skapa när du är klar.

    Skärmbild som visar val för att skapa en ny feed i Azure DevOps 2020.

  1. Logga in på Azure DevOps-servern och gå sedan till projektet.

  2. Välj Artefakter och välj sedan Ny feed.

  3. Som Namn anger du ett beskrivande namn för feeden.

    För Synlighet väljer du ett alternativ för att ange vem som kan visa paket i flödet.

    Om du vill inkludera paket från offentliga källor väljer du alternativet Använd paket från offentliga källor via den här feeden .

  4. Välj Skapa när du är klar.

    Skärmbild som visar val för att skapa en ny feed i Azure DevOps 2019.

Kommentar

Som standard har nyligen skapade feeds projektets build service-värde inställt på Feed och Upstream Reader (Kollaboratör).

Ansluta till en feed

  1. Logga in på din Azure DevOps-organisation och navigera sedan till projektet.

  2. Välj Artefakter och välj sedan din feed från den nedrullningsbara menyn.

  3. Välj Anslut för att mata och välj sedan Maven i det vänstra navigeringsområdet.

  4. Om det här är första gången du använder Azure Artifacts med Maven kontrollerar du att du har installerat förutsättningarna. Annars väljer du Hämta verktygen i det övre högra hörnet för att installera dem.

  5. Följ anvisningarna i avsnittet Projektkonfiguration för att konfigurera dina pom.xml - och settings.xml-filer . Dina filer bör likna följande exempel:

    • 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. Generera en personlig åtkomsttoken med omfånget Paketera>Läs och skriv och klistra sedan in den i taggen.<password>

  1. Logga in på din Azure DevOps-samling och navigera sedan till projektet.

  2. Välj Artefakter och välj sedan din feed från den nedrullningsbara menyn.

  3. Välj Anslut till feed och välj sedan Maven i det vänstra navigeringsfönstret.

  4. Om det här är första gången du använder Azure Artifacts med Maven kontrollerar du att du har installerat förutsättningarna, annars väljer du Hämta verktygen i det övre högra hörnet för att installera dem.

  5. Följ anvisningarna i avsnittet Projektkonfiguration för att konfigurera dina pom.xml - och settings.xml-filer . Dina filer bör likna följande exempel:

    • 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. Generera en personlig åtkomsttoken med omfånget Paketera>Läs och skriv och klistra sedan in den i taggen.<password>

  1. Logga in på din Azure DevOps-samling och navigera sedan till projektet.

  2. Välj Artefakter och välj sedan din feed.

  3. Välj Anslut till feed och välj sedan Maven i det vänstra navigeringsfönstret.

  4. Välj Generera Maven-autentiseringsuppgifter och lägg till autentiseringsuppgifterna i din användare settings.xml fil i taggen <servers> . Filen ska se ut som i följande exempel:

      <servers>
    <server>
      <id>server-2019-defaultcollection-demo</id>
      <username><FEED_NAME></username>
      <password>xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx</password>
    </server>
  </servers>

  5. Lägg till det andra kodfragmentet i projektets pom.xml i både taggarna <repositories> och <distributionManagement> . Filen ska se ut som i följande exempel:

      <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>

Publicera paket

  1. Öppna ett kommandotolksfönster och gå till projektkatalogen där din pom.xml fil finns och kör sedan följande kommando för att paketera projektet. Det här kommandot kompilerar din kod, kör tester som ingår och paketerar projektet i ett distributionsbart format (till exempel en JAR-fil).

    mvn package

  2. Kör följande kommando från projektkatalogen för att publicera paketet i feeden:

    mvn deploy

  3. När paketet har distribuerats är det snart tillgängligt i feeden.

    En skärmbild som visar ett Maven-paket som distribuerats till en feed.

Kommentar

Om din organisation använder en brandvägg eller en proxyserver kontrollerar du att du tillåter URL:er och IP-adresser för Azure Artifacts-domäner.

Återställa paket

  1. Gå till Artefakter i ditt Azure DevOps-projekt, välj din feed på den nedrullningsbara menyn och välj sedan det paket som du vill installera.

  2. Gå till Översikt>Maven och kopiera sedan beroendefragmentet.

  3. Öppna filen pom.xml och klistra in kodfragmentet i taggen <dependencies> .

  4. Kör följande kommando från katalogen där din pom.xml-fil finns för att återställa paketen:

    mvn install