Npm@1 – npm v1-Aufgabe

Artikel
03/24/2025

Verwenden Sie diese Aufgabe, um npm-Pakete zu installieren und zu veröffentlichen oder einen npm Befehl auszuführen. Unterstützt npmjs.com und authentifizierte Registrierungen wie Azure Artifacts.

Hinweis

Die npm Authenticate-Aufgabe ist die empfohlene Methode zur Authentifizierung bei Azure Artifacts. Diese Aufgabe übernimmt keine neuen Features mehr, und nur kritische Fehler werden behoben.

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.

Eingänge

command - Command
string. Erforderlich. Zulässige Werte: ci, install, publish, custom. Standardwert: install.

Gibt den Befehl und die Argumente an, die zur Ausführung an npm übergeben werden.

Wenn Ihre Argumente doppelte Anführungszeichen (") enthalten, escapeen Sie sie mit einem Schrägstrich (\), und schließen Sie die escaped Zeichenfolge mit doppelten Anführungszeichen (") ein.

Standardmäßig werden Pakete lokal installiert. Um Pakete global zu installieren, geben Sie install -g als Befehl an. Weitere Informationen finden Sie unter Herunterladen und Installieren von Paketen global und Herunterladen und Installieren von Paketen lokal.

workingDir - Arbeitsordner mit package.json
string.

Gibt den Pfad zum Ordner an, der die Zieldateien package.json und .npmrc enthält. Wählen Sie den Ordner und nicht die Datei aus. Beispiel: /packages/mypackage.

verbose - ausführliche Protokollierungs-
boolean. Wahlfrei. Wird verwendet, wenn command = install || command = ci || command = publish.

Druckt weitere Informationen auf der Konsole, wenn die Aufgabe ausgeführt wird.

customCommand - Befehl und Argumente
string. Erforderlich, wenn command = custom.

Führt einen benutzerdefinierten Befehl aus. Beispiel: dist-tag ls mypackage.

customRegistry - Registrierungen für die Verwendung von
string. Wahlfrei. Wird verwendet, wenn command = install || command = ci || command = custom. Zulässige Werte: useNpmrc (Registrierungen in meinem NPMRC), useFeed (Registrierung, die ich hier auswählte). Standardwert: useNpmrc.

Gibt die zu verwendenden Register an. Führen Sie einen Commit für eine .npmrc Datei in Ihr Quellcode-Repository durch, und legen Sie den Pfad als Wert fest, oder geben Sie eine Registrierung aus Azure Artifacts als Wert an.

customFeed - Verwenden von Paketen aus dieser Azure Artifacts/TFS-Registrierung
string. Erforderlich, wenn (command = install || command = ci || command = custom) && customRegistry = useFeed.

Schließt den ausgewählten Feed in die generierte .npmrcein. Verwenden Sie für projektbezogene Feeds ProjectName/FeedName oder ProjectID/FeedID. Bei Feeds mit Organisationsbereich sollte der Wert der Feedname sein.

customEndpoint - Anmeldeinformationen für Registrierungen außerhalb dieser Organisation/Sammlung
string. Wahlfrei. Wird verwendet, wenn (command = install || command = ci || command = custom) && customRegistry = useNpmrc.

Anmeldeinformationen, die für externe Register verwendet werden sollen, die sich im .npmrcdes Projekts befinden. Lassen Sie dieses Leerzeichen für Register in diesem Konto/dieser Sammlung; die Aufgabe verwendet die Anmeldeinformationen des Builds automatisch.

publishRegistry - Registrierungsspeicherort
string. Wahlfrei. Wird verwendet, wenn command = publish. Zulässige Werte: useExternalRegistry (externe npm-Registrierung (einschließlich anderer Konten/Sammlungen)), useFeed (Registrierung, die ich hier auswählte). Standardwert: useExternalRegistry.

Gibt die Registrierung an, auf die der Befehl ausgerichtet wird.

publishFeed - Zielregistrierung
string. Erforderlich, wenn publishRegistry = useFeed && command = publish.

Gibt eine registrierung an, die im Konto gehostet wird. Sie müssen die Paketverwaltung installiert und lizenziert haben, um hier eine Registrierung auszuwählen.

publishPackageMetadata - Veröffentlichen von Pipelinemetadaten
boolean. Wahlfrei. Wird verwendet, wenn command = publish && publishRegistry = useFeed. Standardwert: true.

Ordnet die Metadaten der Build-/Releasepipeline (die Run#- und Quellcodeinformationen) dem Paket zu.

publishEndpoint - externe Registrierung
string. Erforderlich, wenn publishRegistry = useExternalRegistry && command = publish.

Gibt die Anmeldeinformationen an, die für die Veröffentlichung in einer externen Registrierung verwendet werden sollen.

Aufgabensteuerungsoptionen

Alle Aufgaben verfügen zusätzlich zu ihren Aufgabeneingaben über Steuerungsoptionen. Weitere Informationen finden Sie unter Steuerelementoptionen und allgemeinen Aufgabeneigenschaften.

Ausgabevariablen

Keiner.

Bemerkungen

Hinweis

Der Project Collection Build Service und die Build Service Identität Ihres Projekts müssen auf Mitwirkender festgelegt sein, um Ihre Pakete mithilfe von Azure Pipelines in einem Feed zu veröffentlichen. Weitere Informationen finden Sie unter Hinzufügen neuer Benutzer/Gruppen.

Wo kann ich npm-Befehle und -Argumente erlernen?

npm-Dokumente

Beispiele

Erstellen Ihrer Node.js-App mit gulp

Anforderungen

Anforderung	BESCHREIBUNG
Pipelinetypen	YAML, Classic Build, Classic Release
Läuft auf	Agent, DeploymentGroup
Anforderungen	Self-hosted agents must have capabilities that match the following anforderungen to run jobs that use this task: npm
Funktionen	Dieser Vorgang erfüllt keine Anforderungen für nachfolgende Vorgänge im Auftrag.
Befehlseinschränkungen	Jegliche
Settable-Variablen	Jegliche
Agentversion	2.115.0 oder höher
Vorgangskategorie	Paket

Freigeben über