Partager via

Npm@1 - tâche npm v1

Utilisez cette tâche pour installer et publier des packages npm ou pour exécuter une commande npm. Prend en charge les registres npmjs.com et authentifiés comme Azure Artifacts.

Remarque

Pour vous authentifier auprès des flux Azure Artifacts, utilisez la tâche d’authentification npm . La Npm@1 tâche n’est plus en cours de développement actif, seuls les bogues critiques sont résolus.

Syntaxe

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

Entrées

command - commande
string. Obligatoire. Valeurs autorisées : ci, install, publish, custom. Valeur par défaut : install.

Spécifie la commande et les arguments qui sont passés à npm pour l’exécution.

Si vos arguments contiennent des guillemets doubles ("), les échappent avec une barre oblique (\) et entourent la chaîne d’échappement avec des guillemets doubles (").

Par défaut, les packages sont installés localement. Pour installer des packages globalement, spécifiez install -g comme commande. Pour plus d’informations, consultez Téléchargement et installation de packages globalement et Téléchargement et installation de packages localement.


dossier de travail workingDir - qui contient package.json
string.

Spécifie le chemin d’accès au dossier contenant le package.json cible et les fichiers .npmrc. Sélectionnez le dossier, et non le fichier. Exemple : /packages/mypackage.


verbose - journalisation détaillée
boolean. Optionnel. Utilisez quand command = install || command = ci || command = publish.

Imprime plus d’informations sur la console lors de l’exécution de la tâche.


customCommand - Commandes et arguments
string. Obligatoire lorsque command = custom.

Exécute une commande personnalisée. Exemple : dist-tag ls mypackage.


registres customRegistry - à utiliser
string. Optionnel. Utilisez quand command = install || command = ci || command = custom. Valeurs autorisées : useNpmrc (Registres dans mon fichier .npmrc), useFeed (Registre que je sélectionne ici). Valeur par défaut : useNpmrc.

Spécifie les registres à utiliser. Validez un fichier .npmrc dans votre référentiel de code source et définissez son chemin comme valeur, ou spécifiez un registre à partir d’Azure Artifacts comme valeur.


customFeed - Utiliser des packages à partir de ce registre Azure Artifacts/TFS
string. Obligatoire lorsque (command = install || command = ci || command = custom) && customRegistry = useFeed.

Inclut le flux sélectionné dans le .npmrcgénéré. Pour les flux délimités par le projet, utilisez ProjectName/FeedName ou ProjectID/FeedID. Pour les flux délimités par l’organisation, la valeur doit être le nom du flux.


informations d’identification customEndpoint - pour les registres en dehors de cette organisation/ de collecte
string. Optionnel. Utilisez quand (command = install || command = ci || command = custom) && customRegistry = useNpmrc.

Informations d’identification à utiliser pour les registres externes situés dans le .npmrcdu projet. Laissez cette valeur vide pour les registres de ce compte/collection ; la tâche utilise automatiquement les informations d’identification de la build.


publishRegistry - emplacement du Registre
string. Optionnel. Utilisez quand command = publish. Valeurs autorisées : useExternalRegistry (Registre npm externe (y compris d’autres comptes/collections)), useFeed (Registre que je sélectionne ici). Valeur par défaut : useExternalRegistry.

Spécifie le Registre que la commande cible.


publishFeed - registre cible
string. Obligatoire lorsque publishRegistry = useFeed && command = publish.

Spécifie un registre hébergé dans le compte. La gestion des packages doit être installée et concédée sous licence pour sélectionner un registre ici.


publishPackageMetadata - Publier des métadonnées de pipeline
boolean. Optionnel. Utilisez quand command = publish && publishRegistry = useFeed. Valeur par défaut : true.

Associe les métadonnées du pipeline de génération/mise en production (les informations de code source et run #) au package.


publishEndpoint - registre externe
string. Obligatoire lorsque publishRegistry = useExternalRegistry && command = publish.

Spécifie les informations d’identification à utiliser pour la publication dans un registre externe.


Options de contrôle de la tâche

Toutes les tâches ont des options de contrôle en plus de leurs entrées de tâches. Pour plus d’informations, consultez Options de contrôle et propriétés de tâche courantes.

Variables de sortie

Aucun.

Remarques

Remarque

Le service de génération de regroupement de projets et l’identité Build Service de votre projet doivent être définies sur contributeur pour publier vos packages dans un flux à l’aide d’Azure Pipelines. Pour plus d’informations, consultez Ajouter de nouveaux utilisateurs/groupes.

Où puis-je en savoir plus sur les commandes npm répertoriées ?

Exemples

Spécifications

Besoin Descriptif
Types de pipelines YAML, Build Classique, Version Classique
Exécutions sur Agent, DeploymentGroup
demandes Les agents auto-hébergés doivent disposer de fonctionnalités qui correspondent aux exigences de suivantes pour exécuter des travaux qui utilisent cette tâche : npm
fonctionnalités de Cette tâche ne répond à aucune demande de tâches ultérieures dans le travail.
restrictions de commande N'importe quel
variables settables N'importe quel
Version de l’agent 2.115.0 ou version ultérieure
Catégorie de tâche Paquet