Publikování prvního balíčku do informačního kanálu Azure Artifacts

Azure Artifacts umožňuje vývojářům efektivně spravovat všechny jejich závislosti z jednoho kanálu. Informační kanály v Azure Artifacts slouží jako úložiště organizace pro ukládání, správu a sdílení balíčků, ať už v rámci týmu, napříč organizacemi nebo veřejně na internetu. Azure Artifacts podporuje širokou škálu typů balíčků, včetně Balíčků NuGet, npm, Pythonu, Mavenu, Cargo a Univerzálních balíčků.

Tento článek vás provede publikováním prvního balíčku NuGet do informačního kanálu Azure Artifacts. Volitelně můžete podle pokynů použít GitHub Copilot k nastavení projektu a přípravě balíčku na publikování.

Požadavky

produkt	Požadavky
Azure DevOps	– organizace Azure DevOps . – projekt Azure DevOps . – Stáhněte a nainstalujte zprostředkovatele přihlašovacích údajů Azure Artifacts. – Donwload a nainstalujte nejnovější verzi NuGetu.
GitHub Copilot (volitelné)	- Nastavte GitHub Copilot a Visual Studio Code. 30denní bezplatná zkušební verze GitHub Copilotu je dostupná, pokud jste se ještě nepřihlásili.

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

Pokud už informační kanál máte, můžete tuto část přeskočit. V opačném případě pomocí následujícího postupu vytvořte nový informační kanál v Azure Artifacts:

1. Přihlaste se ke své organizaci Azure DevOps a přejděte k projektu.

2. Vyberte Artefakty a pak vyberte Vytvořit informační kanál.

3. Zadejte popisný název informačního kanálu a nastavte jeho viditelnost tak, aby definoval, kdo může zobrazit balíčky v informačním kanálu. Definujte obor informačního kanálu a zaškrtněte políčko Nadřazené zdroje , pokud chcete zahrnout balíčky z veřejných zdrojů.

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

   

Příprava balíčku

V tomto příkladu použijete ukázkovou knihovnu tříd .NET Core a před sestavením projektu nastavíte metadata balíčku a vytvoříte balíček NuGet připravený k publikování do informačního kanálu. Pokud projekt ještě nemáte, postupujte podle pokynů v tomto průvodci a vytvořte knihovnu tříd .NET pomocí editoru Visual Studio Code.

Bez GitHub Copilotu

1. Otevřete projekt v editoru Visual Studio Code a vyberte soubor csproj . Přidejte metadata balíčku do značky <PropertyGroup> . Soubor by měl vypadat přibližně takto:

   <Project Sdk="Microsoft.NET.Sdk">
   
     <PropertyGroup>
       <TargetFramework>net8.0</TargetFramework>
       <RootNamespace>demo_class_library</RootNamespace>
       <ImplicitUsings>enable</ImplicitUsings>
       <Nullable>enable</Nullable>
   
       <PackageId>YOUR_PACKAGE_NAME</PackageId>
       <Version>YOUR_PACKAGE_VERSION</Version>
       <Authors>YOUR_NAME</Authors>
       <Company>YOUR_COMPANY</Company>
   
     </PropertyGroup>
   
   </Project>
   

2. Spuštěním následujícího příkazu v adresáři projektu sestavte projekt a vytvořte balíček .nupkg . Balíček bude ve bin\release složce.

   dotnet pack
   

Pomocí GitHub Copilotu

Následující příklad vás provede použitím GitHub Copilotu k nastavení metady balíčku a přípravě balíčku na publikování.

1. Otevřete projekt v editoru Visual Studio Code a výběrem souboru csproj v Průzkumníku ho otevřete.

2. Výběrem ikony chatu v horní části otevřete Chat Copilot GitHubu. Váš aktuální kontext souboru by měl zobrazit soubor .csproj .

3. V okně příkazového řádku GitHub Copilot požádejte GitHub copilot, aby přidal metada balíčku. Můžete použít následující výzvu:

   Add the following package metadata to my csproj file:
   PackageId: demoNuGetPackage
   Version: 1.0.0
   Authors: user123
   Company: FabrikamFiber
   

   

4. Po několika sekundách GitHub Copilot potvrdí, že se metadata balíčku přidala do souboru csproj .

   

5. V okně příkazového řádku GitHub Copilot požádejte copilot o sestavení projektu a vygenerování balíčku NuGet. Po zobrazení výzvy k potvrzení vyberte Pokračovat.

   

6. Jakmile bude sestavení úspěšné, GitHub Copilot vás znovu vyzve k potvrzení vygenerování balíčku NuGet. Pokračujte výběrem možnosti Pokračovat.

   

7. Po dokončení se zobrazí potvrzení úspěšného vytvoření balíčku, včetně metadat a místního uložení balíčku.

   

Připojení k informačnímu kanálu

Pomocí následujícího postupu nastavte projekt a připojte se k informačnímu kanálu Azure Artifacts. Ujistěte se, že jste nainstalovali zprostředkovatele přihlašovacích údajů Azure Artifacts a nejnovější verzi NuGetu, jak je uvedeno v požadavcích.

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řipojit k informačnímu kanálu a pak v části NuGet vyberte dotnet.

4. Postupujte podle pokynů v nastavení projektu a nastavte soubor nuget.config . Struktura souboru by měla vypadat přibližně takto:

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

     <?xml version="1.0" encoding="utf-8"?>
     <configuration>
       <packageSources>
         <clear />
         <add key="<FEED_NAME>" value="https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/nuget/v3/index.json" />
       </packageSources>
     </configuration>
     

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

     <?xml version="1.0" encoding="utf-8"?>
     <configuration>
       <packageSources>
         <clear />
         <add key="<FEED_NAME>" value="https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/_packaging/<FEED_NAME>/nuget/v3/index.json" />
       </packageSources>
     </configuration>
     

Publikování balíčku

Spuštěním následujícího příkazu z adresáře projektu publikujte balíček do informačního kanálu Azure Artifacts. Parametr --api-key je povinný, ale při publikování do Azure Artifacts můžete použít libovolnou hodnotu řetězce.

dotnet nuget push --source <FEED_NAME> --api-key <ANY_STRING> <PACKAGE_PATH>

Další kroky

Monitorování úložiště ArtifactsOsvědčené postupy pro Azure ArtifactsVeřejné sdílení balíčků