Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Используйте эту задачу для установки и публикации пакетов npm или выполнения команды npm. Поддерживает npmjs.com и прошедшие проверку подлинности реестры, такие как Артефакты Azure.
Примечание.
Чтобы пройти проверку подлинности с помощью веб-каналов Артефактов Azure, используйте задачу проверки подлинности npm . Задача Npm@1 больше не находится в активной разработке, устраняются только критические ошибки.
Синтаксис
# 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.
Входные данные
Команда 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 или более поздней версии |
| Категория задач | Пакет |