Sdílet prostřednictvím


Použití balíčků z galerie NuGet

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

S upstreamovými zdroji Azure Artifacts můžou vývojáři využívat balíčky z veřejných registrů, jako jsou nuget.org a npmjs.com. Tento článek vás provede procesem nastavení projektu a použitím příkazového řádku k efektivnímu využívání balíčků NuGet z galerie NuGet. V tomto článku se naučíte:

  • Povolení upstreamových zdrojů pro váš informační kanál
  • Přidání galerie NuGet jako nadřazeného zdroje
  • Připojení k informačnímu kanálu
  • Instalace balíčků z nuget.org

Požadavky

Povolení upstreamových zdrojů v informačním kanálu

Pokud jste informační kanál ještě nevytvořili, vytvořte ho podle následujících kroků a nezapomeňte zaškrtnout políčko upstreamové zdroje, abyste je povolili. Pokud už informační kanál máte, pokračujte dalším krokem a přidejte galerii NuGet 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).

Pokud jste při vytváření informačního kanálu zkontrolovali políčko nadřazených zdrojů, měla by se galerie NuGet přidat automaticky. Pokud ne, přidejte ho 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 svůj informační kanál.

  3. Výběrem tlačítka ikona ozubeného kola ikony ozubeného kola přejděte do nastavení informačního kanálu.

  4. Vyberte upstreamové zdroje a pak vyberte Přidat nadřazený zdroj a přidejte nový nadřazený zdroj.

  5. Vyberte Veřejný zdroj a pak v rozevírací nabídce vyberte Galerii NuGet.

  6. Vyberte Přidat , až budete hotovi, a pak vyberte Uložit ještě jednou v pravém horním rohu, aby se změny uložily.

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

  2. Vyberte Artefakty a pak svůj informační kanál.

  3. Výběrem tlačítka ikona ozubeného kola ikony ozubeného kola přejděte do nastavení informačního kanálu.

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

  5. Vyberte Veřejný zdroj a pak v rozevírací nabídce vyberte Galerii NuGet.

  6. skončíte, vyberte Uložit a pak v pravém horním rohu vyberte Uložit a uložte změny.

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

  2. Vyberte Artefakty a pak svůj informační kanál.

  3. Výběrem tlačítka ikona ozubeného kola ikony ozubeného kola přejděte do nastavení informačního kanálu.

  4. Vyberte Nadřazené zdroje a pak vyberte Přidat nadřazený zdroj.

  5. Vyberte Veřejný zdroj a pak v rozevírací nabídce vyberte Galerii NuGet.

  6. Až budete hotovi, vyberte Přidat .

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 svůj informační kanál.

  3. Vyberte Připojit k informačnímu kanálu a pak vyberte NuGet.exe.

  4. Přidejte soubor nuget.config do stejné složky jako soubor .csproj nebo .sln. Vložte zadaný fragment kódu XML do souboru. Pokud použijete následující příklady, nezapomeňte zástupné symboly nahradit odpovídajícími hodnotami pro váš scénář.

    • Informační kanál s oborem organizace:

      <?xml version="1.0" encoding="utf-8"?>
      <configuration>
        <packageSources>
          <clear />
          <add key="<SOURCE_NAME>" value="https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/_packaging/<FEED_NAME>/nuget/v3/index.json" />
        </packageSources>
      </configuration>
      
    • Informační kanál s oborem projektu:

      <?xml version="1.0" encoding="utf-8"?>
      <configuration>
        <packageSources>
          <clear />
          <add key="<SOURCE_NAME>" value="https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/nuget/v3/index.json" />
        </packageSources>
      </configuration>
      
  1. Přihlaste se k serveru Azure DevOps a přejděte k projektu.

  2. Vyberte Artefakty a pak svůj informační kanál.

  3. Vyberte Připojit k informačnímu kanálu a pak v levém navigačním podokně vyberte NuGet.exe .

  4. Postupujte podle pokynů v části Nastavení projektu a připojte se k informačnímu kanálu.

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

  2. Vyberte Artefakty a pak svůj informační kanál.

  3. Vyberte Připojit k informačnímu kanálu a pak v levém navigačním podokně vyberte NuGet .

  4. Postupujte podle pokynů pro přidání zdrojové adresy URL balíčku do souboru nuget.config .

S naším projektem nakonfigurovaným pro ověření v informačním kanálu teď můžeme pokračovat k instalaci balíčků z upstreamové galerie NuGet. V tomto příkladu nainstalujeme knihovnu protokolování diagnostiky Serilog :

  1. Přejděte do galerie NuGet na adrese https://www.nuget.org/.

  2. Vyhledejte balíček Serilog a pak ho vyberte, abyste přešli na stránku podrobností.

  3. Vyberte kartu Správce balíčků a zkopírujte příkaz. V našem příkladu je příkaz následující:

    NuGet\Install-Package Serilog -Version 3.1.2-dev-02097
    
  4. Otevřete projekt v sadě Visual Studio a pak výběrem nástroje >NuGet Správce balíčků> Správce balíčků Konzola otevřete okno konzoly.

  5. Vložte příkaz do okna konzoly Správce balíčků a stisknutím klávesy Enter nainstalujte balíček.

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ů

  1. Přihlaste se ke své organizaci Azure DevOps a přejděte k projektu.
  1. Přihlaste se k serveru Azure DevOps a přejděte k projektu.
  1. Vyberte Artefakty a pak v rozevírací nabídce vyberte svůj informační kanál.

  2. V rozevírací nabídce vyberte zdroj galerie NuGet a vyfiltrujte balíčky z tohoto upstreamu.

  3. Balíček Serilog , nainstalovaný v předchozím kroku, je nyní k dispozici v našem informačním kanálu. Služba Azure Artifacts při spuštění příkazu 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 upstreamu