Začínáme s balíčky Maven v Azure Artifacts

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

Azure Artifacts umožňuje vývojářům spravovat jejich závislosti z jednoho informačního kanálu a zároveň poskytovat kontrolu nad sdílením balíčků. S informačními kanály Azure Artifacts můžete publikovat a obnovovat balíčky Maven a nastavit nadřazené zdroje pro využívání balíčků z veřejných registrů, jako je Maven Central, úložiště Google Maven, moduly plug-in Gradle a JitPack. Tento článek vás provede nastavením projektu Maven, připojením k informačnímu kanálu Azure Artifacts a publikováním a obnovením balíčků Maven.

Požadavky

• Pokud jste to ještě neudělali, vytvořte organizaci Azure DevOps a projekt.

• Stáhněte a nainstalujte Apache Maven.

Vytvoření informačního kanálu

1. Přihlaste se ke své organizaci Azure DevOps a pak přejděte do svého projektu.

2. Vyberte Artefakty a pak vyberte Vytvořit informační kanál.

3. Do pole Název zadejte popisný název informačního kanálu.

   Pokud chcete zobrazit viditelnost, vyberte možnost, která určuje, kdo může zobrazit balíčky v informačním kanálu.

   Pokud chcete zahrnout balíčky z veřejných zdrojů, zaškrtněte políčko v části Nadřazené zdroje.

   V poli Obor určete, jestli je obor informačního kanálu projekt nebo organizace.

4. Až budete hotovi, vyberte Vytvořit .

   

Poznámka:

Nově vytvořené informační kanály mají ve výchozím nastavení hodnotu buildové služby projektu nastavenou na Kanál a Upstream Reader (Spolupracovníci).

Připojení k informačnímu kanálu

1. Přihlaste se ke své organizaci Azure DevOps a přejděte k projektu.

2. Vyberte Artefakty a pak v rozevírací nabídce vyberte svůj informační kanál.

3. Vyberte Připojit k informačnímu kanálu a pak v levé navigační oblasti vyberte Maven .

4. Pokud používáte Azure Artifacts s Mavenem poprvé, ujistěte se, že jste nainstalovali požadavky. V opačném případě vyberte Získat nástroje v pravém horním rohu a nainstalujte je.

5. Podle pokynů v části Nastavení projektu nastavte soubory pom.xml a settings.xml . Soubory by měly vypadat podobně jako v následujících příkladech:

   • 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. Vygenerujte osobní přístupový token s oborem čtení a zápisu balíčku>a vložte ho do značky.<password>

Publikování balíčků

1. Otevřete okno příkazového řádku a přejděte do adresáře projektu, kde se nachází váš soubor pom.xml , a spuštěním následujícího příkazu zabalte projekt. Tento příkaz zkompiluje kód, spustí zahrnuté testy a zabalí projekt do distribuovatelného formátu (například souboru JAR).

   mvn package
   

2. Spuštěním následujícího příkazu z adresáře projektu publikujte balíček do informačního kanálu:

   mvn deploy
   

3. Po úspěšném nasazení balíčku bude brzy k dispozici v informačním kanálu.

   

Poznámka:

Pokud vaše organizace používá bránu firewall nebo proxy server, ujistěte se, že povolíte adresy URL a IP adresy domény Azure Artifacts.

Obnovení balíčků

1. V projektu Azure DevOps přejděte na Artefakty , vyberte informační kanál z rozevírací nabídky a pak vyberte balíček, který chcete nainstalovat.

2. Přejděte na Přehled>Mavenu a zkopírujte fragment kódu závislostí.

3. Otevřete soubor pom.xml a vložte fragment kódu do značky<dependencies>.

4. Spuštěním následujícího příkazu z adresáře, ve kterém se nachází soubor pom.xml , obnovte balíčky:

   mvn install
   

Související články

• Publikování artefaktů Mavenu pomocí Azure Pipelines
• Použití balíčků z Maven Central
• Použití upstreamových zdrojů ve veřejném informačním kanálu