Dela via


Publicera och ladda ned npm-paket med Azure Artifacts

Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2020

Med Azure Artifacts kan du publicera och ladda ned npm-paket från både dina egna feeds och offentliga register, till exempel npmjs.com. Den här snabbstarten vägleder dig genom att skapa ett flöde, konfigurera projektet och hantera npm-paket med Hjälp av Azure Artifacts.

Förutsättningar

Produkt Krav
Azure DevOps – En organisation i Azure DevOps .
– Ett Azure DevOps-projekt.
- Ladda ned och installera Node.js och npm.

Skapa en feed

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

  2. Välj Artefakter, och välj sedan Skapa feed.

  3. Ange ett Namn för feeden, välj alternativet Synlighet som definierar vem som kan visa dina paket, kontrollera Ta med paket från vanliga offentliga källor om du vill inkludera paket från källor som nuget.org eller npmjs.comoch för Omfångavgör du om flödet ska begränsas till projektet eller hela organisationen.

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

    Skärmbild som visar val för att skapa en ny feed i Azure DevOps Services.

  1. Logga in på Azure DevOps-servern och gå sedan till projektet.

  2. Välj Artefakter, och välj sedan Skapa feed.

  3. Ange ett Namn för feeden, välj alternativet Synlighet som definierar vem som kan visa dina paket, kontrollera Ta med paket från vanliga offentliga källor om du vill inkludera paket från källor som nuget.org eller npmjs.comoch för Omfångavgör du om flödet ska begränsas till projektet eller hela organisationen.

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

    Skärmbild som visar val för att skapa en ny feed i Azure DevOps 2022.

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

    Skärmbild som visar val för att skapa en ny feed i Azure DevOps 2020.

Anteckning

Som standard tilldelas byggtjänsten för projektet (till exempel projectName Build Service (orgName)) rollen Feed och Upstream Reader (Kollaboratör) när en ny feed skapas.

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.

I det här avsnittet konfigurerar du den andra npmrc-filen , som ska placeras i samma katalog som din package.json-fil .

Med den här konfigurationen kan du dela konfigurationsfilen utan att exponera dina autentiseringsuppgifter.

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

  2. Välj Artifacts, välj din feed i rullgardinsmenyn och välj sedan Anslut till feed.

  3. I det vänstra navigeringsfönstret väljer du npm. Om det här är första gången du använder Azure Artifacts med npm kontrollerar du att du har installerat förhandskraven.

  4. Under avsnittet Projektkonfiguration väljer du Windows eller Annan beroende på ditt operativsystem och följer sedan de angivna anvisningarna för att konfigurera konfigurationsfilen och ansluta till Azure Artifacts-flödet.

    En skärmbild som visar hur du konfigurerar ett npm-projekt och ansluter till en feed i Azure DevOps Services.

Anteckning

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

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

  2. Välj Artifacts, välj din feed i rullgardinsmenyn och välj sedan Anslut till feed.

  3. I det vänstra navigeringsfönstret väljer du npm. Om det här är första gången du använder Azure Artifacts med npm kontrollerar du att du har installerat förhandskraven.

  4. Under avsnittet Projektkonfiguration väljer du Windows eller Annan beroende på ditt operativsystem och följer sedan de angivna anvisningarna för att konfigurera konfigurationsfilen och ansluta till Azure Artifacts-flödet.

    En skärmbild som visar hur du konfigurerar ett npm-projekt och ansluter till en Azure Artifacts-feed i Azure DevOps Server 2022.

Anteckning

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

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

  2. Välj Artifacts, välj din feed i rullgardinsmenyn och välj sedan Anslut till feed.

  3. I det vänstra navigeringsfönstret väljer du npm. Om det här är första gången du använder Azure Artifacts med npm kontrollerar du att du har installerat förhandskraven.

  4. Under avsnittet Projektkonfiguration väljer du Windows eller Annan beroende på ditt operativsystem och följer sedan de angivna anvisningarna för att konfigurera konfigurationsfilen och ansluta till Azure Artifacts-flödet.

    En skärmbild som visar hur du konfigurerar ett npm-projekt och ansluter till en Azure Artifacts-feed i Azure DevOps Server 2020.

Viktigt!

Npm stöder endast en enda registry inställning i npmrc-filen . Om du vill använda flera register måste du använda överordnade källor eller omfång.

Publicera paket i feeden

Om du vill köra publiceringskommandot måste du först 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 nedan.

  • I projektkatalogen kör du följande kommando för att publicera npm-paketet som definierats i dinpackage.json:

    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

Om du vill köra återställningskommandot måste du först 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 nedan.

  1. I projektkatalogen kör du följande kommando för att återställa alla npm-paket:

    npm install
    
  2. Om du vill återställa ett specifikt npm-paket kör du följande kommando från projektkatalogen:

    npm install --save <PACKAGE_NAME>