Npm@1: tarea npm v1

Use esta tarea para instalar y publicar paquetes de npm o para ejecutar un npm comando. Admite npmjs.com y autentica registros como Azure Artifacts.

Nota

La tarea autenticación de npm es la manera recomendada de autenticarse con Azure Artifacts. Esta tarea ya no toma nuevas características y solo se solucionan errores críticos.

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.

Entradas

command - Comando
string. Obligatorio. Valores permitidos: ci, install, publish, custom. Valor predeterminado: install.

Especifica el comando y los argumentos, que se pasan a npm para su ejecución.

Si los argumentos contienen comillas dobles ("), puede escaparlos con una barra diagonal (\) y rodear la cadena con comillas dobles (").


command - Comando
string. Obligatorio. Valores permitidos: install, publish y custom. Valor predeterminado: install.

Especifica el comando y los argumentos, que se pasan a npm para su ejecución.

Si los argumentos contienen comillas dobles ("), puede escaparlos con una barra diagonal (\) y rodear la cadena con comillas dobles (").


workingDir - Carpeta de trabajo que contiene package.json
string.

Especifica la ruta de acceso a la carpeta que contiene el destino package.json y .npmrc los archivos. Seleccione la carpeta, no el archivo. Ejemplo: /packages/mypackage.


workingDir - Carpeta de trabajo con package.json
string.

Especifica la ruta de acceso a la carpeta que contiene el destino package.json y .npmrc los archivos. Seleccione la carpeta, no el archivo. Ejemplo: /packages/mypackage.


verbose - Registro detallado
boolean. Opcional. Use cuando command = install || command = ci || command = publish.

Imprime más información en la consola cuando se ejecuta la tarea.


verbose - Registro detallado
boolean. Opcional. Use cuando command = install || command = publish.

Imprime más información en la consola cuando se ejecuta la tarea.


customCommand - Comandos y argumentos
string. Necesario cuando command = custom.

Ejecuta un comando personalizado. Ejemplo: dist-tag ls mypackage.


customRegistry - Registros que se van a usar
string. Opcional. Use cuando command = install || command = ci || command = custom. Valores permitidos: useNpmrc (Registros en mi .npmrc), useFeed (Registro que selecciono aquí). Valor predeterminado: useNpmrc.

Especifica los registros que se van a usar. Confirme un .npmrc archivo en el repositorio de código fuente y establezca su ruta de acceso como valor, o especifique un registro de Azure Artifacts como valor.


customRegistry - Registros que se van a usar
string. Opcional. Use cuando command = install || command = custom. Valores permitidos: useNpmrc (Registros en mi .npmrc), useFeed (Registro que selecciono aquí). Valor predeterminado: useNpmrc.

Especifica los registros que se van a usar. Confirme un .npmrc archivo en el repositorio de código fuente y establezca su ruta de acceso como valor, o especifique un registro de Azure Artifacts como valor.


customFeed - Uso de paquetes de este registro de Azure Artifacts/TFS
string. Necesario cuando customRegistry = useFeed && command = install || command = ci || command = custom.

Incluye la fuente seleccionada en el elemento generado .npmrc. Para fuentes con ámbito de proyecto, use ProjectName/FeedName o ProjectID/FeedID. En el caso de las fuentes con ámbito de organización, el valor debe ser el nombre de fuente.


customFeed - Uso de paquetes de este registro de Azure Artifacts/TFS
string. Necesario cuando customRegistry = useFeed && command = install || command = custom.

Incluye la fuente seleccionada en el elemento generado .npmrc. Para fuentes con ámbito de proyecto, use ProjectName/FeedName o ProjectID/FeedID. En el caso de las fuentes con ámbito de organización, el valor debe ser el nombre de fuente.


customEndpoint - Credenciales para registros fuera de esta organización o colección
string. Opcional. Use cuando customRegistry = useNpmrc && command = install || command = ci || command = custom.

Credenciales que se usarán para los registros externos ubicados en el proyecto .npmrc. Deje esto en blanco para los registros de esta cuenta o colección; la tarea usa automáticamente las credenciales de la compilación.


customEndpoint - Credenciales para registros fuera de esta organización o colección
string. Opcional. Use cuando customRegistry = useNpmrc && command = install || command = custom.

Credenciales que se usarán para los registros externos ubicados en el proyecto .npmrc. Deje esto en blanco para los registros de esta cuenta o colección; la tarea usa automáticamente las credenciales de la compilación.


customEndpoint - Credenciales para registros fuera de esta cuenta o colección
string. Opcional. Use cuando customRegistry = useNpmrc && command = install || command = custom.

Credenciales que se usarán para los registros externos ubicados en el proyecto .npmrc. Deje esto en blanco para los registros de esta cuenta o colección; la tarea usa automáticamente las credenciales de la compilación.


publishRegistry - Ubicación del Registro
string. Opcional. Use cuando command = publish. Valores permitidos: useExternalRegistry (Registro npm externo (incluidas otras cuentas o colecciones)), useFeed (Registro que selecciono aquí). Valor predeterminado: useExternalRegistry.

Especifica el registro al que se dirige el comando.


publishFeed - Registro de destino
string. Necesario cuando publishRegistry = useFeed && command = publish.

Especifica un registro hospedado en la cuenta. Debe tener la administración de paquetes instalada y con licencia para seleccionar un registro aquí.


publishPackageMetadata - Publicación de metadatos de canalización
boolean. Opcional. Use cuando command = publish && publishRegistry = useFeed && command = install || command = ci || command = publish. Valor predeterminado: true.

Asocia los metadatos de la canalización de compilación o versión (la información de código fuente y de ejecución) con el paquete.


publishPackageMetadata - Publicación de metadatos de canalización
boolean. Opcional. Use cuando command = publish && publishRegistry = useFeed && command = install || command = publish. Valor predeterminado: true.

Asocia los metadatos de la canalización de compilación o versión (la información de código fuente y de ejecución) con el paquete.


publishEndpoint - Registro externo
string. Necesario cuando publishRegistry = useExternalRegistry && command = publish.

Especifica las credenciales que se usarán para publicar en un registro externo.


Opciones de control de tareas

Todas las tareas tienen opciones de control además de las entradas de tareas. Para obtener más información, vea Opciones de control y propiedades de tareas comunes.

Variables de salida

Ninguno.

Comentarios

Nota:

El servicio de compilación de colecciones de proyectos y la identidad del servicio de compilación del proyecto deben establecerse en Colaborador para publicar los paquetes en una fuente mediante Azure Pipelines. Consulte Agregar nuevos usuarios o grupos para obtener más detalles.

¿Dónde puedo aprender los comandos y argumentos de npm?

Ejemplos

Requisitos

Requisito Descripción
Tipos de canalización YAML, compilación clásica, versión clásica
Se ejecuta en Agente, DeploymentGroup
Peticiones Los agentes autohospedados deben tener funcionalidades que coincidan con las siguientes demandas para ejecutar trabajos que usen esta tarea: npm
Capabilities Esta tarea no satisface ninguna demanda de tareas posteriores en el trabajo.
Restricciones de comandos Any
Variables que se pueden establecer Any
Versión del agente 2.115.0 o superior
Categoría de la tarea: Paquete
Requisito Descripción
Tipos de canalización YAML, compilación clásica, versión clásica
Se ejecuta en Agente, DeploymentGroup
Peticiones Los agentes autohospedados deben tener funcionalidades que coincidan con las siguientes demandas para ejecutar trabajos que usen esta tarea: npm
Capabilities Esta tarea no satisface ninguna demanda de tareas posteriores en el trabajo.
Restricciones de comandos Any
Variables que se pueden establecer Any
Versión del agente 1.91.0 o superior
Categoría de la tarea: Paquete