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


NPM-csomagok közzététele és letöltése az Azure Artifacts használatával

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

Az Azure Artifacts használatával npm-csomagokat tehet közzé és tölthet le a saját hírcsatornáiból és nyilvános nyilvántartásaiból, például npmjs.com. Ez a rövid útmutató végigvezeti a hírcsatorna létrehozásán, a projekt konfigurálásán és az npm-csomagok Azure Artifacts használatával történő kezelésén.

Előfeltételek

termék Követelmények
Azure DevOps - Egy Azure DevOps szervezet.
- Azure DevOps-projekt.
- Töltse le és telepítse Node.js és npm.

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

  3. Adjon meg egy név a hírcsatornához, válassza a Láthatóság lehetőséget, amely meghatározza, hogy ki tekintheti meg a csomagokat, ellenőrizze A közös nyilvános forrásokból származó csomagok belefoglalása, ha olyan forrásokból származó csomagokat szeretne felvenni, mint a nuget.org vagy a npmjs.com, és Hatóköresetében döntse el, hogy a hírcsatorna hatóköre a projektre vagy az egész szervezetre kiterjed-e.

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

    Képernyőkép, amely az új hírcsatorna létrehozásához szükséges kiválasztásokat mutatja az Azure DevOps Servicesben.

  1. Jelentkezzen be az Azure DevOps-kiszolgálóra, majd lépjen a projektjéhez.

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

  3. Adjon meg egy név a hírcsatornához, válassza a Láthatóság lehetőséget, amely meghatározza, hogy ki tekintheti meg a csomagokat, ellenőrizze A közös nyilvános forrásokból származó csomagok belefoglalása, ha olyan forrásokból származó csomagokat szeretne felvenni, mint a nuget.org vagy a npmjs.com, és Hatóköresetében döntse el, hogy a hírcsatorna hatóköre a projektre vagy az egész szervezetre kiterjed-e.

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

    Képernyőkép, amely a 2022-es Azure DevOps-ban egy új hírcsatorna létrehozásához rendelkezésre álló kiválasztásokat mutatja.

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

    Képernyőkép, amely a kiválasztásokat mutatja új hírcsatornák Azure DevOps 2020-ban történő létrehozásához.

Megjegyzés

Alapértelmezés szerint a projekt Build Szolgáltatása(például: projectName Build Service (orgName)) új hírcsatorna létrehozásakor a Feed és Felülolvasó (Közreműködő) szerepkörhöz van hozzárendelve.

Csatlakozás hírcsatornához

Az Azure Artifacts két külön konfigurációs fájl használatát javasolja. Az elsőt helyben kell tárolni a $HOME könyvtárban (Linux/macOS) vagy $env. HOME (Windows) a hitelesítő adatok biztonságos tárolásához. Ez lehetővé teszi az npm kliens számára, hogy hozzáférjen a hitelesítő adataihoz az azonosításhoz.

Ebben a szakaszban konfigurálja a második npmrc-fájlt , amelyet ugyanabban a könyvtárban kell elhelyeznie, mint a package.json fájl.

Ez a beállítás lehetővé teszi a konfigurációs fájl megosztását a hitelesítő adatok felfedése nélkül.

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

  2. Válassza Artefaktumok, válassza ki a(z) hírcsatornát a legördülő menüből, majd válassza a Csatlakozás a hírcsatornához.

  3. A bal oldali navigációs panelen válassza az npm lehetőséget. Ha először használja az Azure Artifactst az npm használatával, győződjön meg arról, hogy telepítette az előfeltételeket.

  4. A Project beállítási szakaszában válassza a Windows vagy az Egyéb lehetőséget az operációs rendszertől függően, majd kövesse a megadott utasításokat a konfigurációs fájl konfigurálásához és az Azure Artifacts-hírcsatornához való csatlakozáshoz.

    Képernyőkép egy npm-projekt beállításáról és a hírcsatornához való csatlakozásról az Azure DevOps Servicesben.

Megjegyzés

Az vsts-npm-auth Azure DevOps Server nem támogatja.

  1. Jelentkezzen be az Azure DevOps-gyűjteménybe, és lépjen a projekthez.

  2. Válassza Artefaktumok, válassza ki a(z) hírcsatornát a legördülő menüből, majd válassza a Csatlakozás a hírcsatornához.

  3. A bal oldali navigációs panelen válassza az npm lehetőséget. Ha először használja az Azure Artifactst az npm használatával, győződjön meg arról, hogy telepítette az előfeltételeket.

  4. A Project beállítási szakaszában válassza a Windows vagy az Egyéb lehetőséget az operációs rendszertől függően, majd kövesse a megadott utasításokat a konfigurációs fájl konfigurálásához és az Azure Artifacts-hírcsatornához való csatlakozáshoz.

    Képernyőkép egy npm-projekt beállításáról és az Azure Artifacts-hírcsatornához való csatlakozásról az Azure DevOps Server 2022-ben.

Megjegyzés

Az vsts-npm-auth Azure DevOps Server nem támogatja.

  1. Jelentkezzen be az Azure DevOps-gyűjteménybe, és lépjen a projekthez.

  2. Válassza Artefaktumok, válassza ki a(z) hírcsatornát a legördülő menüből, majd válassza a Csatlakozás a hírcsatornához.

  3. A bal oldali navigációs panelen válassza az npm lehetőséget. Ha először használja az Azure Artifactst az npm használatával, győződjön meg arról, hogy telepítette az előfeltételeket.

  4. A Project beállítási szakaszában válassza a Windows vagy az Egyéb lehetőséget az operációs rendszertől függően, majd kövesse a megadott utasításokat a konfigurációs fájl konfigurálásához és az Azure Artifacts-hírcsatornához való csatlakozáshoz.

    Képernyőkép egy npm-projekt beállításáról és az Azure Artifacts-hírcsatornához való csatlakozásról az Azure DevOps Server 2020-ban.

Fontos

Az Npm csak egyetlen registry beállítást támogat az npmrc-fájlban . Több adatbázis használatához felsőbb rétegbeli forrásokat vagy hatóköröket kell használnia.

Csomagok közzététele a hírcsatornában

A közzétételi parancs sikeres futtatásához először hitelesítenie kell magát a hírcsatornáddal. Ha még nem tette meg, kövesse a Csatlakozás egy hírcsatornához szakasz lépéseit , majd folytassa az alábbi utasításokat.

  • A projektkönyvtárban futtassa a következő parancsot a package.jsondefiniált npm-csomag közzétételéhez:

    npm publish
    

Fontos

A publishConfig tulajdonság használata a beállításjegyzék-konfiguráció közzétételkor történő felülbírálására nem támogatott.

Csomagok visszaállítása az adatfolyamból

A visszaállítási parancs sikeres futtatásához először hitelesítenie kell magát az adatfolyammal. Ha még nem tette meg, kövesse a Csatlakozás egy hírcsatornához szakasz lépéseit , majd folytassa az alábbi utasításokat.

  1. A projektkönyvtárban futtassa a következő parancsot az összes npm-csomag visszaállításához:

    npm install
    
  2. Egy adott npm-csomag visszaállításához futtassa a következő parancsot a projektkönyvtárból:

    npm install --save <PACKAGE_NAME>