Dela via


Npm@1 – npm v1-uppgift

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.

Anteckning

Uppgiften npm Authenticate (Autentisera) ä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 && command = install || command = ci || command = publish. 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 customRegistry = useFeed && command = install || command = ci || command = custom. Use packages from this Azure Artifacts/TFS registry. 
    #customEndpoint: # string. Optional. Use when customRegistry = useNpmrc && command = install || command = ci || command = custom. 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.
# 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' # '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 = publish. Verbose logging. 
    #publishPackageMetadata: true # boolean. Optional. Use when command = publish && publishRegistry = useFeed && command = install || command = publish. Publish pipeline metadata. Default: true.
  # Custom registries and authentication
    #customRegistry: 'useNpmrc' # 'useNpmrc' | 'useFeed'. Optional. Use when command = install || command = custom. Registries to use. Default: useNpmrc.
    #customFeed: # string. Required when customRegistry = useFeed && command = install || command = custom. Use packages from this Azure Artifacts/TFS registry. 
    #customEndpoint: # string. Optional. Use when customRegistry = useNpmrc && command = install || command = custom. 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.
# npm v1
# Install and publish npm packages, or run an npm command. Supports npmjs.com and authenticated registries like Package Management.
- task: Npm@1
  inputs:
    command: 'install' # 'install' | 'publish' | 'custom'. Required. Command. Default: install.
    #workingDir: # string. Working folder with package.json. 
    #customCommand: # string. Required when command = custom. Command and arguments. 
  # Advanced
    #verbose: # boolean. Optional. Use when command = install || command = publish. Verbose logging. 
  # Custom registries and authentication
    #customRegistry: 'useNpmrc' # 'useNpmrc' | 'useFeed'. Optional. Use when command = install || command = custom. Registries to use. Default: useNpmrc.
    #customFeed: # string. Required when customRegistry = useFeed && command = install || command = custom. Use packages from this Azure Artifacts/TFS registry. 
    #customEndpoint: # string. Optional. Use when customRegistry = useNpmrc && command = install || command = custom. Credentials for registries outside this account/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.

Indata

command - Kommandot
string. Krävs. 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 (") undsläpar du dem med ett snedstreck (\) och omger den undantagna strängen med dubbla citattecken (").


command - Kommandot
string. Krävs. Tillåtna värden: install, publish, custom. Standardvärde: install.

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

Om argumenten innehåller dubbla citattecken (") undsläpar du dem med ett snedstreck (\) och omger den undantagna strängen med dubbla citattecken (").


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

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


workingDir - Arbetsmapp med package.json
string.

Anger sökvägen till mappen som innehåller målet package.json och .npmrc filerna. 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.


verbose - Utförlig loggning
boolean. Valfritt. Använd när command = install || 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 - Register som ska användas
string. Valfritt. Använd när command = install || command = ci || command = custom. Tillåtna värden: useNpmrc (Register i min .npmrc), useFeed (Register jag väljer här). Standardvärde: useNpmrc.

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


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

Anger vilka register som ska användas. Checka in en .npmrc fil på din källkodslagringsplats 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 customRegistry = useFeed && command = install || command = ci || command = custom.

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


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

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


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

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 byggets autentiseringsuppgifter automatiskt.


customEndpoint - Autentiseringsuppgifter för register utanför den här organisationen/samlingen
string. Valfritt. Använd när customRegistry = useNpmrc && command = install || command = custom.

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 byggets autentiseringsuppgifter automatiskt.


customEndpoint - Autentiseringsuppgifter för register utanför det här kontot/samlingen
string. Valfritt. Använd när customRegistry = useNpmrc && command = install || command = custom.

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 byggets autentiseringsuppgifter 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 jag väljer här). Standardvärde: useExternalRegistry.

Anger det register som kommandot ska riktas mot.


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 välja ett register här.


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

Associerar bygg-/versionspipelinens metadata (run # och källkodsinformation) med paketet.


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

Associerar bygg-/versionspipelinens metadata (körnings- och källkodsinformationen) 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

Inga.

Kommentarer

Anteckning

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

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

Exempel

Krav

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