Condividi tramite


Npm@1 - attività npm v1

Usare questa attività per installare e pubblicare pacchetti npm o per eseguire un npm comando. Supporta npmjs.com e autenticati registri come Gli artefatti di Azure.

Nota

L'attività npm Authentication è il modo consigliato per eseguire l'autenticazione con Gli artefatti di Azure. Questa attività non accetta più nuove funzionalità e vengono risolti solo bug critici.

Sintassi

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

Input

command - Comando
string. Obbligatorio. Valori consentiti: ci, install, custompublish. Valore predefinito: install.

Specifica il comando e gli argomenti, passati a npm per l'esecuzione.

Se gli argomenti contengono virgolette doppie (), li escape con una barra (") e circondano la stringa di escape con virgolette doppie (\").


command - Comando
string. Obbligatorio. Valori consentiti: install, publish, custom. Valore predefinito: install.

Specifica il comando e gli argomenti, passati a npm per l'esecuzione.

Se gli argomenti contengono virgolette doppie (), li escape con una barra (") e circondano la stringa di escape con virgolette doppie (\").


workingDir - Cartella di lavoro contenente package.json
string.

Specifica il percorso della cartella contenente la destinazione package.json e .npmrc i file. Selezionare la cartella, non il file. Esempio: /packages/mypackage.


workingDir - Cartella di lavoro con package.json
string.

Specifica il percorso della cartella contenente la destinazione package.json e .npmrc i file. Selezionare la cartella, non il file. Esempio: /packages/mypackage.


verbose - Registrazione dettagliata
boolean. facoltativo. Usare quando command = install || command = ci || command = publish.

Stampa altre informazioni sulla console quando l'attività viene eseguita.


verbose - Registrazione dettagliata
boolean. facoltativo. Usare quando command = install || command = publish.

Stampa altre informazioni sulla console quando l'attività viene eseguita.


customCommand - Comandi e argomenti
string. Obbligatorio quando command = custom.

Esegue un comando personalizzato. Esempio: dist-tag ls mypackage.


customRegistry - Registri da usare
string. facoltativo. Usare quando command = install || command = ci || command = custom. Valori consentiti: useNpmrc (Registri in my .npmrc), useFeed (Registro di sistema selezionato qui). Valore predefinito: useNpmrc.

Specifica i registri da usare. Eseguire il commit di un file nel repository del codice sorgente e impostarne il percorso come valore oppure specificare un .npmrc Registro di sistema da Elementi di Azure come valore.


customRegistry - Registri da usare
string. facoltativo. Usare quando command = install || command = custom. Valori consentiti: useNpmrc (Registri in my .npmrc), useFeed (Registro di sistema selezionato qui). Valore predefinito: useNpmrc.

Specifica i registri da usare. Eseguire il commit di un file nel repository del codice sorgente e impostarne il percorso come valore oppure specificare un .npmrc Registro di sistema da Elementi di Azure come valore.


customFeed - Usare i pacchetti da questo registro Azure Artifacts/TFS
string. Obbligatorio quando customRegistry = useFeed && command = install || command = ci || command = custom.

Include il feed selezionato nell'oggetto generato .npmrc. Per i feed con ambito progetto, usare ProjectName/FeedName o ProjectID/FeedID. Per i feed con ambito organizzazione, il valore deve essere il nome del feed.


customFeed - Usare i pacchetti da questo registro Azure Artifacts/TFS
string. Obbligatorio quando customRegistry = useFeed && command = install || command = custom.

Include il feed selezionato nell'oggetto generato .npmrc. Per i feed con ambito progetto, usare ProjectName/FeedName o ProjectID/FeedID. Per i feed con ambito organizzazione, il valore deve essere il nome del feed.


customEndpoint - Credenziali per i registri all'esterno di questa organizzazione/raccolta
string. facoltativo. Usare quando customRegistry = useNpmrc && command = install || command = ci || command = custom.

Credenziali da usare per i registri esterni che si trovano nel progetto .npmrc. Lasciare vuoto questo valore per i registri in questo account/raccolta; l'attività usa automaticamente le credenziali della compilazione.


customEndpoint - Credenziali per i registri all'esterno di questa organizzazione/raccolta
string. facoltativo. Usare quando customRegistry = useNpmrc && command = install || command = custom.

Credenziali da usare per i registri esterni che si trovano nel progetto .npmrc. Lasciare vuoto questo valore per i registri in questo account/raccolta; l'attività usa automaticamente le credenziali della compilazione.


customEndpoint - Credenziali per i registri all'esterno di questo account/raccolta
string. facoltativo. Usare quando customRegistry = useNpmrc && command = install || command = custom.

Credenziali da usare per i registri esterni che si trovano nel progetto .npmrc. Lasciare vuoto questo valore per i registri in questo account/raccolta; l'attività usa automaticamente le credenziali della compilazione.


publishRegistry - Posizione del Registro di sistema
string. facoltativo. Usare quando command = publish. Valori consentiti: useExternalRegistry (Registro di sistema npm esterno (inclusi altri account/raccolte)), useFeed (Registro di sistema selezionato qui). Valore predefinito: useExternalRegistry.

Specifica il Registro di sistema di destinazione del comando.


publishFeed - Registro di sistema di destinazione
string. Obbligatorio quando publishRegistry = useFeed && command = publish.

Specifica un registro ospitato nell'account. È necessario che Gestione pacchetti sia installato e concesso in licenza per selezionare un Registro di sistema qui.


publishPackageMetadata - Pubblicare metadati della pipeline
boolean. facoltativo. Usare quando command = publish && publishRegistry = useFeed && command = install || command = ci || command = publish. Valore predefinito: true.

Associa i metadati della pipeline di compilazione/rilascio (le informazioni di run # e codice sorgente) al pacchetto.


publishPackageMetadata - Pubblicare metadati della pipeline
boolean. facoltativo. Usare quando command = publish && publishRegistry = useFeed && command = install || command = publish. Valore predefinito: true.

Associa i metadati della pipeline di compilazione/versione (le informazioni su run # e codice sorgente) al pacchetto.


publishEndpoint - Registro di sistema esterno
string. Obbligatorio quando publishRegistry = useExternalRegistry && command = publish.

Specifica le credenziali da utilizzare per la pubblicazione in un registro esterno.


Opzioni di controllo delle attività

Tutte le attività dispongono di opzioni di controllo oltre ai relativi input attività. Per altre informazioni, vedere Opzioni di controllo e proprietà comuni delle attività.

Variabili di output

Nessuno.

Osservazioni

Nota

Il servizio di compilazione della raccoltaprogetti e l'identità del servizio di compilazione del progetto devono essere impostati su Collaboratore per pubblicare i pacchetti in un feed usando Azure Pipelines. Per altri dettagli, vedere Aggiungere nuovi utenti/gruppi .

Dove è possibile apprendere i comandi e gli argomenti npm?

Esempio

Requisiti

Requisito Descrizione
Tipi di pipeline YAML, build classica, versione classica
Viene eseguito in Agente, DeploymentGroup
Richieste Gli agenti self-hosted devono avere funzionalità che soddisfano le richieste seguenti per eseguire processi che usano questa attività: npm
Capabilities Questa attività non soddisfa le richieste per le attività successive nel processo.
Restrizioni dei comandi Qualsiasi
Variabili impostabili Qualsiasi
Versione agente 2.115.0 o versione successiva
Categoria attività Pacchetto
Requisito Descrizione
Tipi di pipeline YAML, build classica, versione classica
Viene eseguito in Agente, DeploymentGroup
Richieste Gli agenti self-hosted devono avere funzionalità che soddisfano le richieste seguenti per eseguire processi che usano questa attività: npm
Capabilities Questa attività non soddisfa le richieste per le attività successive nel processo.
Restrizioni dei comandi Qualsiasi
Variabili impostabili Qualsiasi
Versione agente 1.91.0 o versione successiva
Categoria attività Pacchetto