Csatlakozás Azure Artifacts-hírcsatornákba (NuGet.exe)
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 különböző forrásokból, beleértve a hírcsatornákat és a nyilvános regisztrációs adatbázisokat. Privát Azure Artifacts-hírcsatornákkal privátan oszthat meg csomagokat a csapatával vagy adott felhasználóival. Emellett nyilvános hírcsatornákat is létrehozhat, amelyek nyilvánosan elérhetővé teszik a csomagokat, így nyíltan megoszthatja őket bárkivel az interneten. Ez a cikk végigvezeti az Azure Artifacts-hírcsatornához való csatlakozáson.
Előfeltételek
Egy Azure DevOps-szervezet és egy projekt. Ha még nem tette meg, hozzon létre egy szervezetet vagy projektet.
Azure Artifacts-hírcsatorna. Hozzon létre egy új hírcsatornát, ha még nem rendelkezik ilyen hírcsatornával .
Telepítse a legújabb NuGet-verziót.
Telepítse az Azure Artifacts hitelesítőadat-szolgáltatót.
Projekt beállítása
Jelentkezzen be az Azure DevOps-szervezetbe, és lépjen a projekthez.
Válassza az Összetevők lehetőséget, majd válassza ki a hírcsatornát a legördülő menüből.
Válassza a Csatlakozás, majd a bal oldali panelen válassza a NuGet.exe lehetőséget.
Ha először használja az Azure Artifactst NuGet.exe, győződjön meg arról, hogy telepítette az előfeltételeket, ellenkező esetben a telepítéshez válassza az Eszközök lekérése a jobb felső sarokban lehetőséget.
Adjon hozzá egy nuget.config fájlt a projekthez, helyezze a csproj vagy sln fájllal megegyező mappába, majd illessze be a megadott kódrészletet. A kódrészletnek a következőképpen kell strukturálnia:
Projekt hatókörű hírcsatorna:
<?xml version="1.0" encoding="utf-8"?> <configuration> <packageSources> <clear /> <add key="<SOURCE_NAME>" value="https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/nuget/v3/index.json" /> </packageSources> </configuration>
Szervezeti hatókörű hírcsatorna:
<?xml version="1.0" encoding="utf-8"?> <configuration> <packageSources> <clear /> <add key="<SOURCE_NAME>" value="https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/_packaging/<FEED_NAME>/nuget/v3/index.json" /> </packageSources> </configuration>
Jelentkezzen be az Azure DevOps-kiszolgálóra, és lépjen a projekthez.
Válassza az Összetevők lehetőséget, majd válassza ki a hírcsatornát a legördülő menüből.
Válassza ki a Csatlakozás hírcsatornába, majd a bal oldali navigációs panelen válassza a NuGet.exe lehetőséget.
A hírcsatornához való csatlakozáshoz kövesse a Project beállítási szakaszának utasításait.
Jelentkezzen be az Azure DevOps-kiszolgálóra, és lépjen a projekthez.
Válassza az Összetevők lehetőséget, majd válassza ki a hírcsatornát.
Válassza a Csatlakozás hírcsatornába, majd a bal oldali navigációs panelen válassza a NuGet lehetőséget.
A megadott utasításokat követve adja hozzá a csomag forrás URL-címét a nuget.config fájlhoz .
Fontos
Az Azure Artifacts hitelesítőadat-szolgáltatójához NuGet 4.8.0.5385
vagy újabb szükséges.
Az optimális teljesítmény érdekében az Azure Artifacts a NuGet-verzió vagy újabb verzió 5.5.x
használatát javasolja, mivel a lemondásokkal és időtúllépésekkel kapcsolatos kulcsfontosságú hibajavításokat tartalmaz.
Örökölt projektbeállítás
Ha a NuGet régebbi verzióját használja, kövesse az alábbi utasításokat a hírcsatornához való csatlakozáshoz:
Jelentkezzen be az Azure DevOps-szervezetbe, és lépjen a projekthez.
Válassza az Összetevők lehetőséget, majd válassza ki a hírcsatornát a legördülő menüből.
Válassza a Csatlakozás, majd a bal oldali panelen válassza a NuGet.exe lehetőséget.
Másolja ki a forrás URL-címét, majd cserélje le a következőre
/v3/index.json
/v2
: . A frissített forrás URL-címének a következőhöz kell hasonlítania:Projekt hatókörű hírcsatorna:
https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/nuget/v2
Szervezeti hatókörű hírcsatorna:
https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/_packaging/<FEED_NAME>/nuget/v2
Hozzon létre egy személyes hozzáférési jogkivonatot, és győződjön meg arról, hogy a megfelelő szervezethez szeretné hatókörbe helyezni, és válasszon a következő hatókörök közül: Csomagolás (olvasás),Csomagolás (olvasás és írás) vagy Csomagolás (olvasás, írás és kezelés).
Futtassa a következő parancsot egy parancssori ablakban a hírcsatorna forrásának a nuget.config fájlhoz való hozzáadásához:
nuget sources add -name <FEED_NAME> -source <SOURCE_URL> -username <ANY_STRING_BUT_NOT_NULL> -password <YOUR_PERSONAL_ACCESS_TOKEN>
Ha a szervezet csatlakozik a Microsoft Entra-azonosítóhoz, először hitelesítenie kell az AD-hitelesítő adatait, majd hozzá kell adnia a személyes hozzáférési jogkivonatát a setapikey paranccsal:
nuget sources add -name <FEED_NAME> -source <SOURCE_URL> -username <AZURE_ACTIVE_DIRECTORY_USERNAME> -password <AZURE_ACTIVE_DIRECTORY_PASSWORD> nuget setapikey <YOUR_PERSONAL_ACCESS_TOKEN> -source <SOURCE_URL>