Npm@1 – npm v1-uppgift

Artikel
03/24/2025

Använd den här uppgiften för att installera och publicera npm-paket eller för att köra ett npm kommando. Stöder npmjs.com och autentiserade register som Azure Artifacts.

Anmärkning

Den npm Authenticate-uppgiften är det rekommenderade sättet att autentisera med Azure Artifacts. Den här uppgiften tar inte längre nya funktioner och endast kritiska buggar åtgärdas.

Syntax

# npm v1
# Install and publish npm packages, or run an npm command. Supports npmjs.com and authenticated registries like Azure Artifacts.
- task: Npm@1
  inputs:
    command: 'install' # 'ci' | 'install' | 'publish' | 'custom'. Required. Command. Default: install.
    #workingDir: # string. Working folder that contains package.json. 
    #customCommand: # string. Required when command = custom. Command and arguments. 
  # Advanced
    #verbose: # boolean. Optional. Use when command = install || command = ci || command = publish. Verbose logging. 
    #publishPackageMetadata: true # boolean. Optional. Use when command = publish && publishRegistry = useFeed. Publish pipeline metadata. Default: true.
  # Custom registries and authentication
    #customRegistry: 'useNpmrc' # 'useNpmrc' | 'useFeed'. Optional. Use when command = install || command = ci || command = custom. Registries to use. Default: useNpmrc.
    #customFeed: # string. Required when (command = install || command = ci || command = custom) && customRegistry = useFeed. Use packages from this Azure Artifacts/TFS registry. 
    #customEndpoint: # string. Optional. Use when (command = install || command = ci || command = custom) && customRegistry = useNpmrc. Credentials for registries outside this organization/collection. 
  # Destination registry and authentication
    #publishRegistry: 'useExternalRegistry' # 'useExternalRegistry' | 'useFeed'. Optional. Use when command = publish. Registry location. Default: useExternalRegistry.
    #publishFeed: # string. Required when publishRegistry = useFeed && command = publish. Target registry. 
    #publishEndpoint: # string. Required when publishRegistry = useExternalRegistry && command = publish. External Registry.

Ingångar

command - kommando
string. Obligatoriskt. Tillåtna värden: ci, install, publish, custom. Standardvärde: install.

Anger kommandot och argumenten som skickas till npm för körning.

Om argumenten innehåller dubbla citattecken ("), kan du undvika dem med ett snedstreck (\) och omge den undantagna strängen med dubbla citattecken (").

Som standard installeras paket lokalt. Om du vill installera paket globalt anger du install -g som kommando. Mer information finns i Ladda ned och installera paket globalt och Hämta och installera paket lokalt.

workingDir - Arbetsmapp som innehåller package.json
string.

Anger sökvägen till mappen som innehåller målfilerna package.json och .npmrc. Välj mappen, inte filen. Exempel: /packages/mypackage.

verbose - utförlig loggning
boolean. Valfritt. Använd när command = install || command = ci || command = publish.

Skriver ut mer information till konsolen när aktiviteten körs.

customCommand - kommando och argument
string. Krävs när command = custom.

Kör ett anpassat kommando. Exempel: dist-tag ls mypackage.

customRegistry - att använda
string. Valfritt. Använd när command = install || command = ci || command = custom. Tillåtna värden: useNpmrc (register i min .npmrc), useFeed (register väljer jag här). Standardvärde: useNpmrc.

Anger vilka register som ska användas. Checka in en .npmrc fil till källkodslagringsplatsen och ange dess sökväg som värde, eller ange ett register från Azure Artifacts som värde.

customFeed - Använda paket från det här Azure Artifacts/TFS-registret
string. Krävs när (command = install || command = ci || command = custom) && customRegistry = useFeed.

Innehåller den valda feeden i den genererade .npmrc. För feeds med projektomfattning använder du ProjectName/FeedName eller ProjectID/FeedID. För feeds med organisationsomfattning ska värdet vara feednamnet.

customEndpoint - autentiseringsuppgifter för register utanför organisationen/samlingen
string. Valfritt. Använd när (command = install || command = ci || command = custom) && customRegistry = useNpmrc.

Autentiseringsuppgifter som ska användas för externa register som finns i projektets .npmrc. Lämna detta tomt för register i det här kontot/samlingen. aktiviteten använder autentiseringsuppgifterna för bygget automatiskt.

publishRegistry - Registerplats
string. Valfritt. Använd när command = publish. Tillåtna värden: useExternalRegistry (externt npm-register (inklusive andra konton/samlingar)), useFeed (register väljer jag här). Standardvärde: useExternalRegistry.

Anger det register som kommandot ska rikta in sig på.

publishFeed - Målregister
string. Krävs när publishRegistry = useFeed && command = publish.

Anger ett register som finns i kontot. Du måste ha Pakethantering installerat och licensierat för att kunna välja ett register här.

publishPackageMetadata - Publicera pipelinemetadata
boolean. Valfritt. Använd när command = publish && publishRegistry = useFeed. Standardvärde: true.

Associerar bygg-/versionspipelinens metadata (körningsnummer och källkodsinformation) med paketet.

publishEndpoint - externt register
string. Krävs när publishRegistry = useExternalRegistry && command = publish.

Anger de autentiseringsuppgifter som ska användas för publicering till ett externt register.

Kontrollalternativ för aktivitet

Alla aktiviteter har kontrollalternativ utöver sina aktivitetsindata. Mer information finns i Kontrollalternativ och vanliga uppgiftsegenskaper.

Utdatavariabler

Ingen.

Anmärkningar

Anmärkning

Project Collection Build Service och projektets Build Service- identitet måste anges till Deltagare för att publicera dina paket i en feed med Hjälp av Azure Pipelines. Mer information finns i Lägg till nya användare/grupper.

Var kan jag lära mig npm-kommandon och argument?

npm-dokument

Exempel

Skapa din Node.js-app med gulp

Krav

Krav	Beskrivning
Pipelinetyper	YAML, klassisk version, klassisk version
Körs på	Agent, DeploymentGroup
kräver	Lokalt installerade agenter måste ha funktioner som matchar följande kräver att köra jobb som använder den här uppgiften: npm
funktioner	Den här aktiviteten uppfyller inte några krav på efterföljande uppgifter i jobbet.
Kommandobegränsningar	Vilken som helst
variabler som kan	Vilken som helst
Agentversion	2.115.0 eller senare
Aktivitetskategori	Paket

Dela via