Sdílet prostřednictvím


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

    Snímek obrazovky znázorňující výběry pro vytvoření nového informačního kanálu v Azure DevOps Services

  1. Přihlaste se k serveru Azure DevOps a přejděte do 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.

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

    Snímek obrazovky znázorňující výběry pro vytvoření nového informačního kanálu v Azure DevOps 2022

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

    Snímek obrazovky znázorňující výběry pro vytvoření nového informačního kanálu v Azure DevOps 2020

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

  2. Vyberte Artefakty a pak vyberte Nový 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ů, 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í výběry pro vytvoření nového informačního kanálu v Azure DevOps 2019

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ř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 pak vikona ozubeného kola pravé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 vyberte Přidat , až budete hotovi.

    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