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


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

Используйте эту задачу для установки и публикации пакетов npm или выполнения команды npm.

Примечание.

Чтобы пройти проверку подлинности с помощью веб-каналов Артефактов Azure, используйте задачу проверки подлинности npm . Задача Npm@1 больше не находится в активной разработке, устраняются только критические ошибки.

Синтаксис

# npm v1
# Install and publish npm packages, or run an npm command.
- 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.

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

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

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

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

По умолчанию пакеты устанавливаются локально. Чтобы установить пакеты глобально, укажите install -g в качестве команды. Дополнительные сведения см. в статье Скачивание и установка пакетов глобально и загрузке и установке пакетов локально.


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

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


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

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


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

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


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

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


customFeed - Использовать пакеты из этого реестра Артефактов Azure или TFS
string. Требуется, если (command = install || command = ci || command = custom) && customRegistry = useFeed.

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


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

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


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

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


publishFeed - целевого реестра
string. Требуется, если publishRegistry = useFeed && command = publish.

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


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

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


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

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


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

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

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

Нет.

Замечания

Примечание.

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

Где можно узнать больше о перечисленных командах npm?

Примеры

Требования

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