Npm@1 - npm v1-taak

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 taak npm-verificatie 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.

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.

Invoerwaarden

command - Opdracht
string. Vereist. Toegestane waarden: ci, install, publish, custom. Standaardwaarde: install.

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

Als uw argumenten dubbele aanhalingstekens () bevatten," moet u deze met een schuine streep (\) laten ontsnappen en de tekenreeks met dubbele aanhalingstekens () plaatsen."

workingDir - Werkmap met package.json
string.

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

verbose - Uitgebreide logboekregistratie
boolean. Optioneel. Gebruik wanneer command = install || command = ci || command = publish.

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

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

Hiermee voert u een aangepaste opdracht uit. Bijvoorbeeld: dist-tag ls mypackage.

customRegistry - Te gebruiken registers
string. Optioneel. Gebruik 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 registers te gebruiken. 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 customRegistry = useFeed && command = install || command = ci || command = custom.

Bevat de geselecteerde feed in de gegenereerde .npmrc. Voor feeds met projectbereik gebruikt u ProjectName/FeedName of ProjectID/FeedID. Voor feeds binnen organisatiebereik moet de waarde de naam van de feed zijn.

customEndpoint - Referenties voor registers buiten deze organisatie/verzameling
string. Optioneel. Gebruik wanneer customRegistry = useNpmrc && command = install || command = ci || command = custom.

Referenties die moeten worden gebruikt voor externe registers die zich in de van .npmrchet project bevinden. Laat dit leeg voor registers in deze account/verzameling; de taak gebruikt automatisch de referenties van de build.

publishRegistry - Registerlocatie
string. Optioneel. Gebruik 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 waarop de opdracht wordt gericht.

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

Hiermee geeft u een register op 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. Optioneel. Gebruik wanneer command = publish && publishRegistry = useFeed && command = install || command = ci || command = publish. Standaardwaarde: true.

Koppelt de metagegevens van de build-/release-pijplijn (het runnummer en de broncode-informatie) 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 voor besturingselementen en algemene taakeigenschappen voor meer informatie.

Uitvoervariabelen

Geen.

Opmerkingen

Notitie

De Build-service projectverzameling en de buildservice-identiteit van uw project moeten worden 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 vind ik npm-opdrachten en -argumenten?

• npm-documenten

Voorbeelden

• Uw Node.js-app bouwen met gulp

Vereisten

Vereiste	Beschrijving
Pijplijntypen	YAML, klassieke build, klassieke release
Wordt uitgevoerd op	Agent, DeploymentGroup
Eisen	Zelf-hostende agents moeten mogelijkheden hebben die voldoen aan de volgende vereisten om taken uit te voeren die deze taak gebruiken: npm
Functies	Deze taak voldoet niet aan eventuele vereisten voor volgende taken in de taak.
Opdrachtbeperkingen	Alle
Instelbare variabelen	Alle
Agentversie	2.115.0 of hoger
Taakcategorie	Pakket