Začínáme s balíčky npm v Azure Artifacts

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

Pomocí Azure Artifacts můžete publikovat a stahovat balíčky npm z informačních kanálů a veřejných registrů, jako je npmjs.com. Tento rychlý start vás provede procesem vytváření informačního kanálu, konfigurací projektu a publikováním a stahováním balíčků npm do a z informačního kanálu Azure Artifacts.

Vytvoření informačního kanálu

Informační kanál je organizační konstrukce, která uživatelům umožňuje ukládat své balíčky a řídit, kdo k nim má přístup. Azure Artifacts podporuje ukládání několika typů balíčků do jednoho informačního kanálu, jako jsou NuGet, npm, Maven, Python, Cargo a Univerzální balíčky.

1. Přihlaste se ke své organizaci Azure DevOps a přejděte k projektu.

2. Vyberte Artifacts (Artefakty) a pak vyberte Create Feed (Vytvořit informační kanál ) a vytvořte nový informační kanál.

3. Zadejte popisný název informačního kanálu a definujte jeho viditelnost (označující, kdo může zobrazit balíčky v informačním kanálu). Zadejte obor informačního kanálu a pokud chcete zahrnout balíčky z veřejných zdrojů, zaškrtněte políčko Nadřazené zdroje.

4. Až budete hotovi, vyberte Vytvořit .

   

Poznámka:

Nově vytvořené informační kanály mají ve výchozím nastavení nastavenou službu buildu projektu na kanál a upstreamovou čtečku (spolupracovníci).

Nastavení souborů .npmrc

Poznámka:

vsts-npm-auth Azure DevOps Server nepodporuje.

Doporučujeme použít dva soubory .npmrc. První by se měl nacházet ve stejném adresáři jako soubor package.json. Druhá by měla být umístěna v adresáři $home (Linux/macOS) nebo $env. HOME (Windows) pro bezpečné ukládání přihlašovacích údajů. Klient npm pak bude moct vyhledat tento soubor a načíst přihlašovací údaje pro ověření. To vám umožní sdílet konfigurační soubor při zachování zabezpečení přihlašovacích údajů.

1. Přihlaste se ke své organizaci Azure DevOps a přejděte k projektu.

2. Vyberte Artifacts (Artefakty) a pak vyberte Připojení to feed (Informační kanál).

3. V levém navigačním podokně vyberte npm . Pokud používáte Azure Artifacts s npm poprvé, vyberte Získat nástroje a postupujte podle pokynů ke stažení Node.js a nastavení počítače.

4. Do souboru .npmrc vložte následující fragment kódu, který se nachází ve stejném adresáři jako váš soubor package.json. Zástupné symboly nahraďte příslušnými hodnotami.

   • Informační kanál s oborem organizace:

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

   • Informační kanál s oborem projektu:

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

Nastavení přihlašovacích údajů

Důležité

npm podporuje jeden registry soubor .npmrc. S rozsahy a upstreamovými zdroji je možné používat více registrů.

Windows

Pokud vyvíjíte ve Windows, doporučujeme k ověřování pomocí Azure Artifacts použít ověřování vsts-npm-auth . Ujistěte se, že máte nainstalované ověřování vsts-npm-auth z nástroje Get a pak spusťte vsts-npm-auth, abyste získali token Azure Artifacts přidaný do souboru npmrc na úrovni uživatele:

vsts-npm-auth -config .npmrc

Další

Pokud vyvíjíte na platformě mimo Windows a potřebujete provést ověření pomocí Azure Artifacts, musíte vytvořit osobní přístupový token, zakódovat ho v base 64 a pak ho přidat do souboru npmrc na úrovni uživatele.

1. Vygenerujte osobní přístupový token s rozsahy čtení a zápisu balení.

2. Kódujte nově vygenerovaný osobní přístupový token následujícím způsobem:

   1. Spuštěním následujícího příkazu v okně příkazového řádku kódujte pat:

      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(); })"
      

   2. Vložte svůj osobní přístupový token a stiskněte Enter.

   3. Zkopírujte osobní přístupový token s kódováním Base 64.

3. Zkopírujte následující fragment kódu do souboru .npmrc na úrovni uživatele a nahraďte [BASE64_ENCODED_PERSONAL_ACCESS_TOKEN] zástupný symbol osobním přístupovým tokenem Base 64:

   • Informační kanál s oborem organizace:

     ; 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
     

   • Informační kanál s oborem projektu:

     ; 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
     

---

Publikování balíčků

Pokud chcete publikovat balíček npm, spusťte v adresáři projektu následující příkaz:

npm publish

Důležité

publishConfig Použití vlastnosti k přepsání parametru konfigurace registru v době publikování není podporováno.

Obnovení balíčků

Pokud chcete obnovit balíček npm, spusťte v adresáři projektu následující příkaz:

npm install --save <package>

Pokud chcete obnovit všechny balíčky npm, spusťte z adresáře projektu následující příkaz:

npm install

Související články

• Publikování balíčků npm (YAML/Classic)
• Použití balíčků z npmjs.com
• Použití oborů npm