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

  • Článek

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

Azure Artifacts umožňuje vývojářům publikovat a stahovat balíčky NuGet z různých zdrojů, jako jsou informační kanály a veřejné registry. Pomocí Azure Artifacts můžete vytvářet informační kanály, které můžou být buď soukromé, a umožnit vám sdílet balíčky s vaším týmem a konkrétními uživateli nebo s veřejností, abyste je mohli veřejně sdílet s kýmkoli na internetu.

V tomto článku se naučíte:

  • Vytvoření nového informačního kanálu
  • Nastavení projektu a připojení k informačnímu kanálu
  • Publikování balíčků NuGet
  • Stažení balíčků z informačního kanálu

Požadavky

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

Azure Artifacts nabízí dva typy informačních kanálů: informační kanály v oboru projektu a informační kanály v oboru organizace. Pokud chcete vytvořit veřejný informační kanál, začněte vytvořením informačního kanálu s vymezeným projektem a pak upravte nastavení viditelnosti projektu, který je hostitelem vašeho informačního kanálu, na veřejné. Díky tomu bude informační kanál v oboru projektu přístupný veřejnosti.

  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 informační kanál pro potřeby

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řipojení do informačního 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řipojení pro informační kanál.

    Snímek obrazovky znázorňující tlačítko připojit se k informačnímu kanálu

  4. Vyberte NuGet.exe. Pokud používáte Azure Artifacts s Nuget.exe poprvé, ujistěte se, že jste nainstalovali všechny požadavky.

  5. Podle pokynů uvedených v části Nastavení projektu nakonfigurujte soubor nuget.config.

    Snímek obrazovky znázorňující, jak nastavit projekt

Stažení balíčků

1. Získání zdrojové adresy URL informačního kanálu

  1. Přejděte do projektu a pak vyberte Artefakty a pak svůj informační kanál.

  2. Vyberte Připojení k informačnímu kanálu a pak na levém navigačním panelu vyberte Visual Studio.

  3. Zkopírujte zdrojovou adresu URL.

    Snímek obrazovky zobrazující zdrojovou adresu URL

2. Nastavení sady Visual Studio

  1. V sadě Visual Studio vyberte Nástroje a potom Možnosti.

  2. Rozbalte Správce balíčků oddíl NuGet a pak vyberte Zdroje balíčků.

  3. Zadejte název informačního kanálu a adresu URL zdroje a pak vyberte zelené znaménko (+) a přidejte zdroj.

  4. Pokud jste v informačním kanálu povolili nadřazené zdroje, zrušte zaškrtnutí políčka nuget.org .

  5. Až budete hotovi, vyberte OK .

    Snímek obrazovky znázorňující postup nastavení sady Visual Studio ve Windows

3. Stahování balíčků

  1. V sadě Visual Studio klikněte pravým tlačítkem myši na projekt a pak vyberte Spravovat balíčky NuGet.

  2. Vyberte Procházet a pak v rozevírací nabídce Zdroj balíčku vyberte svůj informační kanál.

    Snímek obrazovky znázorňující, jak vybrat zdroj informačního kanálu

  3. Pomocí panelu hledání vyhledejte balíčky z informačního kanálu.

Poznámka:

Použití Průzkumníka balíčků NuGet k vyhledání balíčků v upstreamech se nepodporuje.

Publikování balíčků

Spuštěním následujícího příkazu publikujte balíček do informačního kanálu. Pro argument ApiKey můžete použít libovolný řetězec.

nuget.exe push -Source <SOURCE_NAME> -ApiKey key <PACKAGE_PATH>