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 registri autenticati come Azure Artifacts.

Annotazioni

Per eseguire l'autenticazione con i feed di Azure Artifacts, usare l'attività npm Authenticate . L'attività Npm@1 non è più in fase di sviluppo attivo, vengono risolti solo i 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. 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.

Ingressi dati

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

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

Se gli argomenti contengono virgolette doppie ("), eseguirne l'escape con una barra (\) e racchiudere la stringa preceduta da virgolette doppie (").

Per impostazione predefinita, i pacchetti vengono installati in locale. Per installare i pacchetti a livello globale, specificare install -g come comando. Per altre informazioni, vedere Download e installazione di pacchetti a livello globale e Download e installazione di pacchetti in locale.


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.


verbose - di registrazione dettagliata
boolean. Opzionale. Usare quando command = install || command = ci || command = publish.

Stampa altre informazioni nella console durante l'esecuzione dell'attività.


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

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


customRegistry - Registri da usare
string. Opzionale. Usare quando command = install || command = ci || command = custom. Valori consentiti: useNpmrc (Registri nel file con estensione npmrc), useFeed (Registro di sistema selezionato qui). Valore predefinito: useNpmrc

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


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

Include il feed selezionato nel .npmrcgenerato. 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 registri esterni a questa organizzazione/raccolta
string. Opzionale. Usare quando (command = install || command = ci || command = custom) && customRegistry = useNpmrc.

Credenziali da usare per registri esterni che si trovano nell'oggetto del .npmrcprogetto. Lasciare vuoto questo campo per i registri in questo account/raccolta; l'attività usa automaticamente le credenziali della compilazione.


publishRegistry - Percorso del Registro di sistema
string. Opzionale. 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. Per selezionare un Registro di sistema, è necessario che Gestione pacchetti sia installato e concesso in licenza.


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

Associa i metadati della pipeline di compilazione/versione (le informazioni sul codice di esecuzione e il 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 uscita

Nessuno.

Osservazioni:

Annotazioni

Il servizio di compilazione della raccolta di progetti 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 ottenere altre informazioni sui comandi npm elencati?

Esempi

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
funzionalità di Questa attività non soddisfa alcuna richiesta di attività successive nel processo.
restrizioni dei comandi Qualunque
variabili impostabili Qualunque
Versione agente 2.115.0 o versione successiva
Categoria attività Pacchetto