Publikování 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 organizační úložiště pro ukládání, správu a sdílení balíčků v rámci týmu, mezi organizacemi nebo veřejně na internetu. Informační kanály Azure Artifacts podporují širokou škálu typů balíčků, včetně Balíčků NuGet, npm, Python, Maven, Cargo a Universal Packages.

Tento článek vás provede procesem publikování prvního balíčku do informačního kanálu Azure Artifacts. K zjednodušení tohoto procesu a prozkoumání možností chatu Copilotu GitHubu v editoru Visual Studio Code máte také možnost použít GitHub Copilot Chat.

Požadavky

• Pokud jste to ještě neudělali, vytvořte organizaci Azure DevOps a projekt.

• Nainstalujte sadu .NET Core SDK.

• Nainstalujte zprostředkovatele přihlašovacích údajů Azure Artifacts.

• (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

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 (kdo může zobrazit balíčky ve vašem informačním kanálu). Definujte 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 .

   

Příprava kódu

Pomocí GitHub Copilotu

Před publikováním balíčku do dříve vytvořeného informačního kanálu musíte nejprve zabalit projekt a připravit ho na publikování.

Následující příklad vás provede použitím GitHub Copilotu k vytvoření ukázkové knihovny tříd .NET Core a vygenerování balíčku NuGet z příkazového řádku. Pomocí GitHub Copilotu můžete také vygenerovat jiné typy projektů, jako je npm nebo projekty Pythonu.

1. Otevřete Visual Studio Code a výběrem ikony chatu na levém navigačním panelu otevřete chat GitHub Copilot Chat.

2. V poli výzvy. Zeptejte se gitHub copilotu: "Návody vytvořit projekt .NET Core a zabalit ho jako balíček NuGet?". Odpověď GitHub Copilotu může vypadat přibližně takto:

   

3. Podle pokynů vygenerujte projekt, definujte ID balíčku a verzi a zabalte projekt.

Můžete také požádat GitHub Copilot o vysvětlení struktury projektu pomocí @workspace příkazu, který umožňuje interakci se soubory a složkami v aktuálním pracovním prostoru.

@workspace vysvětlit strukturu aplikace

Další užitečnou metodou, jak porozumět novému zdrojovému kódu, je zeptat se GitHub Copilotu, jak konkrétní soubory souvisejí v rámci projektu. Můžete například požádat, jak se soubor csproj vztahuje k Class1.cs souboru:

#file:artifacts-github-copilot.csproj #file:Class1.cs jak tyto soubory souvisejí

Bez GitHub Copilotu

Pomocí těchto kroků vytvoříte základní projekt knihovny tříd z příkazového řádku, nastavíte metadata balíčku a vygenerujete balíček NuGet:

1. Na místním počítači vytvořte novou složku a pojmenujte ji.

2. Otevřete okno příkazového řádku a přejděte do složky, kterou jste vytvořili.

3. Spuštěním následujícího příkazu vytvořte nový projekt knihovny tříd:

   dotnet new classlib
   

4. Otevřete soubor csproj a přidejte metadata balíčku do značky<PropertyGroup>. Struktura souborů by měla 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>
   

5. Spuštěním následujícího příkazu zabalte projekt a vygenerujte artefakt .nupkg . Váš balíček NuGet se vygeneruje v bin\release adresáři.

   dotnet pack
   

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

1. Vyberte Artefakty a pak v rozevírací nabídce vyberte svůj informační kanál.

2. Vyberte Připojit k informačnímu kanálu a pak v části NuGet vyberte dotnet.

3. Postupujte podle pokynů v nastavení projektu a nastavte soubor nuget.config . Struktura souboru by měla vypadat nějak 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>
     

Tip

Můžete se zeptat GitHub Copilotu, jak přidat nový zdroj balíčku do existujícího souboru nuget.config . Copilot vás provede příkazem nuget sources Add pro přidání nové adresy URL zdroje informačního kanálu do souboru nuget.config .

Publikování balíčků

Spuštěním následujícího příkazu z adresáře projektu publikujte balíček. Vyžaduje se klíč apiKey, ale při publikování do informačního kanálu Azure Artifacts můžete použít libovolnou řetězcovou hodnotu.

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

Další kroky

Veřejně spravovat oprávnění ke sdílenésložce úložištěArtefakts