Kommentar
Åtkomst till den här sidan kräver auktorisering. Du kan prova att logga in eller ändra kataloger.
Åtkomst till den här sidan kräver auktorisering. Du kan prova att ändra kataloger.
Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022
Azure Artifacts gör det möjligt för utvecklare att publicera och ladda ned npm-paket från feeds eller offentliga register.
Den här artikeln vägleder dig genom att skapa ett flöde, konfigurera projektet och publicera och ladda ned npm-paket.
Förutsättningar
- En Azure DevOps organisation.
- Ett Azure DevOps projekt.
- Ladda ned och installera Node.js och npm.
Skapa en feed
Logga in på din Azure DevOps-organisation och gå till projektet.
Välj Artefakter, och välj sedan Skapa feed.
Ange ett namn för feeden.
Välj en synlighetsinställning för att styra vem som kan visa paket i flödet.
Välj Inkludera paket från vanliga offentliga källor om du vill att feeden ska använda överordnade paket från källor som nuget.org eller npmjs.com.
För Omfång väljer du om flödet är begränsat till det aktuella projektet eller hela organisationen.
Välj Skapa när du är klar.
Logga in på Azure DevOps-servern och gå sedan till projektet.
Välj Artefakter, och välj sedan Skapa feed.
Ange ett namn för feeden.
Välj en synlighetsinställning för att styra vem som kan visa paket i flödet.
Välj Inkludera paket från vanliga offentliga källor om du vill att feeden ska använda överordnade paket från källor som nuget.org eller npmjs.com.
För Omfång väljer du om flödet är begränsat till det aktuella projektet eller hela organisationen.
Välj Skapa när du är klar.
Anteckning
När du skapar ett feed tilldelas projektets Build Service-konto, till exempel projectName Build Service (orgName), som standard rollen Feed and Upstream Reader (Collaborator).
Konfigurera npm-autentisering
Innan du ansluter till en feed konfigurerar du autentisering för npm-klienten på datorn. Stegen varierar beroende på ditt operativsystem:
Windows
Installera vsts-npm-auth, som genererar och uppdaterar de autentiseringsuppgifter som npm använder för att ansluta till din Azure Artifacts feed.
npm install -g vsts-npm-auth --registry https://registry.npmjs.com
macOS och Linux
vsts-npm-auth stöds inte på macOS eller Linux. Skapa i stället en personlig åtkomsttoken (PAT) med omfånget Packaging>Läs och skriv. Använd den PAT:en när du konfigurerar din .npmrc-fil på användarnivå i nästa avsnitt.
Ansluta till ett flöde
Azure Artifacts rekommenderar att du använder två separata konfigurationsfiler. Den första bör förvaras lokalt i $HOME-katalogen (Linux/macOS) eller $env. HOME (Windows) för att lagra dina autentiseringsuppgifter på ett säkert sätt. På så sätt kan npm-klienten komma åt dina autentiseringsuppgifter för autentisering.
Genom att använda den här konfigurationen kan du dela projektkonfigurationen med ditt team utan att exponera autentiseringsuppgifter i källkontrollen. Mer information finns i Ansluta till en Azure Artifacts feed – npm.
Logga in på din Azure DevOps-organisation och navigera sedan till projektet.
Välj Artifacts, välj din feed i rullgardinsmenyn och välj sedan Anslut till feed.
Välj npm i det vänstra navigeringsfönstret.
Under Project installation väljer du Windows eller Annan för operativsystemet och följer sedan de angivna anvisningarna för att uppdatera dina npmrc-filer på användarnivå och project nivå.
Anteckning
vsts-npm-auth Stöds inte i Azure DevOps Server.
Logga in på din Azure DevOps-samling och navigera sedan till projektet.
Välj Artifacts, välj din feed i rullgardinsmenyn och välj sedan Anslut till feed.
Välj npm i det vänstra navigeringsfönstret.
Under Project installation väljer du Windows eller Annan för operativsystemet och följer sedan de angivna anvisningarna för att uppdatera dina npmrc-filer på användarnivå och project nivå.
Viktigt!
npm stöder endast en enda registry inställning i .npmrc-filen . Om du behöver paket från flera källor använder du överordnade källor eller omfång i stället för att lägga till flera registry poster.
Publicera paket i feeden
Anteckning
Om du vill publicera paket till en feed måste du vara Feed Publisher (Bidragsgivare) eller högre. Mer information finns i Hantera behörigheter .
Innan du publicerar paket måste du autentisera med feeden. Om du inte har gjort det ännu följer du stegen i avsnittet Anslut till en feed och fortsätter sedan med anvisningarna i följande avsnitt.
I projektkatalogen kör du följande kommando för att publicera paketet som definieras i filen
package.jsontill ditt flöde:npm publish
Viktigt!
publishConfig Det går inte att använda egenskapen för att åsidosätta registerkonfigurationen vid publiceringstillfället.
Återställ paket från din feed
Innan du återställer paket måste du autentisera med feeden och uppdatera .npmrc-filerna för projektet. Om du inte har gjort det ännu slutför du stegen i Anslut till en feed och fortsätter sedan.
I projektkatalogen kör du följande kommando för att återställa alla paket som anges i
package.jsonfilen:npm installKör följande kommando för att installera ett specifikt paket från feeden och lägga till det som ett beroende i
package.jsonfilen:npm install --save <PACKAGE_NAME>