Oktatóanyag: Felsőbb rétegbeli források használata

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

A hírcsatornában lévő felsőbb rétegbeli források használatával egyetlen hírcsatornából kezelheti az alkalmazásfüggőségeket. A felsőbb rétegbeli források használata megkönnyíti a nyilvános adatbázisokból származó csomagok felhasználását, miközben védelmet nyújt a kimaradásokkal vagy a sérült csomagokkal szemben. Saját csomagokat is közzétehet ugyanazon a csatornán, és egyetlen helyen kezelheti az összes függőséget.

Ez az oktatóanyag bemutatja, hogyan engedélyezheti a hírcsatornán a felsőbb rétegbeli forrásokat, és hogyan használhat fel nyilvános adatbázisokból származó csomagokat, például NuGet.org vagy npmjs.com.

Az oktatóanyag során az alábbi lépéseket fogja végrehajtani:

• Hozzon létre egy új hírcsatornát, és engedélyezze a felsőbb rétegbeli forrásokat.
• Állítsa be a konfigurációs fájlt.
• Futtasson egy kezdeti csomag-visszaállítást a hírcsatorna feltöltéséhez.
• Ellenőrizze a hírcsatornát a nyilvános beállításjegyzékből felhasznált csomagok mentett másolatának megtekintéséhez.

Hírcsatorna létrehozása és felsőbb rétegbeli források engedélyezése

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 nevet a hírcsatornának, és válassza ki annak láthatóságát. Győződjön meg arról, hogy bejelöli a Közös nyilvános forrásokból származó csomagok belefoglalása jelölőnégyzetet a felsőbb rétegbeli források engedélyezéséhez, majd ha végzett, válassza a Létrehozás lehetőséget .

   

A konfigurációs fájl beállítása

Most, hogy létrehoztuk a hírcsatornát, frissíteni kell a konfigurációs fájlt, hogy a hírcsatornára mutassunk. Ehhez a következőt kell tennünk:

1. A forrás URL-címének lekérése
2. A konfigurációs fájl frissítése

npm

1. Válassza az Összetevők lehetőséget, majd válassza a Csatlakozás a hírcsatornához.

   

2. A lap bal oldalán válassza az npm lapot.

3. A konfigurációs fájl beállításához kövesse a Project beállítási szakaszának utasításait.

   

Ha még nem rendelkezik .npmrc fájllal, hozzon létre egy újat a projekt gyökerében (ugyanabban a mappában, mint a package.json). Nyissa meg az új .npmrc fájlt, és illessze be az előző lépésben másolt kódrészletet.

NuGet

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

2. Válassza a Csatlakozás, majd a NuGet.exe lehetőséget.

   

3. Másolja ki az XML-kódrészletet a Projektbeállítás szakaszban.

4. Hozzon létre egy nuget.config nevű új fájlt a projekt gyökerében.

5. Illessze be az XML-kódrészletet a konfigurációs fájlba.

Pip

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

2. Válassza ki a Csatlakozás a csatornához, majd válassza a Pip elemet a Python szakasz alatt.

   

3. Hozzon létre egy virtuális környezetet , ha még nem tette meg.

4. Vegyen fel egy pip.ini (Windows) vagy pip.conf (Mac/Linux) fájlt a virtualenvbe, és illessze be a következő kódrészletet:

   [global]
   index-url=https://pkgs.dev.azure.com/ORGANIZATION-NAME/_packaging/FEED-NAME/pypi/simple/
   

Maven

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

2. Válassza a Csatlakozás, majd a Maven lehetőséget.

   

3. Adja hozzá a következő kódrészletet a <repositories> pom.xml és <distributionManagement> szakaszaihoz:

   <repository>
     <id>[FEED-NAME]</id>
     <url>https://pkgs.dev.azure.com/[ORGANIZATION-NAME]/_packaging/[FEED-NAME]/maven/v1</url>
     <releases>
       <enabled>true</enabled>
     </releases>
     <snapshots>
       <enabled>true</enabled>
     </snapshots>
   </repository>
   

4. Vegyen fel egy fájlt <server> a settings.xml fájlba:

   <settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0
                                 https://maven.apache.org/xsd/settings-1.0.0.xsd">
     <servers>
       <server>
         <id>[FEED-NAME]</id>
         <username>[ORGANIZATION-NAME]</username>
         <password>[PERSONAL_ACCESS_TOKEN]</password>
       </server>
     </servers>
   </settings>
   

5. Hozzon létre egy személyes hozzáférési jogkivonatot a Packaging>Read & írási hatóköreivel, és illessze be a személyes hozzáférési jogkivonatot a <password> settings.xml fájl címkéjébe.

Gradle

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

2. Válassza a Csatlakozás, majd a Gradle lehetőséget.

   

3. Adja hozzá a következő kódrészletet a build.gradle fájl adattáraihoz és közzétételi szakaszaihoz:

   maven {
       url 'https://pkgs.dev.azure.com/[ORGANIZATION-NAME]/_packaging/[FEED-NAME]/maven/v1'
       name '[FEED-NAME]'
       authentication {
           basic(BasicAuthentication)
       }
   }
   

4. Vegyen fel egy fájlt <server> a settings.xml fájlba:

   <settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0
                                 https://maven.apache.org/xsd/settings-1.0.0.xsd">
     <servers>
       <server>
         <id>[FEED-NAME]</id>
         <username>[ORGANIZATION-NAME]</username>
         <password>[PERSONAL_ACCESS_TOKEN]</password>
       </server>
     </servers>
   </settings>
   

5. Hozzon létre egy személyes hozzáférési jogkivonatot a Packaging>Read& írási hatóköreivel. Illessze be a személyes hozzáférési jogkivonatot a <password> settings.xml fájl címkéjébe.

Csomagok visszaállítása

Most, hogy engedélyezte a felsőbb rétegbeli forrásokat, és beállította a konfigurációs fájlt, futtathatjuk a csomag-visszaállítási parancsot a felsőbb rétegbeli forrás lekérdezéséhez és a felsőbb rétegbeli csomagok lekéréséhez.

npm

Távolítsa el a node_modules mappát a projektből, és futtassa a következő parancsot egy emelt szintű parancssori ablakban:

npm install --force

Feljegyzés

Az --force argumentum akkor is kényszeríti a lekéréses távoli elemet, ha létezik helyi példány.

A hírcsatornának most már rendelkeznie kell a felsőbb rétegből telepített csomagok mentett másolatával.

NuGet

1. A helyi gyorsítótár törlése:

   nuget locals -clear all
   

2. A NuGet-csomagok visszaállítása:

   nuget.exe restore
   

A hírcsatornának most már rendelkeznie kell a felsőbb rétegből telepített csomagok mentett másolatával.

Pip

Futtassa ezt a parancsot a projektkönyvtárban:

pip install

A hírcsatornának most már rendelkeznie kell a felsőbb rétegből telepített csomagok mentett másolatával.

Maven

Futtassa ezt a parancsot a projektkönyvtárban:

mvn install

A hírcsatornának most már rendelkeznie kell a felsőbb rétegből telepített csomagok mentett másolatával.

Gradle

Futtassa ezt a parancsot a projektkönyvtárban:

gradle build

A hírcsatornának most már rendelkeznie kell a felsőbb rétegből telepített csomagok mentett másolatával.

Kapcsolódó cikkek

• Felsőbb rétegbeli források beállítása
• Univerzális csomagok felsőbb rétegbeli források
• Hírcsatorna-engedélyek
• Csomagok közzététele NuGet.org