Npm@1 – úloha npm v1

Článek
03/24/2025

Pomocí této úlohy můžete nainstalovat a publikovat balíčky npm nebo spustit příkaz npm. Podporuje npmjs.com a ověřené registry, jako je Azure Artifacts.

Poznámka:

Úloha npm Authenticate je doporučeným způsobem ověřování pomocí Azure Artifacts. Tato úloha už nepřijímá nové funkce a řeší se pouze kritické chyby.

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.

Vstupy

command - command
string. Povinné. Povolené hodnoty: ci, install, publishcustom. Výchozí hodnota: install.

Určuje příkaz a argumenty, které se předají npm ke spuštění.

Pokud argumenty obsahují dvojité uvozovky ("), uvozujte je lomítkem (\) a uvozovky ohraničte dvojitými uvozovkami (").

Ve výchozím nastavení se balíčky instalují místně. Pokud chcete balíčky nainstalovat globálně, zadejte install -g jako příkaz. Další informace najdete v tématu Stahování a instalace balíčků globálně a Stahování a instalace balíčků místně.

workingDir - Pracovní složka, která obsahuje package.json
string.

Určuje cestu ke složce obsahující cílové package.json a .npmrc soubory. Vyberte složku, nikoli soubor. Příklad: /packages/mypackage.

verbose - podrobné protokolování
boolean. Volitelný. Používá se při command = install || command = ci || command = publish.

Při spuštění úlohy vytiskne do konzoly další informace.

customCommand - příkazy a argumenty
string. Požadováno při command = custom.

Spustí vlastní příkaz. Příklad: dist-tag ls mypackage.

customRegistry - registry k používání
string. Volitelný. Používá se při command = install || command = ci || command = custom. Povolené hodnoty: useNpmrc (Registry v souboru .npmrc), useFeed (Registr vyberu tady). Výchozí hodnota: useNpmrc.

Určuje, které registry se mají použít. Potvrďte soubor .npmrc do úložiště zdrojového kódu a nastavte jeho cestu jako hodnotu nebo jako hodnotu zadejte registr z Azure Artifacts.

customFeed - Použití balíčků z tohoto registru Azure Artifacts/TFS
string. Požadováno při (command = install || command = ci || command = custom) && customRegistry = useFeed.

Zahrne vybraný informační kanál do vygenerovaného .npmrc. Pro informační kanály v oboru projektu použijte ProjectName/FeedName nebo ProjectID/FeedID. U informačních kanálů vymezených organizací by hodnota měla být název informačního kanálu.

customEndpoint - přihlašovací údaje pro registry mimo tuto organizaci nebo kolekci
string. Volitelný. Používá se při (command = install || command = ci || command = custom) && customRegistry = useNpmrc.

Přihlašovací údaje pro použití pro externí registry umístěné v .npmrcprojektu . U registrů v tomto účtu nebo kolekci ponechte toto prázdné; úloha používá přihlašovací údaje sestavení automaticky.

publishRegistry - umístění registru
string. Volitelný. Používá se při command = publish. Povolené hodnoty: useExternalRegistry (externí registr npm (včetně jiných účtů/kolekcí)), useFeed (registr, který vyberu tady). Výchozí hodnota: useExternalRegistry.

Určuje registr, na který bude příkaz cílit.

publishFeed - cílového registru
string. Požadováno při publishRegistry = useFeed && command = publish.

Určuje registr hostovaný v účtu. Abyste mohli vybrat registr, musíte mít nainstalovanou správu balíčků a licenci.

publishPackageMetadata - publikování metadat kanálu
boolean. Volitelný. Používá se při command = publish && publishRegistry = useFeed. Výchozí hodnota: true.

Přidruží metadata kanálu buildu/verze (informace o spuštění a zdrojovém kódu) k balíčku.

publishEndpoint - externího registru
string. Požadováno při publishRegistry = useExternalRegistry && command = publish.

Určuje přihlašovací údaje, které se mají použít pro publikování do externího registru.

Možnosti ovládání úloh

Všechny úlohy mají kromě vstupů také možnosti ovládání. Další informace naleznete v tématu Možnosti ovládacího prvku a běžné vlastnosti úloh.

Výstupní proměnné

Žádné.

Poznámky

Poznámka:

Služba sestavení kolekce projektů a identita buildové služby projektu musí být nastavená na Přispěvatel publikovat balíčky do informačního kanálu pomocí Azure Pipelines. Další podrobnosti najdete v tématu Přidání nových uživatelů nebo skupin.

Kde najdu příkazy a argumenty npm?

dokumentace k npm

Příklady

vytvoření aplikace Node.js pomocí gulp

Požadavky

Požadavek	Popis
Typy kanálů	YAML, klasické sestavení, klasická verze
Běží na	Agent, DeploymentGroup
požadavky	Agenti v místním prostředí musí mít schopnosti, které odpovídají následujícím požadavkům ke spouštění úloh, které používají tuto úlohu: npm
možnosti	Tento úkol nesplňuje žádné požadavky na následné úkoly v úloze.
omezení příkazů	Jakýkoliv
nastavitelné proměnné	Jakýkoliv
Verze agenta	2.115.0 nebo vyšší
Kategorie úkolu	Balíček

Sdílet prostřednictvím