Share via

Csatlakozás Azure Artifacts-hírcsatornákba (NuGet.exe)

  • Cikk

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

Projekt beállítása

  1. Jelentkezzen be az Azure DevOps-szervezetbe, és lépjen a projekthez.

  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, majd a bal oldali panelen válassza a NuGet.exe lehetőséget.

  4. 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.

  5. 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>

  1. Jelentkezzen be az Azure DevOps-kiszolgálóra, és lépjen a projekthez.

  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 ki a Csatlakozás hírcsatornába, majd a bal oldali navigációs panelen válassza a NuGet.exe lehetőséget.

  4. A hírcsatornához való csatlakozáshoz kövesse a Project beállítási szakaszának utasításait.

  1. Jelentkezzen be az Azure DevOps-kiszolgálóra, és lépjen a projekthez.

  2. Válassza az Összetevők lehetőséget, majd válassza ki a hírcsatornát.

  3. Válassza a Csatlakozás hírcsatornába, majd a bal oldali navigációs panelen válassza a NuGet lehetőséget.

  4. 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:

  1. Jelentkezzen be az Azure DevOps-szervezetbe, és lépjen a projekthez.

  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, majd a bal oldali panelen válassza a NuGet.exe lehetőséget.

  4. 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

  5. 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).

  6. 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>

  7. 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>