Npm@1 – npm v1-Aufgabe

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 Möglichkeit, sich bei Azure Artifacts zu authentifizieren. Für diese Aufgabe werden keine neuen Features mehr hinzugefügt, und es werden nur kritische Fehler 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 && 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.

Eingaben

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

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

Wenn Ihre Argumente doppelte Anführungszeichen () enthalten," werden sie mit einem Schrägstrich (\) versehen und die escapete Zeichenfolge mit doppelten Anführungszeichen (") umgeben.

workingDir - Arbeitsordner mit package.json
string.

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

verbose - Ausführliche Protokollierung
boolean. Optional. Verwenden Sie , wenn command = install || command = ci || command = publish.

Gibt weitere Informationen an die Konsole aus, wenn der Task ausgeführt wird.

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

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

customRegistry - Zu verwendende Registrierungen
string. Optional. Verwenden Sie , 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 Registrierungen an. Committen Sie eine .npmrc Datei in Ihr Quellcoderepository, und legen Sie ihren 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 customRegistry = useFeed && command = install || command = ci || command = custom.

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

customEndpoint - Anmeldeinformationen für Registrierungen außerhalb dieser organization/Sammlung
string. Optional. Verwenden Sie , wenn customRegistry = useNpmrc && command = install || command = ci || command = custom.

Anmeldeinformationen, die für externe Registrierungen verwendet werden sollen, die sich im Projekt befinden .npmrc. Lassen Sie dies für Registrierungen in diesem Konto/dieser Sammlung leer; Der Task verwendet automatisch die Anmeldeinformationen des Builds.

publishRegistry - Registrierungsspeicherort
string. Optional. Verwenden Sie , wenn command = publish. Zulässige Werte: useExternalRegistry (Externe npm-Registrierung (einschließlich anderer Konten/Sammlungen)), useFeed (Registrierung, die ich hier auswähl. Standardwert. useExternalRegistry.

Gibt die Registrierung an, auf die der Befehl ausgerichtet werden soll.

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 auswählen zu können.

publishPackageMetadata - Veröffentlichen von Pipelinemetadaten
boolean. Optional. Verwenden Sie , wenn command = publish && publishRegistry = useFeed && command = install || command = ci || command = publish. Standardwert. true.

Ordnet dem Paket die Metadaten der Build-/Releasepipeline (ausführungs# und Quellcodeinformationen) 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.

Optionen für die Vorgangskontrolle

Alle Vorgänge verfügen zusätzlich zu ihren Eingaben über Steuerungsoptionen. Weitere Informationen finden Sie unter Steuerungsoptionen und allgemeine Aufgabeneigenschaften.

Ausgabevariablen

Keine.

Hinweise

Hinweis

Der Builddienst der Projektsammlung und die Builddienstidentität Ihres Projekts müssen auf Mitwirkender festgelegt werden, um Ihre Pakete mithilfe von Azure Pipelines in einem Feed zu veröffentlichen. Weitere Informationen finden Sie unter Hinzufügen neuer Benutzer/Gruppen .

Wo erhalte ich Informationen zu npm-Befehlen und -Argumenten?

• npm-Dokumentation

Beispiele

• Erstellen Ihrer Node.js-App mit gulp

Anforderungen

Anforderung	BESCHREIBUNG
Pipelinetypen	YAML, Klassischer Build, klassisches Release
Wird ausgeführt auf	Agent, DeploymentGroup
Forderungen	Selbstgehostete Agents müssen über Funktionen verfügen, die den folgenden Anforderungen entsprechen, um Aufträge auszuführen, die diese Aufgabe verwenden: npm
Capabilities	Diese Aufgabe erfüllt keine Anforderungen an nachfolgende Aufgaben im Auftrag.
Befehlseinschränkungen	Any
Setzbare Variablen	Any
Agent-Version	2.115.0 oder höher
Aufgabenkategorie	Paket