Teilen über


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

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.


command - Befehl
string. Erforderlich. Zulässige Werte: install, publish und 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.


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.


verbose - Ausführliche Protokollierung
boolean. Optional. Verwenden Sie , wenn command = install || 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.


customRegistry - Zu verwendende Registrierungen
string. Optional. Verwenden Sie , wenn command = install || 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.


customFeed - Verwenden von Paketen aus dieser Azure Artifacts/TFS-Registrierung
string. Erforderlich, wenn customRegistry = useFeed && command = install || 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.


customEndpoint - Anmeldeinformationen für Registrierungen außerhalb dieser organization/Sammlung
string. Optional. Verwenden Sie , wenn customRegistry = useNpmrc && command = install || 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.


customEndpoint - Anmeldeinformationen für Registrierungen außerhalb dieses Kontos/dieser Sammlung
string. Optional. Verwenden Sie , wenn customRegistry = useNpmrc && command = install || 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.


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

Ordnet die Metadaten der Build-/Releasepipeline (die Ausführungs- 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.


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?

Beispiele

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
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 1.91.0 oder höher
Aufgabenkategorie Paket