Připojení projektu npm do informačních kanálů Azure Artifacts

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

Azure Artifacts umožňuje vývojářům publikovat a instalovat různé typy balíčků z informačních kanálů a veřejných registrů, jako je npmjs.com. Pokud se chcete ověřit pomocí Azure Artifacts, je potřeba nakonfigurovat konfigurační soubor npm. Tento soubor obsahuje adresy URL informačního kanálu a přihlašovací údaje používané npm a nabízí možnosti přizpůsobení chování klienta npm, jako je nastavení proxy serverů, definování výchozích umístění balíčků nebo konfigurace kanálů privátních balíčků. Soubor .npmrc se obvykle nachází v domovském adresáři uživatele, ale lze ho vytvořit také na úrovni projektu a přepsat výchozí nastavení. Úpravou souboru .npmrc můžou uživatelé přizpůsobit své prostředí npm tak, aby vyhovovalo jejich konkrétním požadavkům.

Požadavky

• Organizace Azure DevOps a projekt Pokud jste to ještě neudělali, vytvořte organizaci nebo projekt.

• Informační kanál Azure Artifacts Pokud ho ještě nemáte, vytvořte nový informační kanál .

• Stáhněte a nainstalujte Node.js a npm.

Nastavení projektu

Pro osvědčené postupy se doporučuje použít dva samostatné konfigurační soubory. První se používá k ověřování pomocí Azure Artifacts, zatímco druhý se ukládá místně a uchovává vaše přihlašovací údaje.

Pokud chcete nastavit druhý soubor, jednoduše ho umístěte do domovského adresáře na vývojovém počítači a zahrňte všechny přihlašovací údaje registru. Klient npm tak může snadno přistupovat k vašim přihlašovacím údajům pro ověřování, což vám umožní sdílet konfigurační soubor při zachování zabezpečení přihlašovacích údajů.

Následující kroky vás provedou nastavením prvního konfiguračního souboru:

Windows

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 .

4. Pokud používáte Azure Artifacts s npm poprvé, vyberte Získat nástroje a podle pokynů nainstalujte požadované součásti.

5. Postupujte podle pokynů v nastavení Projectu a připojte se k informačnímu kanálu.

   

Další

1. Do adresáře projektu přidejte soubor .npmrc ve stejném adresáři jako soubor package.json a zkopírujte do něj následující fragment kódu.

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

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

1. Do souboru npmrc na úrovni uživatele zkopírujte následující fragment kódu:

   • 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
     

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

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

   1. V okně příkazového řádku spusťte následující příkaz a po zobrazení výzvy vložte váš osobní přístupový token:

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

      K převodu osobního přístupového tokenu na Base 64 můžete použít také následující příkaz.

      • Linux/Mac:

        echo -n "YOUR_PERSONAL_ACCESS-TOKEN" | base64
        

   2. Zkopírujte zakódovanou hodnotu Base 64.

4. Nahraďte obě hodnoty [BASE64_ENCODED_PERSONAL_ACCESS_TOKEN] v souboru .npmrc uživatele vaším osobním přístupovým tokenem z kroku 3.

Tip

Použití více registrů v souborech .npmrc je podporováno s obory a upstreamovými zdroji.

Ověřování kanálu

K ověření pomocí kanálu azure Artifacts doporučuje použít úlohu ověření npm.

Při použití spouštěčů úloh, jako je gulp nebo Grunt, je důležité, abyste na začátku kanálu zahrnuli úlohu ověření npm. Tato akce zajistí, že se vaše přihlašovací údaje vloží do souboru .npmrc vašeho projektu a zachovají se během spuštění kanálu a umožní následným krokům získat přístup k přihlašovacím údajům v konfiguračním souboru.

Klasické

1. Přejděte do projektu, vyberte Kanály a pak vyberte definici kanálu.

2. Vyberte Upravit a upravte kanál.

3. Vyberte + , pokud chcete do kanálu přidat novou úlohu.

   

4. Vyhledejte úlohu npm Authenticate a pak vyberte Přidat.

   

5. Vyberte soubor .npmrc a po dokončení vyberte Uložit a frontu.

   

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

Poznámka:

Aby váš kanál přistupoval k vašemu kanálu, ujistěte se, že je role služby buildu v nastavení informačního kanálu nastavená na kanál a čtenář upstreamu (přispěvatel ).

Poznámka:

Pokud vaše organizace používá bránu firewall nebo proxy server, ujistěte se, že povolíte příslušné adresy URL domény. Podrobnosti najdete v tématu Povolené IP adresy a adresy URL domény.

Odstraňování potíží

Vsts-npm-auth se nerozpozná

Pokud během provádění projektu dojde k následující chybě:

• Cmd: 'vsts-npm-auth' is not recognized as an internal or external command, operable program or batch file.

• PowerShell: vsts-npm-auth : The term 'vsts-npm-auth' is not recognized as the name of a cmdlet, function, script file, or operable program.

Pak je pravděpodobné, že složka modulů npm nebyla přidána do vaší cesty. Pokud chcete tento postup vyřešit, spusťte znovu nastavení Node.js a nezapomeňte vybrat Add to PATH možnost.

Případně můžete do cesty přidat složku modulů npm úpravou proměnné PATH na %APPDATA%\npm příkazový řádek nebo $env:APPDATA\npm v PowerShellu.

Nejde ověřit

Pokud narazíte na chybu E401: code E401 npm ERR! Unable to authenticate. Spuštěním vsts-npm-auth příkazu s příznakem -F znovu proveďte ověření.

vsts-npm-auth -config .npmrc -F

Resetování ověřování vsts-npm-auth

Při resetování přihlašovacích údajů vsts-npm-auth postupujte takto:

1. Odinstalujte vsts-npm-auth:

   npm uninstall -g vsts-npm-auth
   

2. Vymažte mezipaměť npm:

   npm cache clean --force
   

3. Odstraňte soubor .npmrc .

4. Přeinstalujte vsts-npm-auth:

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

Související články

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