Použití balíčků z Maven Central

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

Použití upstreamových zdrojů Azure Artifacts umožňuje použít jeden informační kanál pro hostování balíčků, které vytváříte, i balíčků z veřejných registrů, jako je Maven Central. Když do informačního kanálu přidáte nadřazené zdroje, Azure Artifacts uloží kopii libovolného balíčku nainstalovaného z upstreamu. Tím zajistíte nepřetržitou přístupnost pro váš vývoj, i když veřejný registr trpí výpadkem. Kromě toho Azure Artifacts podporuje různé další upstreamové zdroje Mavenu, včetně úložiště Google Maven, modulů plug-in Gradle a JitPack.

Požadavky

Poznámka:

Snímky Mavenu nejsou podporovány u upstreamových zdrojů Mavenu.

Povolení upstreamových zdrojů

Pokud informační kanál ještě nemáte, vytvořte ho podle těchto pokynů a ujistěte se, že zaškrtnete políčko upstreamových zdrojů , abyste je povolili. Pokud už informační kanál máte, přejděte k dalšímu kroku a přidejte Maven Central jako nadřazený zdroj.

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

  2. Vyberte Artifacts (Artefakty) a pak vyberte Create Feed (Vytvořit informační kanál ) a vytvořte nový informační kanál.

  3. Zadejte popisný název informačního kanálu a definujte jeho viditelnost (označující, kdo může zobrazit balíčky v informačním kanálu). Zadejte obor informačního kanálu a pokud chcete zahrnout balíčky z veřejných zdrojů, zaškrtněte políčko Nadřazené zdroje.

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

    Snímek obrazovky znázorňující, jak vytvořit nový informační kanál v Azure DevOps Services

  1. Přihlaste se k serveru Azure DevOps a přejděte k projektu.

  2. Vyberte Artifacts (Artefakty) a pak vyberte Create Feed (Vytvořit informační kanál ) a vytvořte nový informační kanál.

  3. Zadejte popisný název informačního kanálu a definujte jeho viditelnost (označující, kdo může zobrazit balíčky v informačním kanálu). Zadejte obor informačního kanálu a pokud chcete zahrnout balíčky z veřejných zdrojů, zaškrtněte políčko Nadřazené zdroje.

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

    Snímek obrazovky znázorňující, jak vytvořit nový informační kanál v Azure DevOps 2022

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

    Snímek obrazovky znázorňující, jak vytvořit nový informační kanál v Azure DevOps 2020

  1. Přihlaste se k serveru Azure DevOps a přejděte k projektu.

  2. Vyberte Artefakty a pak vyberte Nový informační kanál.

  3. Zadejte popisný název informačního kanálu a definujte jeho viditelnost (označující, kdo může zobrazit balíčky v informačním kanálu). Pokud chcete zahrnout balíčky z veřejných zdrojů, vyberte možnost Použít balíčky z veřejných zdrojů prostřednictvím této možnosti informačního kanálu .

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

    Snímek obrazovky znázorňující, jak vytvořit nový informační kanál v Azure DevOps 2019

Poznámka:

Nově vytvořené informační kanály mají ve výchozím nastavení nastavenou službu buildu projektu na kanál a upstreamovou čtečku (spolupracovníci).

Přidání hlavního upstreamu Mavenu

Pokud jste při vytváření informačního kanálu zkontrolovali zaškrtávací políčko upstreamových zdrojů , maven Central by už měl být přidaný jako nadřazený zdroj. Pokud ne, můžete ho přidat ručně pomocí následujícího postupu:

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

  2. Vyberte Artefakty a potom vikona ozubeného kolapravém horním rohu přejděte do Nastavení informačního kanálu.

  3. Vyberte upstreamové zdroje a pak vyberte Přidat upstream.

  4. Vyberte Veřejný zdroj, v rozevírací nabídce vyberte Maven Central (https://repo.maven.apache.org/maven2/) a pak po dokončení vyberte Uložit .

    Snímek obrazovky znázorňující, jak přidat centrální nadřazený zdroj Mavenu

  5. Výběrem možnosti Uložit v pravém horním rohu uložte provedené změny.

    Snímek obrazovky znázorňující, jak uložit nadřazené zdroje

Uložení balíčku z Maven Central

Před uložením balíčků z Maven Central se ujistěte, že máte nastavený projekt pro připojení k informačnímu kanálu. Pokud jste to ještě neudělali, podle pokynů v nastavení projektu nastavte projekt Maven a připojte se k informačnímu kanálu.

V tomto příkladu uložíme knihovnu Kotlin Datetime z Mavenu – střed.

  1. Přejděte do Maven Central na adrese https://mvnrepository.com/.

  2. Vyhledejte knihovnu Kotlin Datetime. Vyberte balíček Kotlinx Datetime a pak vyberte verzi, kterou chcete nainstalovat.

  3. <dependency> Zkopírujte fragment kódu z karty Maven.

    <dependency>
        <groupId>org.jetbrains.kotlinx</groupId>
        <artifactId>kotlinx-datetime-jvm</artifactId>
        <version>0.4.1</version>
        <scope>runtime</scope>
    </dependency>
    
  4. Otevřete soubor pom.xml a vložte fragment kódu do <dependencies> značky a pak soubor uložte.

  5. Spuštěním následujícího příkazu ze stejné cesty jako soubor pom.xml nainstalujte závislosti:

    mvn install
    

Poznámka:

Pokud chcete ukládat balíčky z upstreamů, musíte mít roli Feed and Upstream Reader (Spolupracovníci) nebo vyšší. Další podrobnosti najdete v tématu Správa oprávnění .

Zobrazení uložených balíčků

Balíčky, které jste uložili z upstreamů, můžete zobrazit výběrem centrálního zdroje Maven z rozevírací nabídky.

  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. V rozevírací nabídce zdroje vyberte Maven Central a vyfiltrujte balíčky z tohoto upstreamu.

  4. Balíček Kotlinx Datetime , který jsme uložili v předchozím kroku, je nyní k dispozici v našem informačním kanálu. Azure Artifacts při spuštění příkazu mvn install automaticky uložila kopii do našeho informačního kanálu.

Snímek obrazovky znázorňující balíček uložený z Mavenu – střed

Tip

Pokud Maven nestahuje všechny vaše závislosti, spusťte z adresáře projektu následující příkaz, který znovu vygeneruje soubory projektu: mvn eclipse:eclipse -DdownloadSources=true -DdownloadJavadocs=true