Sdílet prostřednictvím


Rychlý start: Začínáme s balíčky NuGet v Azure Artifacts

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

Azure Artifacts umožňuje vývojářům publikovat a stahovat balíčky NuGet ze zdrojů, jako jsou informační kanály a veřejné registry. Pomocí Azure Artifacts můžete vytvářet informační kanály, které jsou:

  • Soukromé, takže můžete balíčky sdílet s týmem a konkrétními uživateli.
  • Veřejné, takže můžete balíčky sdílet veřejně s kýmkoli na internetu.

V tomto rychlém startu se naučíte:

  • Vytvořte nový informační kanál.
  • Nastavte projekt a připojte se k informačnímu kanálu.
  • Publikování balíčků NuGet
  • Stáhněte si balíčky z informačního kanálu.

Požadavky

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 .

    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řipojení k informačnímu 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 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ém podokně vyberte NuGet.exe . Pokud používáte Azure Artifacts s Nuget.exe poprvé, ujistěte se, že jste nainstalovali všechny požadavky.

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

  4. Podle pokynů v části Nastavení projektu nakonfigurujte soubor nuget.config a ověřte ho pomocí Azure Artifacts.

    Snímek obrazovky s pokyny pro nastavení projektu

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

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

    Snímek obrazovky s pokyny pro nastavení projektu NuGet v Azure DevOps Serveru 2020 a 2022

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

  4. Podle pokynů přidejte zdrojovou adresu URL balíčku do souboru nuget.config.

    Snímek obrazovky s pokyny pro nastavení projektu NuGet v Azure DevOps Serveru 2019

Stažení balíčků

1. Získání adresy URL zdroje balíčku

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

  2. Vyberte Artefakty, v rozevírací nabídce vyberte informační kanál a pak vyberte Připojit k informačnímu kanálu.

  3. V levém podokně vyberte NuGet a zkopírujte hodnotu url zdroje balíčku.

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

  2. Vyberte Artefakty, v rozevírací nabídce vyberte informační kanál a pak vyberte Připojit k informačnímu kanálu.

  3. V levém podokně vyberte Visual Studio a zkopírujte adresu URL zdroje .

    Snímek obrazovky znázorňující zdrojovou adresu URL

2. Nastavení sady Visual Studio

  1. V sadě Visual Studio vyberte Možnosti nástrojů>.

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

  3. Zadejte hodnotu Název informačního kanálu a adresu URL zdroje a pak vyberte zelené znaménko plus (+) 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í výběry pro nastavení sady Visual Studio ve Windows

3. Stahování balíčků

  1. V sadě Visual Studio klikněte pravým tlačítkem 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í výběr zdroje balíčku v sadě Visual Studio

  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 upstreamových zdrojích se nepodporuje.

Publikování balíčků

Pokud chcete balíček publikovat do informačního kanálu, spusťte následující příkaz. Pro argument můžete zadat libovolný řetězec ApiKey .

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

Příklady:

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

    nuget.exe push -Source https://pkgs.dev.azure.com/myOrganization/MyProject/_packaging/MyFeed/nuget/v3/index.json -ApiKey AZ release/myDemoPackage.1.0.0.nupkg
    
  • Informační kanál s oborem organizace:

    nuget.exe push -Source https://pkgs.dev.azure.com/myOrganization/_packaging/myFeed/nuget/v3/index.json -ApiKey AZ release/myDemoPackage.1.0.0.nupkg
    

Poznámka:

Je ApiKey to povinné, ale při publikování do informačních kanálů Azure Artifacts můžete použít libovolnou hodnotu.