Sdílet prostřednictvím


Npm@1 – úloha npm v1

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

Poznámka

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

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.

Vstupy

command - Příkaz
string. Povinná hodnota. Povolené hodnoty: ci, install, publish, . custom Výchozí hodnota: install.

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

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


command - Příkaz
string. Povinná hodnota. Povolené hodnoty: install, publish, custom. Výchozí hodnota: install.

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

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


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

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


workingDir - Pracovní složka s package.json
string.

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


verbose - Podrobné protokolování
boolean. Nepovinný parametr. Použijte, když command = install || command = ci || command = publish.

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


verbose - Podrobné protokolování
boolean. Nepovinný parametr. Použijte, když command = install || command = publish.

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


customCommand - Příkazy a argumenty
string. Vyžaduje se, když command = custom.

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


customRegistry - Registry, které se mají použít
string. Nepovinný parametr. Použijte, když command = install || command = ci || command = custom. Povolené hodnoty: useNpmrc (Registry v souboru .npmrc) useFeed (Registr vyberu zde). Výchozí hodnota: useNpmrc.

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


customRegistry - Registry, které se mají použít
string. Nepovinný parametr. Použijte, když command = install || command = custom. Povolené hodnoty: useNpmrc (Registry v souboru .npmrc) useFeed (Registr vyberu zde). Výchozí hodnota: useNpmrc.

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


customFeed - Použít balíčky z tohoto registru Azure Artifacts/TFS
string. Vyžaduje se, když customRegistry = useFeed && command = install || command = ci || command = custom.

Zahrne vybraný informační kanál ve vygenerovaném .npmrcobjektu . V případě informačních kanálů vymezených na projektu použijte nebo ProjectName/FeedNameProjectID/FeedID. U informačních kanálů v rámci organizace by hodnotou měl být název informačního kanálu.


customFeed - Použít balíčky z tohoto registru Azure Artifacts/TFS
string. Vyžaduje se, když customRegistry = useFeed && command = install || command = custom.

Zahrne vybraný informační kanál ve vygenerovaném .npmrcobjektu . V případě informačních kanálů vymezených na projektu použijte nebo ProjectName/FeedNameProjectID/FeedID. U informačních kanálů v rámci organizace by hodnotou měl být název informačního kanálu.


customEndpoint - Přihlašovací údaje pro registry mimo tuto organizaci nebo kolekci
string. Nepovinný parametr. Použijte, když customRegistry = useNpmrc && command = install || command = ci || command = custom.

Přihlašovací údaje, které se mají použít pro externí registry umístěné v projektu .npmrc. Pro registry v tomto účtu nebo kolekci ponechte toto prázdné. úloha automaticky použije přihlašovací údaje sestavení.


customEndpoint - Přihlašovací údaje pro registry mimo tuto organizaci nebo kolekci
string. Nepovinný parametr. Použijte, když customRegistry = useNpmrc && command = install || command = custom.

Přihlašovací údaje, které se mají použít pro externí registry umístěné v projektu .npmrc. Pro registry v tomto účtu nebo kolekci ponechte toto prázdné. úloha automaticky použije přihlašovací údaje sestavení.


customEndpoint - Přihlašovací údaje pro registry mimo tento účet nebo kolekci
string. Nepovinný parametr. Použijte, když customRegistry = useNpmrc && command = install || command = custom.

Přihlašovací údaje, které se mají použít pro externí registry umístěné v projektu .npmrc. Pro registry v tomto účtu nebo kolekci ponechte toto prázdné. úloha automaticky použije přihlašovací údaje sestavení.


publishRegistry - Umístění registru
string. Nepovinný parametr. Použijte, když command = publish. Povolené hodnoty: useExternalRegistry (Externí registr npm (včetně jiných účtů nebo kolekcí)) useFeed (Zde vyberu registr). Výchozí hodnota: useExternalRegistry.

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


publishFeed - Cílový registr
string. Vyžaduje se, když publishRegistry = useFeed && command = publish.

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


publishPackageMetadata - Publikování metadat kanálu
boolean. Nepovinný parametr. Použijte, když command = publish && publishRegistry = useFeed && command = install || command = ci || command = publish. Výchozí hodnota: true.

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


publishPackageMetadata - Publikování metadat kanálu
boolean. Nepovinný parametr. Použijte, když command = publish && publishRegistry = useFeed && command = install || command = publish. Výchozí hodnota: true.

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


publishEndpoint - Externí registr
string. Vyžaduje se, když 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 najdete v tématu Možnosti ovládacího prvku a běžné vlastnosti úlohy.

Výstupní proměnné

Žádné

Poznámky

Poznámka

Aby bylo možné publikovat balíčky do informačního kanálu pomocí Azure Pipelines, musí být služba sestavení projectu a identita služby Build Service vašeho projektu nastavená na Přispěvatel . Další podrobnosti najdete v tématu Přidání nových uživatelů nebo skupin .

Kde se naučím příkazy a argumenty npm?

Příklady

Požadavky

Požadavek Popis
Typy kanálů YAML, classic build, verze Classic
Spustí se Agent, DeploymentGroup
Požadavky Agenti v místním prostředí musí mít funkce , které odpovídají následujícím požadavkům na 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ů Všechny
Nastavitelné proměnné Všechny
Verze agenta 2.115.0 nebo vyšší
Kategorie úloh Balíček
Požadavek Popis
Typy kanálů YAML, classic build, verze Classic
Spustí se Agent, DeploymentGroup
Požadavky Agenti v místním prostředí musí mít funkce , které odpovídají následujícím požadavkům na 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ů Všechny
Nastavitelné proměnné Všechny
Verze agenta 1.91.0 nebo vyšší
Kategorie úloh Balíček