Rövid útmutató: A NuGet-csomagok használatának első lépései az Azure Artifactsben

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

Az Azure Artifacts lehetővé teszi a fejlesztők számára, hogy NuGet-csomagokat tegyenek közzé és töltsenek le olyan forrásokból, mint a hírcsatornák és a nyilvános adatbázisok. Az Azure Artifacts használatával olyan hírcsatornákat hozhat létre, amelyek a következők:

• Privát, így csomagokat oszthat meg a csapatával és az adott felhasználókkal.
• Nyilvános, így az interneten bárkivel nyíltan megoszthatja a csomagokat.

Ezen rövid útmutató segítségével megtanulhatja a következőket:

• Hozzon létre egy új hírcsatornát.
• Állítsa be a projektet, és csatlakozzon a hírcsatornához.
• NuGet-csomagok közzététele.
• Töltse le a csomagokat a hírcsatornából.

Előfeltételek

• Ha még nem tette meg, hozzon létre egy Azure DevOps-szervezetet és egy projektet.

• Telepítse a legújabb NuGet-verziót.

• Telepítse az Azure Artifacts hitelesítőadat-szolgáltatót.

Hírcsatorna létrehozása

1. Jelentkezzen be az Azure DevOps-szervezetbe, majd lépjen a projektjéhez.

2. Válassza az Összetevők lehetőséget, majd válassza a Hírcsatorna létrehozása lehetőséget.

3. A Név mezőbe írja be a hírcsatorna leíró nevét.

   A láthatóság érdekében válasszon egy lehetőséget, amely jelzi, hogy ki tekintheti meg a csomagokat a hírcsatornán belül.

   Ha nyilvános forrásokból származó csomagokat szeretne belefoglalni, jelölje be a felsőbb rétegbeli források jelölőnégyzetét.

   A Hatókör mezőben adja meg, hogy a hírcsatorna hatóköre a projekt vagy a szervezet.

4. Ha elkészült, válassza a Létrehozás lehetőséget .

   

Feljegyzés

Az újonnan létrehozott hírcsatornák alapértelmezés szerint a projekt Build Service-értéke Feed és Upstream Reader (Közreműködő) értékre van állítva.

Csatlakozás hírcsatornához

1. Jelentkezzen be az Azure DevOps-szervezetbe, majd lépjen a projektjéhez.

2. Válassza az Összetevők lehetőséget, majd válassza ki a hírcsatornát a legördülő menüből.

3. Válassza a Csatlakozás hírcsatornához lehetőséget, majd a bal oldali panelen válassza a NuGet.exe lehetőséget. Ha most először használja az Azure Artifactst Nuget.exe, győződjön meg arról, hogy az összes előfeltételt telepítette.

   

4. Kövesse a Project beállítási szakaszának utasításait a nuget.config fájl konfigurálásához és az Azure Artifacts használatával történő hitelesítéshez.

   

Csomagok letöltése

1. A csomag forrás URL-címének lekérése

1. Jelentkezzen be az Azure DevOps-kiszolgálóra, majd lépjen a projektjéhez.

2. Válassza az Összetevők lehetőséget, válassza ki a hírcsatornát a legördülő menüből, majd válassza a Csatlakozás a hírcsatornához lehetőséget.

3. Válassza a Visual Studio lehetőséget a bal oldali panelen, majd másolja a forrás URL-címét.

   

2. A Visual Studio beállítása

Windows

1. A Visual Studióban válassza az Eszközök>beállításai lehetőséget.

2. Bontsa ki a NuGet Csomagkezelő szakaszt, majd válassza a Csomagforrások lehetőséget.

3. Adja meg a hírcsatorna névértékét és a forrás URL-címét, majd válassza a zöld pluszjelet (+) a forrás hozzáadásához.

4. Ha engedélyezte a felsőbb rétegbeli forrásokat a hírcsatornában, törölje a nuget.org jelölőnégyzet jelölését.

5. Ha végzett, válassza az OK gombot.

   

macOS

1. Hozzon létre egy személyes hozzáférési jogkivonatot.

2. A Visual Studio menüsávján válassza a Beállítások lehetőséget.

3. Válassza a NuGet, majd a Források lehetőséget.

4. Válassza a Hozzáadás lehetőséget, és adja meg a hírcsatorna nevét, a forrás URL-címét, egy felhasználónevet (bármilyen sztringet) és a személyes hozzáférési jogkivonatot.

5. A forrás mentéséhez válassza az OK gombot .

6. Ha engedélyezte a felsőbb rétegbeli forrásokat a hírcsatornában, törölje a nuget.org jelölőnégyzet jelölését.

7. Ha végzett, válassza az OK gombot.

   

3. Csomagok letöltése

1. A Visual Studióban kattintson a jobb gombbal a projektre, majd válassza a NuGet-csomagok kezelése lehetőséget.

2. Válassza a Tallózás lehetőséget, majd válassza ki a hírcsatornát a Csomag forrása legördülő menüből.

   

3. A keresősávon kereshet csomagokat a hírcsatornából.

Feljegyzés

A NuGet Package Explorer használata a felsőbb rétegbeli forrásokban lévő csomagok kereséséhez nem támogatott.

Csomagok közzététele

A csomag hírcsatornában való közzétételéhez futtassa az alábbi parancsot. Az argumentum bármely sztringje ApiKey megadható.

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

Példák:

• Projekt hatókörű hírcsatorna:

  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
  

• Szervezeti hatókörű hírcsatorna:

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

Feljegyzés

Ez ApiKey kötelező, de tetszőleges értéket használhat az Azure Artifacts-hírcsatornákban való közzétételkor.

Kapcsolódó tartalom

• NuGet-csomagok közzététele az Azure Pipelines használatával (YAML/klasszikus)
• Csomagok közzététele NuGet.org
• Csomagok használata a NuGet-katalógusból