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


Csomagok használata a NuGet-katalógusból

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

Az Azure Artifacts felsőbb rétegbeli forrásaival a fejlesztők nyilvános adatbázisokból, például nuget.org és npmjs.com származó csomagokat is felhasználhatnak. Ez a cikk végigvezeti a projekt beállításának folyamatán, és a parancssor használatával hatékonyan felhasználhatja a NuGet-csomagokat a NuGet-katalógusból. Ebből a cikkből megtudhatja, hogyan:

  • Felsőbb rétegbeli források engedélyezése a hírcsatornához
  • NuGet-katalógus hozzáadása felsőbb rétegbeli forrásként
  • Csatlakozás a hírcsatornába
  • Csomagok telepítése nuget.org

Előfeltételek

Felsőbb rétegbeli források engedélyezése a hírcsatornán

Ha még nem hozott létre hírcsatornát, az alábbi lépéseket követve hozzon létre egy újat, és győződjön meg arról, hogy bejelöli a felsőbb rétegbeli források jelölőnégyzetet az engedélyezésükhöz. Ha már rendelkezik hírcsatornával, folytassa a következő lépéssel a NuGet-katalógus felsőbb rétegbeli forrásként való hozzáadásához.

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

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

  3. Adjon meg egy leíró nevet a hírcsatornának, és határozza meg annak láthatóságát (jelezve, hogy ki tekintheti meg a csomagokat a hírcsatornán belül). Adja meg a hírcsatorna hatókörét , és ha nyilvános forrásokból származó csomagokat szeretne belefoglalni, jelölje be a Felsőbb rétegbeli források jelölőnégyzetet.

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

    Képernyőkép arról, hogyan hozhat létre új hírcsatornát az Azure DevOps Servicesben.

  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 a Hírcsatorna létrehozása lehetőséget egy új hírcsatorna létrehozásához.

  3. Adjon meg egy leíró nevet a hírcsatornának, és határozza meg annak láthatóságát (jelezve, hogy ki tekintheti meg a csomagokat a hírcsatornán belül). Adja meg a hírcsatorna hatókörét , és ha nyilvános forrásokból származó csomagokat szeretne belefoglalni, jelölje be a Felsőbb rétegbeli források jelölőnégyzetet.

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

    Képernyőkép arról, hogyan hozhat létre új hírcsatornát az Azure DevOps 2022-ben.

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

    Képernyőkép arról, hogyan hozhat létre új hírcsatornát az Azure DevOps 2020-ban.

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

  2. Válassza az Összetevők lehetőséget, majd az Új hírcsatorna lehetőséget.

  3. Adjon meg egy leíró nevet a hírcsatornának, és határozza meg annak láthatóságát (jelezve, hogy ki tekintheti meg a csomagokat a hírcsatornán belül). Ha nyilvános forrásokból származó csomagokat szeretne belefoglalni, válassza a Nyilvános forrásokból származó csomagok használata lehetőséget ezen a hírcsatorna-beállításon keresztül.

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

    Képernyőkép arról, hogyan hozhat létre új hírcsatornát az Azure DevOps 2019-ben.

Feljegyzés

Az újonnan létrehozott hírcsatornák alapértelmezés szerint a projekt buildszolgáltatását Feed és Upstream Reader (Közreműködő) értékre állítják be.

Ha a hírcsatorna létrehozásakor bejelölte a felsőbb rétegbeli források jelölőnégyzetét, a NuGet-katalógust automatikusan hozzá kellett volna adni. Ha nem, manuálisan adja hozzá az alábbi lépések végrehajtásával:

  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.

  3. A fogaskerék ikon gombra fogaskerék ikon kattintva lépjen a Hírcsatorna beállításaihoz.

  4. Válassza a Felsőbb rétegbeli források lehetőséget, majd az Add Upstream (Upstream hozzáadása) lehetőséget egy új felsőbb rétegbeli forrás hozzáadásához.

  5. Válassza a Nyilvános forrás lehetőséget, majd válassza a NuGet-gyűjteményt a legördülő menüből.

  6. Ha végzett, válassza a Mentés lehetőséget, majd a jobb felső sarokban lévő Mentés gombra kattintva mentse a módosításokat.

  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. A fogaskerék ikon gombra fogaskerék ikon kattintva lépjen a Hírcsatorna beállításaihoz.

  4. Válassza a Felsőbb rétegbeli források lehetőséget, majd az Add Upstream (Felsőbb réteg hozzáadása) lehetőséget.

  5. Válassza a Nyilvános forrás lehetőséget, majd válassza a NuGet-gyűjteményt a legördülő menüből.

  6. Ha végzett, válassza a Mentés lehetőséget, majd a jobb felső sarokban lévő Mentés gombra kattintva mentse a módosításokat.

  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. A fogaskerék ikon gombra fogaskerék ikon kattintva lépjen a Hírcsatorna beállításaihoz.

  4. Válassza a Felsőbb rétegbeli források lehetőséget, majd a Forrás hozzáadása lehetőséget.

  5. Válassza a Nyilvános forrás lehetőséget, majd válassza a NuGet-gyűjteményt a legördülő menüből.

  6. Ha elkészült, válassza a Hozzáadás lehetőséget.

Csatlakozás a hírcsatornához

  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.

  3. Válassza ki a Csatlakozás a hírcsatornához, majd válassza a NuGet.exe.

  4. Adjon hozzá egy nuget.config fájlt ugyanabban a mappában, mint a .csproj vagy .sln fájl. Illessze be a megadott XML-kódrészletet a fájlba. Ha az alábbi példákat használja, győződjön meg arról, hogy a helyőrzőket a forgatókönyvnek megfelelő értékekre cseréli.

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

Miután a projekt már konfigurálva van a hírcsatornával való hitelesítésre, most már telepítheti a csomagokat a NuGet-katalógusból a felsőbb rétegbe. Ebben a példában a Serilog diagnosztikai naplózási kódtárat telepítjük:

  1. Lépjen a NuGet-katalógushoz a következő helyen https://www.nuget.org/: .

  2. Keresse meg a Serilog-csomagot , majd válassza ki a részleteket tartalmazó lapra való navigáláshoz.

  3. Jelölje ki a Csomagkezelő lapot, és másolja ki a parancsot. Példánkban a parancs a következő:

    NuGet\Install-Package Serilog -Version 3.1.2-dev-02097
    
  4. Nyissa meg a projektet a Visual Studióban, majd válassza a Tools>NuGet Csomagkezelő> Csomagkezelő Console lehetőséget a konzolablak megnyitásához.

  5. Illessze be a parancsot a Csomagkezelő konzolablakba, és a csomag telepítéséhez nyomja le az Enter billentyűt.

Feljegyzés

A csomagok felsőbb rétegből való mentéséhez rendelkeznie kell a Hírcsatorna és a Felsőbb rétegbeli olvasó (Közreműködő) szerepkörével. További részletekért lásd : Engedélyek kezelése.

Mentett csomagok megtekintése

  1. Jelentkezzen be az Azure DevOps-szervezetbe, és lépjen a projekthez.
  1. Jelentkezzen be az Azure DevOps-kiszolgálóra, és lépjen a projekthez.
  1. Válassza az Összetevők lehetőséget, majd válassza ki a hírcsatornát a legördülő menüből.

  2. Válassza ki a NuGet-gyűjtemény forrását a legördülő menüből, és szűrjön a felsőbb rétegből származó csomagokra.

  3. Az előző lépésben telepített Serilog-csomag már elérhető a hírcsatornánkban. Az Azure Artifacts automatikusan mentett egy másolatot a hírcsatornánkba a telepítési parancs végrehajtásakor.

    Képernyőkép a felsőbb rétegből mentett csomagról.