Npm@1 - npm v1-taak

Artikel
03/24/2025

Gebruik deze taak om npm-pakketten te installeren en te publiceren of om een npm opdracht uit te voeren. Ondersteunt npmjs.com en geverifieerde registers zoals Azure Artifacts.

Notitie

De npm-verificatietaak is de aanbevolen manier om te verifiëren met Azure Artifacts. Deze taak neemt geen nieuwe functies meer in beslag en er worden alleen kritieke fouten opgelost.

Syntaxis

# 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.

Invoer

command - opdracht
string. Verplicht. Toegestane waarden: ci, install, publish, . custom Standaardwaarde: install.

Hiermee geeft u de opdracht en argumenten, die worden doorgegeven aan npm voor uitvoering.

Als uw argumenten dubbele aanhalingstekens (") bevatten, escapet u deze met een slash (\) en plaatst u de escape-tekenreeks tussen dubbele aanhalingstekens (").

Pakketten worden standaard lokaal geïnstalleerd. Als u pakketten globaal wilt installeren, geeft u install -g op als de opdracht. Zie Pakketten wereldwijd downloaden en installeren en Pakketten lokaaldownloaden en installeren voor meer informatie.

workingDir - werkmap met package.json
string.

Hiermee geeft u het pad naar de map met de doel-package.json en .npmrc bestanden. Selecteer de map, niet het bestand. Voorbeeld: /packages/mypackage.

uitgebreide logboekregistratieverbose -
boolean. Facultatief. Gebruiken wanneer command = install || command = ci || command = publish.

Hiermee wordt meer informatie afgedrukt naar de console wanneer de taak wordt uitgevoerd.

customCommand - opdracht en argumenten
string. Vereist wanneer command = custom.

Voert een aangepaste opdracht uit. Voorbeeld: dist-tag ls mypackage.

customRegistry - registers voor het gebruik van
string. Facultatief. Gebruiken wanneer command = install || command = ci || command = custom. Toegestane waarden: useNpmrc (registers in mijn .npmrc), useFeed (register dat ik hier selecteer). Standaardwaarde: useNpmrc.

Hiermee geeft u de te gebruiken registers. Voer een .npmrc-bestand door naar uw broncodeopslagplaats en stel het pad in als de waarde of geef een register van Azure Artifacts op als de waarde.

customFeed - pakketten uit dit Azure Artifacts-/TFS-register gebruiken
string. Vereist wanneer (command = install || command = ci || command = custom) && customRegistry = useFeed.

Bevat de geselecteerde feed in de gegenereerde .npmrc. Gebruik ProjectName/FeedName of ProjectID/FeedIDvoor feeds met projectbereik. Voor feeds binnen het bereik van de organisatie moet de waarde de naam van de feed zijn.

customEndpoint - referenties voor registers buiten deze organisatie/verzameling
string. Facultatief. Gebruiken wanneer (command = install || command = ci || command = custom) && customRegistry = useNpmrc.

Referenties die moeten worden gebruikt voor externe registers in de .npmrcvan het project. Laat dit leeg voor registers in dit account/verzameling; de taak maakt automatisch gebruik van de referenties van de build.

publishRegistry - registerlocatie
string. Facultatief. Gebruiken wanneer command = publish. Toegestane waarden: useExternalRegistry (extern npm-register (inclusief andere accounts/verzamelingen)), useFeed (Register dat ik hier selecteer). Standaardwaarde: useExternalRegistry.

Hiermee geeft u het register op waarop de opdracht wordt gericht.

publishFeed - doelregister
string. Vereist wanneer publishRegistry = useFeed && command = publish.

Hiermee geeft u een register dat wordt gehost in het account. U moet Pakketbeheer hebben geïnstalleerd en een licentie hebben om hier een register te selecteren.

publishPackageMetadata - metagegevens van pijplijn publiceren
boolean. Facultatief. Gebruiken wanneer command = publish && publishRegistry = useFeed. Standaardwaarde: true.

Koppelt de metagegevens van de build-/release-pijplijn (de uitvoerings- en broncodegegevens) aan het pakket.

publishEndpoint - extern register
string. Vereist wanneer publishRegistry = useExternalRegistry && command = publish.

Hiermee geeft u de referenties op die moeten worden gebruikt voor het publiceren naar een extern register.

Opties voor taakbeheer

Alle taken hebben besturingsopties naast hun taakinvoer. Zie Opties en algemene taakeigenschappenvoor meer informatie.

Uitvoervariabelen

Geen.

Opmerkingen

Notitie

De buildservice voor projectverzamelingen en de buildservice--identiteit van uw project moeten zijn ingesteld op inzender om uw pakketten te publiceren naar een feed met behulp van Azure Pipelines. Zie Nieuwe gebruikers/groepen toevoegen voor meer informatie.

Waar kan ik npm-opdrachten en -argumenten leren?

npm-documenten

Voorbeelden

Uw Node.js-app bouwen met gulp-

Vereisten

Voorwaarde	Beschrijving
Pijplijntypen	YAML, klassieke build, klassieke release
Wordt uitgevoerd op	Agent, DeploymentGroup
eisen	Zelf-hostende agents moeten mogelijkheden hebben die overeenkomen met de volgende eisen om taken uit te voeren die gebruikmaken van deze taak: npm:
mogelijkheden	Deze taak voldoet niet aan de vereisten voor volgende taken in de taak.
opdrachtbeperkingen	Welk dan ook
variabelen instellen	Welk dan ook
Agentversie	2.115.0 of hoger
Taakcategorie	Pakket

Delen via