Megosztás a következőn keresztül:

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

Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2020

Az Azure Artifacts lehetővé teszi a fejlesztők számára, hogy NuGet-csomagokat töltsenek le különböző forrásokból, például privát hírcsatornákból és nyilvános adatbázisokból. A csomagokat közzéteheti magáncsatornákon, és szabályozhatja a hozzáférést, vagy létrehozhat nyilvános hírcsatornákat, hogy nyíltan megoszthassa őket. Ez a cikk végigvezeti az Azure Artifacts-hírcsatornán való hitelesítésen.

Előfeltételek

termék Követelmények
Azure DevOps - Egy Azure DevOps szervezet.
- Azure DevOps-projekt.
- Azure Artifacts feed.
- Töltse le és telepítse az Azure Artifacts hitelesítőadat-szolgáltató.
- Telepítse a legújabb NuGet-verziót.

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 a hírcsatornához lehetőséget, majd válassza a bal oldaliNuGet.exe .

  4. Vegyen fel egy nuget.config fájlt a projektbe, helyezze a csproj vagy sln fájllal megegyező mappába, majd illessze be a megadott kódrészletet. A nuget.config fájlnak az alábbiakhoz kell hasonlítania:

    • 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-gyűjteménybe, é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 a hírcsatornáhozlehetőséget, majd a bal oldali navigációs panelen válassza a NuGet.exe lehetőséget.

  4. Adjon hozzá egynuget.config fájlt a projekthez, helyezze a csproj - vagy sln-fájllal megegyező mappába, majd illessze be a fájlba a Projekt beállítása szakaszban megadott kódrészletet.

Megjegyzés:

Az Azure Artifacts hitelesítőadat-szolgáltatójához NuGet-verzióra vagy újabb verzióra 4.8.0.5385 van szükség. 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 is tartalmaz.

Örökölt projekt konfigurálá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 a hírcsatornához lehetőséget, majd válassza a bal oldaliNuGet.exe .

  4. Másolja ki a forrás URL-címét a Project beállítási szakaszából, majd cserélje le a következőre /v3/index.json/v2: . A frissített forrás URL-címének az alábbihoz hasonlóan kell kinéznie:

    • 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, győződjön meg arról, hogy a megfelelő szervezetre terjed ki, majd az igényeinek megfelelően válasszon az alábbi 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. A következő parancs futtatásával adja hozzá a hírcsatorna forrását a nuget.config fájlhoz egy parancssori ablakban:

    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>

Hitelesítés szolgáltatási hitelesítővel

Ha Azure Artifacts hírcsatornával szeretne hitelesítést végezni egy szolgáltatási főnévvel, állítsa be a ARTIFACTS_CREDENTIALPROVIDER_FEED_ENDPOINTS környezeti változót az alábbiak szerint.

Ez adja meg a hírcsatorna URL-címét, a szolgáltatási főazonosító alkalmazásának (ügyfél) azonosítóját, valamint vagy a szolgáltatási főazonosító tanúsítvány tárgyának nevét, vagy a fájlútvonalát (a kettő közül csak az egyikre van szükség).

$env:ARTIFACTS_CREDENTIALPROVIDER_FEED_ENDPOINTS = @'{
    "endpointCredentials": [
        {
            "endpoint": "<FEED_URL>",
            "clientId": "<SERVICE_PRINCIPAL_APPLICATION_(CLIENT)_ID>",
            "clientCertificateSubjectName": "<SERVICE_PRINCIPAL_CERTIFICATE_NAME>",
            "clientCertificateFilePath": "<SERVICE_PRINCIPAL_CERTIFICATE_PATH>"
        }
    ]
}
'@

Kapcsolódó tartalom