Поделиться через


Npm@1 — задача npm версии 1

Используйте эту задачу для установки и публикации пакетов npm или для выполнения npm команды. Поддерживает npmjs.com и прошедшие проверку подлинности реестры, такие как Azure Artifacts.

Примечание

Задача npm Authenticate — это рекомендуемый способ проверки подлинности с помощью Azure Artifacts. Эта задача больше не использует новые функции и устраняются только критические ошибки.

Синтаксис

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

Входные данные

command - Команды
string. Обязательный. Допустимые значения: ci, install, publish, custom. Значение по умолчанию: install.

Указывает команду и аргументы, которые передаются в npm для выполнения.

Если аргументы содержат двойные кавычки ("), экранируйте их косой чертой (\) и заключите экранированную строку двойными кавычками (").


command - Команды
string. Обязательный. Допустимые значения: install, publish, custom. Значение по умолчанию: install.

Указывает команду и аргументы, которые передаются в npm для выполнения.

Если аргументы содержат двойные кавычки ("), экранируйте их косой чертой (\) и заключите экранированную строку двойными кавычками (").


workingDir - Рабочая папка, содержащая package.json
string.

Указывает путь к папке, содержащей целевой объект package.json и .npmrc файлы. Выберите папку, а не файл. Например, /packages/mypackage.


workingDir - Рабочая папка с package.json
string.

Указывает путь к папке, содержащей целевой объект package.json и .npmrc файлы. Выберите папку, а не файл. Например, /packages/mypackage.


verbose - Подробное ведение журнала
boolean. Необязательный элемент. Используйте при command = install || command = ci || command = publish.

Выводит дополнительные сведения в консоль при выполнении задачи.


verbose - Подробное ведение журнала
boolean. Необязательный элемент. Используйте при command = install || command = publish.

Выводит дополнительные сведения в консоль при выполнении задачи.


customCommand - Команда и аргументы
string. Требуется при .command = custom

Выполняет пользовательскую команду. Например, dist-tag ls mypackage.


customRegistry - Используемые реестры
string. Необязательный элемент. Используйте при command = install || command = ci || command = custom. Допустимые значения: useNpmrc (Реестры в .npmrc) useFeed (Реестр, который я выбираю здесь). Значение по умолчанию: useNpmrc.

Указывает используемые реестры. .npmrc Зафиксируйте файл в репозитории исходного кода и задайте путь к нему в качестве значения или укажите в качестве значения реестр из Azure Artifacts.


customRegistry - Используемые реестры
string. Необязательный элемент. Используйте при command = install || command = custom. Допустимые значения: useNpmrc (Реестры в .npmrc) useFeed (Реестр, который я выбираю здесь). Значение по умолчанию: useNpmrc.

Указывает используемые реестры. .npmrc Зафиксируйте файл в репозитории исходного кода и задайте путь к нему в качестве значения или укажите в качестве значения реестр из Azure Artifacts.


customFeed - Использование пакетов из этого реестра Azure Artifacts/TFS
string. Требуется при .customRegistry = useFeed && command = install || command = ci || command = custom

Включает выбранный веб-канал в созданный .npmrc. Для веб-каналов в области проекта используйте ProjectName/FeedName или ProjectID/FeedID. Для веб-каналов уровня организации значением должно быть имя веб-канала.


customFeed - Использование пакетов из этого реестра Azure Artifacts/TFS
string. Требуется при .customRegistry = useFeed && command = install || command = custom

Включает выбранный веб-канал в созданный .npmrc. Для веб-каналов в области проекта используйте ProjectName/FeedName или ProjectID/FeedID. Для веб-каналов уровня организации значением должно быть имя веб-канала.


customEndpoint - Учетные данные для реестров за пределами этой организации или коллекции
string. Необязательный элемент. Используйте при customRegistry = useNpmrc && command = install || command = ci || command = custom.

Учетные данные, используемые для внешних реестров, расположенных в проекте .npmrc. Оставьте это поле пустым для реестров в этой учетной записи или коллекции; задача автоматически использует учетные данные сборки.


customEndpoint - Учетные данные для реестров за пределами этой организации или коллекции
string. Необязательный элемент. Используйте при customRegistry = useNpmrc && command = install || command = custom.

Учетные данные, используемые для внешних реестров, расположенных в проекте .npmrc. Оставьте это поле пустым для реестров в этой учетной записи или коллекции; задача автоматически использует учетные данные сборки.


customEndpoint - Учетные данные для реестров за пределами этой учетной записи или коллекции
string. Необязательный элемент. Используйте при customRegistry = useNpmrc && command = install || command = custom.

Учетные данные, используемые для внешних реестров, расположенных в проекте .npmrc. Оставьте это поле пустым для реестров в этой учетной записи или коллекции; задача автоматически использует учетные данные сборки.


publishRegistry - Расположение реестра
string. Необязательный элемент. Используйте при command = publish. Допустимые значения: useExternalRegistry (внешний реестр npm (включая другие учетные записи или коллекции)), useFeed (реестр, который я выбираю здесь). Значение по умолчанию: useExternalRegistry.

Указывает реестр, на который будет направлена команда.


publishFeed - Целевой реестр
string. Требуется при .publishRegistry = useFeed && command = publish

Указывает реестр, размещенный в учетной записи. Для выбора реестра здесь необходимо установить и лицензировать управление пакетами.


publishPackageMetadata - Публикация метаданных конвейера
boolean. Необязательный элемент. Используйте при command = publish && publishRegistry = useFeed && command = install || command = ci || command = publish. Значение по умолчанию: true.

Связывает метаданные конвейера сборки и выпуска (номер выполнения и сведения о исходном коде) с пакетом.


publishPackageMetadata - Публикация метаданных конвейера
boolean. Необязательный элемент. Используйте при command = publish && publishRegistry = useFeed && command = install || command = publish. Значение по умолчанию: true.

Связывает метаданные конвейера сборки и выпуска (данные о запуске и исходном коде) с пакетом.


publishEndpoint - Внешний реестр
string. Требуется, если publishRegistry = useExternalRegistry && command = publish.

Указывает учетные данные, используемые для публикации во внешнем реестре.


Параметры управления задачами

Помимо входных данных, все задачи имеют параметры управления. Дополнительные сведения см. в разделе Параметры управления и общие свойства задачи.

Выходные переменные

Нет.

Remarks

Примечание

Для публикации пакетов в веб-канале с помощью Azure Pipelines для службы сборки коллекции проектов и удостоверению службы сборки проекта необходимо задать значение Участник . Дополнительные сведения см. в разделе Добавление новых пользователей и групп .

Где можно изучить команды и аргументы npm?

Примеры

Требования

Требование Описание
Типы конвейеров YAML, классическая сборка, классический выпуск
Выполняется в Агент, DeploymentGroup
Требования Для выполнения заданий, использующих эту задачу, локальные агенты должны иметь возможности , соответствующие следующим требованиям : npm
Capabilities Эта задача не удовлетворяет требованиям для последующих задач в задании.
Ограничения команд Любой
Устанавливаемые переменные Любой
Версия агента 2.115.0 или более поздней версии
Категория задач Пакет
Требование Описание
Типы конвейеров YAML, классическая сборка, классический выпуск
Выполняется в Агент, DeploymentGroup
Требования Для выполнения заданий, использующих эту задачу, локальные агенты должны иметь возможности , соответствующие следующим требованиям : npm
Capabilities Эта задача не удовлетворяет требованиям для последующих задач в задании.
Ограничения команд Любой
Устанавливаемые переменные Любой
Версия агента 1.91.0 или более поздней версии
Категория задач Пакет