Nota
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Use esta tarea para instalar y publicar paquetes de npm o para ejecutar un comando npm
. Admite npmjs.com y registros autenticados como Azure Artifacts.
Nota:
Para autenticarse con fuentes de Azure Artifacts, use la tarea Autenticación de npm . La Npm@1
tarea ya no está en desarrollo activo, solo se solucionan errores críticos.
Sintaxis
# 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.
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 ("
), escape con una barra diagonal (\
) y rodear la cadena de escape con comillas dobles ("
).
De forma predeterminada, los paquetes se instalan localmente. Para instalar paquetes globalmente, especifique install -g
como comando. Para obtener más información, consulte Descarga e instalación de paquetes globalmente y Descarga e instalación de paquetes localmente.
workingDir
-
carpeta Working que contiene package.json
string
.
Especifica la ruta de acceso a la carpeta que contiene el package.json
de destino y los archivos .npmrc
. Seleccione la carpeta, no el archivo. Ejemplo: /packages/mypackage
.
verbose
-
de 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.
customCommand
-
comando y argumentos
string
. Obligatorio cuando command = custom
.
Ejecuta un comando personalizado. Ejemplo: dist-tag ls mypackage
.
customRegistry
-
Registros para 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 archivo .npmrc
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
. Obligatorio cuando (command = install || command = ci || command = custom) && customRegistry = useFeed
.
Incluye la fuente seleccionada en el .npmrc
generado. 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 (command = install || command = ci || command = custom) && customRegistry = useNpmrc
.
Credenciales que se usarán para registros externos ubicados en el .npmrc
del proyecto. Deje esto en blanco para los registros de esta cuenta o colección; la tarea usa automáticamente las credenciales de la compilación.
de ubicación del Registro de publishRegistry
-
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
-
del registro de destino
string
. Obligatorio 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
. 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
-
del Registro externo
string
. Obligatorio cuando publishRegistry = useExternalRegistry && command = publish
.
Especifica las credenciales que se van a usar para publicar en un registro externo.
Opciones de control de tareas
Todas las tareas tienen opciones de control además de sus entradas de tarea. Para obtener más información, consulte Opciones de control y propiedades de tareas comunes.
Variables de salida
Ninguno.
Observaciones
Nota:
La del servicio de compilación de colecciones de proyectos de y la identidad del servicio de compilación de 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 información.
¿Dónde puedo obtener más información sobre los comandos npm enumerados?
Ejemplos
Requisitos
Requisito | Descripción |
---|---|
Tipos de canalización | YAML, compilación clásica, versión clásica |
Se ejecuta en | Agente, DeploymentGroup |
demandas | Los agentes autohospedados deben tener funcionalidades que coincidan con los siguientes exigen ejecutar trabajos que usen esta tarea: npm |
funcionalidades de |
Esta tarea no satisface ninguna demanda de tareas posteriores en el trabajo. |
restricciones de comandos | Cualquiera |
variables settable | Cualquiera |
Versión del agente | 2.115.0 o superior |
Categoría de tarea | Paquete |