Kom igång med npm-paket i Azure Artifacts

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

Med Hjälp av Azure Artifacts kan du publicera och ladda ned npm-paket från feeds och offentliga register som npmjs.com. Den här snabbstarten beskriver hur du skapar ditt flöde, konfigurerar projektet och publicerar och laddar ned npm-paket till och från Azure Artifacts-flödet.

Skapa en feed

En feed är en organisationskonstruktion som gör det möjligt för användare att lagra sina paket och styra vem som kan komma åt dem. Azure Artifacts stöder lagring av flera pakettyper i en enda feed, till exempel NuGet-, npm-, Maven-, Python-, Cargo- och Universal-paket.

1. Logga in på din Azure DevOps-organisation och navigera sedan till projektet.

2. Välj Artefakter och välj sedan Skapa feed för att skapa en ny feed.

3. Ange ett beskrivande namn för feeden och definiera dess synlighet (som anger vem som kan visa paket i feeden). Ange omfånget för feeden och markera kryssrutan Överordnade källor om du vill inkludera paket från offentliga källor.

4. Välj Skapa när du är klar.

   

Kommentar

Som standard har nyskapade feeds projektets Build Service inställt på Feed och Upstream Reader (Kollaboratör).

Konfigurera .npmrc-filerna

Kommentar

vsts-npm-auth stöds inte i Azure DevOps Server.

Vi rekommenderar att du använder två .npmrc-filer. Den första ska finnas i samma katalog som din package.json-fil. Den andra ska placeras i $home-katalogen (Linux/macOS) eller $env. HOME (Windows) för att lagra dina autentiseringsuppgifter på ett säkert sätt. NPM-klienten kan sedan söka efter den här filen och hämta dina autentiseringsuppgifter för autentisering. På så sätt kan du dela konfigurationsfilen samtidigt som du håller dina autentiseringsuppgifter säkra.

1. Logga in på din Azure DevOps-organisation och navigera sedan till projektet.

2. Välj Artefakter och välj sedan Anslut som ska matas.

3. Välj npm i det vänstra navigeringsfönstret. Om det här är första gången du använder Azure Artifacts med npm väljer du Hämta verktygen och följer stegen för att ladda ned Node.js och konfigurera datorn.

4. Infoga följande kodfragment i .npmrc-filen, det som finns i samma katalog som din package.json-fil. Ersätt platshållarna med lämpliga värden.

   • Flöde med organisationsomfattning:

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

   • Flöde med projektomfattning:

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

Konfigurera autentiseringsuppgifter

Viktigt!

npm stöder en enskild registry i .npmrc-filen. Flera register är möjliga med omfång och överordnade källor.

Windows

Om du utvecklar i Windows rekommenderar vi att du använder vsts-npm-auth för att autentisera med Azure Artifacts. Kontrollera att vsts-npm-auth har installerats från Hämta verktygen och kör sedan vsts-npm-auth för att få en Azure Artifacts-token tillagd i npmrc-filen på användarnivå:

vsts-npm-auth -config .npmrc

Övrigt

Om du utvecklar på en icke-Windows-plattform och behöver autentisera med Azure Artifacts måste du skapa en personlig åtkomsttoken, koda den i Base 64 och sedan lägga till den i npmrc-filen på användarnivå.

1. Generera en personlig åtkomsttoken med paketering av läs- och skrivomfattningar .

2. Koda din nyligen genererade personliga åtkomsttoken på följande sätt:

   1. Kör följande kommando i ett kommandotolkfönster för att koda din 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. Klistra in din personliga åtkomsttoken och tryck sedan på Retur.

   3. Kopiera den base 64-kodade personliga åtkomsttoken.

3. Kopiera följande kodfragment till .npmrc-filen på användarnivå och ersätt [BASE64_ENCODED_PERSONAL_ACCESS_TOKEN] platshållaren med din personliga åtkomsttoken för Base 64:

   • Flöde med organisationsomfattning:

     ; 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
     

   • Flöde med projektomfattning:

     ; 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
     

---

Publicera paket

Om du vill publicera npm-paketet kör du följande kommando i projektkatalogen:

npm publish

Viktigt!

publishConfig Det går inte att använda egenskapen för att åsidosätta registerkonfigurationsparam vid publiceringstid.

Återställa paket

Om du vill återställa ett npm-paket kör du följande kommando i projektkatalogen:

npm install --save <package>

Om du vill återställa alla npm-paket kör du följande kommando från projektkatalogen:

npm install

Relaterade artiklar

• Publicera npm-paket (YAML/klassisk)
• Använda paket från npmjs.com
• Använda npm-omfång