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
Pokud jste to ještě neudělali, vytvořte organizaci Azure DevOps a projekt.
Nainstalujte nejnovější verzi NuGetu.
Nainstalujte zprostředkovatele přihlašovacích údajů Azure Artifacts.
Vytvoření informačního kanálu
Přihlaste se ke své organizaci Azure DevOps a přejděte k projektu.
Vyberte Artefakty a poté vyberte Vytvořit informační kanál.
Zadejte Název informačního kanálu, zvolte možnost Viditelnost, která definuje, kdo může balíčky zobrazit, zaškrtněte Zahrnout balíčky z běžných veřejných zdrojů,, pokud chcete zahrnout balíčky ze zdrojů, jako jsou nuget.org nebo npmjs.com, a pro Rozsah, rozhodněte, jestli má být informační kanál vymezen pro váš projekt nebo celou organizaci.
Až budete hotovi, vyberte Vytvořit .
Přihlaste se k serveru Azure DevOps a přejděte do projektu.
Vyberte Artefakty a pak vyberte Vytvořit informační kanál.
Zadejte Název informačního kanálu, zvolte možnost Viditelnost, která definuje, kdo může balíčky zobrazit, zaškrtněte Zahrnout balíčky z běžných veřejných zdrojů,, pokud chcete zahrnout balíčky ze zdrojů, jako jsou nuget.org nebo npmjs.com, a pro Rozsah, rozhodněte, jestli má být informační kanál vymezen pro váš projekt nebo celou organizaci.
Až budete hotovi, vyberte Vytvořit .
Až budete hotovi, vyberte Vytvořit .
Přihlaste se k serveru Azure DevOps a přejděte do projektu.
Vyberte Artefakty a pak vyberte Nový kanál.
Do pole Název zadejte popisný název informačního kanálu.
Pro viditelnost vyberte možnost, která určí, kdo může zobrazit balíčky ve feedu.
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 tohoto informačního kanálu.
Až budete hotovi, vyberte Vytvořit .
Poznámka:
Nově vytvořené informační kanály mají ve výchozím nastavení hodnotu služby sestavování projektu nastavenou na Informační kanál a čtečka Upstream (Spolupracovník).
Připojit se k kanálu
Přihlaste se ke své organizaci Azure DevOps a pak přejděte do svého projektu.
Vyberte Artefakty a pak v rozevírací nabídce vyberte svůj informační kanál.
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.
Podle pokynů v části Nastavení projektu nakonfigurujte soubor nuget.config a ověřte ho pomocí Azure Artifacts.
Přihlaste se k serveru Azure DevOps a přejděte do projektu.
Vyberte Artefakty a pak v rozevírací nabídce vyberte svůj informační kanál.
Vyberte Připojit k informačnímu kanálu a pak v levém podokně vyberte NuGet.exe .
Postupujte podle pokynů v části Nastavení projektu a připojte se k informačnímu kanálu.
Přihlaste se k serveru Azure DevOps a přejděte do projektu.
Vyberte Artefakty a pak v rozevírací nabídce vyberte svůj informační kanál.
Vyberte Připojit k informačnímu kanálu a pak v levém podokně vyberte NuGet .
Podle pokynů přidejte zdrojovou adresu URL balíčku do souboru nuget.config.
Stažení balíčků
1. Získání adresy URL zdroje balíčku
Přihlaste se k serveru Azure DevOps a přejděte k projektu.
Vyberte Artefakty, v rozevírací nabídce vyberte svůj kanál a pak vyberte Připojit k kanálu.
V levém navigačním podokně vyberte NuGet a zkopírujte svou adresu URL zdroje balíčku.
Přihlaste se ke své organizaci Azure DevOps a přejděte k projektu.
Vyberte Artefakty, v rozevírací nabídce vyberte svůj informační kanál a pak vyberte Připojit k informačnímu kanálu.
V levém navigačním podokně vyberte sady Visual Studio a zkopírujte adresu URL Zdroj.
2. Nastavení sady Visual Studio
V sadě Visual Studio vyberte >.
Rozbalte sekci Správce balíčků NuGet a pak vyberte Zdroje balíčků.
Zadejte hodnotu Název informačního kanálu a adresu URL zdroje a pak vyberte zelené znaménko plus (+) a přidejte zdroj.
Pokud jste v informačním kanálu povolili nadřazené zdroje, zrušte zaškrtnutí zaškrtávacího políčka nuget.org.
Až budete hotovi, vyberte OK .
3. Stahování balíčků
V sadě Visual Studio klikněte pravým tlačítkem na projekt a pak vyberte Spravovat balíčky NuGet.
Vyberte Procházet a poté vyberte svůj informační kanál ze seznamu Zdroj balíčku.
Pomocí vyhledávací lišty vyhledejte balíčky z vašeho zdroje.
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 ApiKey můžete zadat libovolný řetězec.
nuget.exe push -Source <SOURCE_NAME> -ApiKey key <PACKAGE_PATH>
Příklady:
Informační kanál v rámci 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.nupkgInformační kanál zaměřený na organizaci
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 požadován ApiKey, ale při publikování do informačních kanálů Azure Artifacts můžete použít libovolnou hodnotu.