Az npm-projekt csatlakoztatása az Azure Artifactshez

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

Az Azure Artifacts lehetővé teszi a fejlesztők számára, hogy csomagjaikat különböző forrásokból kezeljék, beleértve a nyilvános adatbázisokat, például a npmjs.com és a privát hírcsatornákat is. Az Azure Artifacts használatával történő hitelesítéshez konfigurálnia kell az npm konfigurációs fájlját. Ez a fájl tartalmazza az npm által használt hírcsatorna URL-címeit és hitelesítő adatait, és olyan beállításokat kínál, amelyekkel testre szabhatja az npm-ügyfél viselkedését, például proxykat állíthat be, alapértelmezett csomaghelyeket definiálhat, vagy privát csomagcsatornákat konfigurálhat. Az .npmrc fájl általában a felhasználó kezdőlapján található, de a projekt szintjén is létrehozható az alapértelmezett beállítások felülbírálásához.

Előfeltételek

• Egy Azure DevOps-szervezet. Hozzon létre egyet ingyen.

• Egy Azure DevOps-projekt. Hozzon létre egy új projektet, ha még nem rendelkezik ilyen projektel .

• Azure Artifacts-hírcsatorna. Hozzon létre egyet ingyen.

• Töltse le és telepítse a Node.js és az npm fájlt.

Csatlakozás a hírcsatornához

Az Azure Artifacts két külön konfigurációs fájl használatát javasolja. Az első az Azure Artifacts hitelesítésére van kiállítva, a másodikat pedig helyben kell tárolni a hitelesítő adatok tárolásához. Ez a módszer lehetővé teszi a konfigurációs fájl megosztását a hitelesítő adatok védelme mellett.

A második fájl beállításához egyszerűen helyezze a kezdőkönyvtárba a fejlesztőgépen, és adja meg az összes beállításjegyzékbeli hitelesítő adatait. Ez lehetővé teszi, hogy az npm-ügyfél könnyen hozzáférjen a hitelesítő adataihoz hitelesítés céljából.

Az alábbi lépések végigvezetik az első konfigurációs fájl beállításán:

Windows

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 Csatlakozás a hírcsatornához lehetőséget.

   

3. Válassza az npm lehetőséget a bal oldali oldalsávon. Ha először használja az Azure Artifactst npm-lel, győződjön meg arról, hogy telepítette az előfeltételeket.

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

   

Egyéb

1. Vegyen fel egy .npmrc fájlt a projekt könyvtárába, ugyanabban a könyvtárban, mint a package.json fájl, és illessze be a következő kódrészletet.

   registry=https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/npm/registry/ 
   
   always-auth=true
   

Hitelesítő adatok beállítása

1. Másolja ki a következő kódrészletet, és illessze be a felhasználói szintű npmrc-fájlba :

   • Szervezeti hatókörű hírcsatorna:

     ; begin auth token
     //pkgs.dev.azure.com/<ORGANIZATION_NAME>/_packaging/<FEED_NAME>/npm/registry/:username=[ENTER_ANY_VALUE_BUT_NOT_AN_EMPTY_STRING]
     //pkgs.dev.azure.com/<ORGANIZATION_NAME>/_packaging/<FEED_NAME>/npm/registry/:_password=[BASE64_ENCODED_PERSONAL_ACCESS_TOKEN]
     //pkgs.dev.azure.com/<ORGANIZATION_NAME>/_packaging/<FEED_NAME>/npm/registry/:email=npm requires email to be set but doesn't use the value
     //pkgs.dev.azure.com/<ORGANIZATION_NAME>/_packaging/<FEED_NAME>/npm/:username=[ANY_VALUE_BUT_NOT_AN_EMPTY_STRING]
     //pkgs.dev.azure.com/<ORGANIZATION_NAME>/_packaging/<FEED_NAME>/npm/:_password=[BASE64_ENCODED_PERSONAL_ACCESS_TOKEN]
     //pkgs.dev.azure.com/<ORGANIZATION_NAME>/_packaging/<FEED_NAME>/npm/:email=npm requires email to be set but doesn't use the value
     ; end auth token
     

   • Projekt hatókörű hírcsatorna:

     ; begin auth token
     //pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/npm/registry/:username=[ENTER_ANY_VALUE_BUT_NOT_AN_EMPTY_STRING]
     //pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/npm/registry/:_password=[BASE64_ENCODED_PERSONAL_ACCESS_TOKEN]
     //pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/npm/registry/:email=npm requires email to be set but doesn't use the value
     //pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/npm/:username=[ENTER_ANY_VALUE_BUT_NOT_AN_EMPTY_STRING]
     //pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/npm/:_password=[BASE64_ENCODED_PERSONAL_ACCESS_TOKEN]
     //pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/npm/:email=npm requires email to be set but doesn't use the value
     ; end auth token
     

2. Személyes hozzáférési jogkivonat létrehozása olvasási és írási hatókörök csomagolásával.

3. Futtassa a következő parancsot egy parancssori ablakban, majd illessze be a személyes hozzáférési jogkivonatot, amikor a rendszer kéri. Miután elkészült, másolja ki a létrehozott Base 64 kódolt értéket.

   node -e "require('readline') .createInterface({input:process.stdin,output:process.stdout,historySize:0}) .question('PAT> ',p => { b64=Buffer.from(p.trim()).toString('base64');console.log(b64);process.exit(); })"
   

4. Ha Linuxon/Macen dolgozik, az alábbi paranccsal konvertálhatja személyes hozzáférési jogkivonatát Base 64-re. Másolja ki az eredményként kapott Base64 kódolt értéket.

   echo -n "YOUR_PERSONAL_ACCESS-TOKEN" | base64
   

5. Cserélje le a felhasználói .npmrc fájlban található helyőrzőket [BASE64_ENCODED_PERSONAL_ACCESS_TOKEN] az előző lépésben beszerzett kódolt személyes hozzáférési jogkivonatra.

Tipp.

Az .npmrc-fájlokban több adatbázis használata is támogatott hatókörökkel és felsőbb rétegbeli forrásokkal.

Folyamathitelesítés

A folyamattal való hitelesítéshez az Azure Artifacts az npm hitelesítési feladat használatát javasolja.

Ha olyan feladatfuttatókat használ, mint a gulp vagy a Grunt, az npm-hitelesítés feladatának beállítását kell rangsorolni a folyamat elején. Ez a lépés garantálja, hogy a hitelesítő adatok a projekt .npmrc fájljába lesznek injektálva, és a folyamatfuttatás során megmaradnak, így a konfigurációs fájlban lévő hitelesítő adatokhoz további lépések is hozzáférhetnek.

Klasszikus

1. Lépjen a projekthez, válassza a Folyamatok lehetőséget, majd válassza ki a folyamatdefiníciót.

2. A folyamat módosításához válassza a Szerkesztés lehetőséget.

3. Válassza ki + , ha új feladatot szeretne hozzáadni a folyamathoz.

   

4. Keresse meg az npm-hitelesítési feladatot, majd válassza a Hozzáadás lehetőséget.

   

5. Válassza ki az .npmrc fájlt, majd amikor végzett, válassza a Mentés > üzenetsor lehetőséget.

   

YAML

- task: npmAuthenticate@0
  inputs:
    workingFile: .npmrc                ## Path to the npmrc file
    customEndpoint: #Optional          ## Comma-separated list of npm service connection names for registries from external organizations. For registries in your org, leave this blank

Feljegyzés

Ha a folyamatból szeretné elérni a hírcsatornát, győződjön meg arról, hogy a buildszolgáltatás szerepköre be van állítva a Hírcsatorna beállításainak>engedélyeiben a Hírcsatorna és a Felsőbb réteg olvasója (Közreműködő) értékre.

Feljegyzés

Ha a szervezet tűzfalat vagy proxykiszolgálót használ, győződjön meg arról, hogy engedélyezi a megfelelő tartományi URL-címeket. Részletekért lásd: Engedélyezett IP-címek és tartomány URL-címek .

Hibaelhárítás

a vsts-npm-auth nem ismerhető fel

Ez a hiba azt jelzi, hogy az npm-modulok mappája nem lett hozzáadva az elérési úthoz. Futtassa újra a Node.js beállítást, és győződjön meg arról, hogy a beállítást választja Add to PATH . Másik lehetőségként hozzáadhatja az npm-modulok mappát az elérési úthoz úgy, hogy %APPDATA%\npm a PATH változót a parancssorban vagy $env:APPDATA\npm a PowerShellben módosítja.

Nem lehet hitelesíteni

• Hiba: kód: E401 npm ERR! Nem lehet hitelesíteni: –> Futtassa a parancsot -vsts-npm-authF jelölővel az újrahitelesítéshez:

  vsts-npm-auth -config .npmrc -F
  

A vsts-npm-auth alaphelyzetbe állítása

A vsts-npm-auth hitelesítő adatainak alaphelyzetbe állításához kövesse az alábbi lépéseket:

1. Távolítsa el a vsts-npm-auth parancsot:

   npm uninstall -g vsts-npm-auth
   

2. Törölje az npm-gyorsítótárat:

   npm cache clean --force
   

3. Törölje az .npmrc fájlt.

4. A vsts-npm-auth újratelepítése:

   npm install -g vsts-npm-auth --registry https://registry.npmjs.com --always-auth false
   

Nem lehet közzétenni

Ha 403-at tapasztal, az névütközést jelezhet. Az Azure Artifactsben a csomagok nem módosíthatók, ami azt jelenti, hogy miután közzétett egy csomagot a hírcsatornában, annak verziószáma véglegesen fenntartott lesz. Még ha törli is, nem tehet közzé új csomagot ugyanazzal a verziószámmal. A probléma megoldásához frissítse a csomag verzióját a package.json fájlban, majd próbálkozzon újra.

Kapcsolódó cikkek

• NPM-csomagok közzététele és visszaállítása (CLI)
• NPM-csomagok közzététele (YAML/Klasszikus)
• Csomagok használata npmjs.com