tâche NPMnpm task

Azure Pipelines | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018-TFS 2015Azure Pipelines | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018 - TFS 2015

Utilisez cette tâche pour installer et publier des packages NPM.Use this task to install and publish npm packages.

Notes

La tâche d' authentification NPM est la méthode recommandée pour s’authentifier auprès de Azure artifacts.The npm Authenticate task is the recommended way to authenticate with Azure Artifacts. Cette tâche ne prend plus de nouvelles fonctionnalités et seuls les bogues critiques sont traités.This task no longer takes new features and only critical bugs are addressed.

Notes

Dans Microsoft Team Foundation Server (TFS) 2018 et versions antérieures, les pipelines de build et de mise en version sont appelés définitions, les exécutions sont appelées Builds, les connexions de service sont appelées points de terminaison de service, les étapes sont appelées environnements et les tâches sont appelées phases.In Microsoft Team Foundation Server (TFS) 2018 and previous versions, build and release pipelines are called definitions, runs are called builds, service connections are called service endpoints, stages are called environments, and jobs are called phases.

Extrait de code YAMLYAML snippet

# npm
# 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' # Options: install, publish, custom
    #workingDir: # Optional
    #verbose: # Optional
    #customCommand: # Required when command == Custom
    #customRegistry: 'useNpmrc' # Optional. Options: useNpmrc, useFeed
    #customFeed: # Required when customRegistry == UseFeed
    #customEndpoint: # Optional
    #publishRegistry: 'useExternalRegistry' # Optional. Options: useExternalRegistry, useFeed
    #publishFeed: # Required when publishRegistry == UseFeed
    #publishPackageMetadata: true # Optional
    #publishEndpoint: # Required when publishRegistry == UseExternalRegistry

Installer les packages npmInstall npm packages

DemandesDemands

npmnpm

ArgumentsArguments

ArgumentArgument DescriptionDescription
command
CommandeCommand
(Obligatoire) commande NPM à exécuter.(Required) npm command to run. Sélectionnez install iciSelect install here
workingDir
Dossier de travail qui contient package.jsonWorking folder that contains package.json
Chemin d’accès au dossier contenant le package.jscible sur les fichiers et. npmrc.Path to the folder containing the target package.json and .npmrc files. Sélectionnez le dossier, pas le fichier, par exemple « /packages/myPackage ».Select the folder, not the file e.g. "/packages/mypackage".
advanced
Journalisation détailléeVerbose logging
Sélectionnez cette option pour afficher plus d’informations sur la console lors de l’exécutionSelect to print more information to the console on run
customRegistries
Registres à utiliserRegistries to use
Vous pouvez soit valider un .npmrc fichier dans votre référentiel de code source et définir son chemin d’accès, soit sélectionner un registre à partir de Azure artifacts.You can either commit a .npmrc file to your source code repository and set its path or select a registry from Azure Artifacts.
useNpmrcuseNpmrc
  • Sélectionnez cette option pour utiliser les flux spécifiés dans un fichier. npmrc que vous avez archivé dans le contrôle de code source.Select this option to use feeds specified in a .npmrc file you've checked into source control. Si aucun .npmrc fichier n’est présent, la tâche utilisera par défaut des packages directement à partir de npmjs.If no .npmrc file is present, the task will default to using packages directly from npmjs.
  • Les informations d’identification pour les registres en dehors de cette organisation/collection peuvent être utilisées pour injecter les informations d’identification que vous avez fournies en tant que connexion de service NPM dans votre. npmrc lors de l’exécution de la Build.Credentials for registries outside this organization/collection can be used to inject credentials you've provided as an npm service connection into your .npmrc as the build runs.
    useFeeduseFeed
  • Sélectionnez cette option pour utiliser un flux Azure Artifacts dans la même organisation/collection que la Build.Select this option to use one Azure Artifacts feed in the same organization/collection as the build.
  • Publier des packages NPMPublish npm packages

    DemandesDemands

    npmnpm

    ArgumentsArguments

    ArgumentArgument DescriptionDescription
    command
    CommandeCommand
    (Obligatoire) commande NPM à exécuter.(Required) npm command to run. Sélectionnez publier ici.Select publish here.
    workingDir
    Dossier de travail qui contient package.jsonWorking folder that contains package.json
    Chemin d’accès au dossier contenant le package.jscible sur les fichiers et. npmrc.Path to the folder containing the target package.json and .npmrc files. Sélectionnez le dossier, pas le fichier, par exemple « /packages/myPackage ».Select the folder, not the file e.g. "/packages/mypackage".
    advanced
    Journalisation détailléeVerbose logging
    Sélectionnez cette option pour afficher plus d’informations sur la console lors de l’exécutionSelect to print more information to the console on run
    customRegistries
    Registres à utiliserRegistries to use
    Vous pouvez soit valider un .npmrc fichier dans votre référentiel de code source et définir son chemin d’accès, soit sélectionner un registre à partir de Azure artifacts.You can either commit a .npmrc file to your source code repository and set its path or select a registry from Azure Artifacts.
    useNpmrcuseNpmrc
  • Sélectionnez cette option pour utiliser les flux spécifiés dans un fichier. npmrc que vous avez archivé dans le contrôle de code source.Select this option to use feeds specified in a .npmrc file you've checked into source control. Si aucun .npmrc fichier n’est présent, la tâche utilisera par défaut des packages directement à partir de npmjs.If no .npmrc file is present, the task will default to using packages directly from npmjs.
  • Les informations d’identification pour les registres en dehors de cette organisation/collection peuvent être utilisées pour injecter les informations d’identification que vous avez fournies en tant que connexion de service NPM dans votre. npmrc lors de l’exécution de la Build.Credentials for registries outside this organization/collection can be used to inject credentials you've provided as an npm service connection into your .npmrc as the build runs.
    useFeeduseFeed
  • Sélectionnez cette option pour utiliser un flux Azure Artifacts dans la même organisation/collection que la Build.Select this option to use one Azure Artifacts feed in the same organization/collection as the build.
  • Commande NPM personnaliséeCustom npm command

    DemandesDemands

    npmnpm

    ArgumentsArguments

    ArgumentArgument DescriptionDescription
    command
    CommandeCommand
    (Obligatoire) commande NPM à exécuter.(Required) npm command to run. Sélectionnez personnalisé ici.Select custom here.
    workingDir
    Dossier de travail qui contient package.jsonWorking folder that contains package.json
    Chemin d’accès au dossier contenant le package.jscible sur les fichiers et. npmrc.Path to the folder containing the target package.json and .npmrc files. Sélectionnez le dossier, pas le fichier, par exemple « /packages/myPackage ».Select the folder, not the file e.g. "/packages/mypackage".
    customCommand
    Commande et argumentsCommand and arguments
    Souhaitée Commande personnalisée à exécuter, par exemple " dist-tag LS MyPackage " .(Required) Custom command to run, e.g. "dist-tag ls mypackage".
    Si vos arguments contiennent des guillemets doubles ("), entourez-les d’une barre oblique ( \ ) et placez la chaîne placée dans une séquence d’échappement entre guillemets doubles (").If your arguments contain double quotes ("), escape them with a slash (\), and surround the escaped string with double quotes (").
    Exemple : pour exécuter npm run myTask -- --users='{"foo":"bar"}' , fournissez cette entrée : run myTask -- --users="{"foo":"bar"}" .Example: to run npm run myTask -- --users='{"foo":"bar"}', provide this input: run myTask -- --users="{"foo":"bar"}".
    customRegistries
    Registres à utiliserRegistries to use
    Vous pouvez soit valider un .npmrc fichier dans votre référentiel de code source et définir son chemin d’accès, soit sélectionner un registre à partir de Azure artifacts.You can either commit a .npmrc file to your source code repository and set its path or select a registry from Azure Artifacts.
    useNpmrcuseNpmrc
  • Sélectionnez cette option pour utiliser les flux spécifiés dans un fichier. npmrc que vous avez archivé dans le contrôle de code source.Select this option to use feeds specified in a .npmrc file you've checked into source control. Si aucun .npmrc fichier n’est présent, la tâche utilisera par défaut des packages directement à partir de npmjs.If no .npmrc file is present, the task will default to using packages directly from npmjs.
  • Les informations d’identification pour les registres en dehors de cette organisation/collection peuvent être utilisées pour injecter les informations d’identification que vous avez fournies en tant que connexion de service NPM dans votre. npmrc lors de l’exécution de la Build.Credentials for registries outside this organization/collection can be used to inject credentials you've provided as an npm service connection into your .npmrc as the build runs.
    useFeeduseFeed
  • Sélectionnez cette option pour utiliser un flux Azure Artifacts dans la même organisation/collection que la Build.Select this option to use one Azure Artifacts feed in the same organization/collection as the build.
  • ExemplesExamples

    Build : GulpBuild: gulp

    Générez votre application Node.js avec GulpBuild your Node.js app with gulp

    Open sourceOpen source

    Cette tâche est open source sur GitHub.This task is open source on GitHub. Les commentaires et les contributions sont les bienvenues.Feedback and contributions are welcome.

    Questions fréquentes (FAQ)FAQ

    Où puis-je apprendre les commandes et les arguments npm ?Where can I learn npm commands and arguments?

    documentation NPMnpm docs

    Ai-je besoin d’un agent ?Do I need an agent?

    Vous devez disposer d’au moins un agent pour exécuter votre build ou version finale.You need at least one agent to run your build or release.

    Je rencontre des problèmes.I'm having problems. Comment les résoudre ?How can I troubleshoot them?

    Consultez résoudre les problèmes de build et de mise en version.See Troubleshoot Build and Release.

    Je ne peux pas sélectionner un pool d’agents par défaut et je ne peux pas mettre ma Build ou sa mise en file d’attente.I can't select a default agent pool and I can't queue my build or release. Comment la corriger ?How do I fix this?

    Voir pools d’agents.See Agent pools.

    Ma tâche Push NuGet échoue avec l’erreur suivante : « erreur : impossible d’accéder au certificat de l’émetteur local ».My NuGet push task is failing with the following error: "Error: unable to get local issuer certificate". Comment puis-je résoudre ce problème ?How can I fix this?

    Vous pouvez résoudre ce problème en ajoutant un certificat racine approuvé.This can be fixed by adding a trusted root certificate. Vous pouvez ajouter la NODE_EXTRA_CA_CERTS=file variable d’environnement à votre agent de build, ou vous pouvez ajouter la NODE.EXTRA.CA.CERTS=file variable de tâche dans votre pipeline.You can either add the NODE_EXTRA_CA_CERTS=file environment variable to your build agent, or you can add the NODE.EXTRA.CA.CERTS=file task variable in your pipeline. Pour plus d’informations, consultez variables d’environnement .See Environment variables for more details.

    J’utilise TFS localement et je ne vois pas certaines de ces fonctionnalités.I use TFS on-premises and I don't see some of these features. Pourquoi cela ne fonctionne-t-il pas ?Why not?

    Certaines de ces fonctionnalités sont disponibles uniquement sur Azure pipelines et ne sont pas encore disponibles localement.Some of these features are available only on Azure Pipelines and not yet available on-premises. Certaines fonctionnalités sont disponibles en local si vous avez effectué une mise à niveau vers la dernière version de TFS.Some features are available on-premises if you have upgraded to the latest version of TFS.