Примечание
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Используйте эту задачу для установки и публикации пакетов 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
, , install
publish
custom
. Значение по умолчанию: 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 или более поздней версии |
Категория задач | Пакет |