Npm@1 – tarefa npm v1

Use esta tarefa para instalar e publicar pacotes npm ou para executar um comando npm. Dá suporte a registros npmjs.com e autenticados, como o Azure Artifacts.

Observação

Para autenticar com feeds do Azure Artifacts, use a tarefa npm Authenticate . A Npm@1 tarefa não está mais em desenvolvimento ativo, apenas bugs críticos são resolvidos.

Sintaxe

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

Entradas

comando command -
string. Obrigatório Valores permitidos: ci, install, publish, custom. Valor padrão: install.

Especifica o comando e os argumentos, que são passados para npm para execução.

Se seus argumentos contiverem aspas duplas ("), escape-as com uma barra (\) e cerque a cadeia de caracteres escapada com aspas duplas (").

Por padrão, os pacotes são instalados localmente. Para instalar pacotes globalmente, especifique install -g como o comando. Para obter mais informações, consulte Baixar e instalar pacotes globalmente e Baixar e instalar pacotes localmente.

pasta de trabalho workingDir - que contém package.json
string.

Especifica o caminho para a pasta que contém os arquivos de package.json e .npmrc de destino. Selecione a pasta, não o arquivo. Exemplo: /packages/mypackage.

verbose - de registro em log detalhado
boolean. Opcional. Use quando command = install || command = ci || command = publish.

Imprime mais informações no console quando a tarefa é executada.

customCommand - comando e argumentos
string. Necessário quando command = custom.

Executa um comando personalizado. Exemplo: dist-tag ls mypackage.

customRegistry - Registros para usar
string. Opcional. Use quando command = install || command = ci || command = custom. Valores permitidos: useNpmrc (Registros no meu .npmrc), useFeed (Registro que seleciono aqui). Valor padrão: useNpmrc.

Especifica os registros a serem usados. Confirme um arquivo .npmrc no repositório de código-fonte e defina seu caminho como o valor ou especifique um registro do Azure Artifacts como o valor.

customFeed - Usar pacotes deste registro do Azure Artifacts/TFS
string. Necessário quando (command = install || command = ci || command = custom) && customRegistry = useFeed.

Inclui o feed selecionado no .npmrcgerado. Para feeds com escopo de projeto, use ProjectName/FeedName ou ProjectID/FeedID. Para feeds com escopo da organização, o valor deve ser o nome do feed.

credenciais customEndpoint - para registros fora desta organização/coleção
string. Opcional. Use quando (command = install || command = ci || command = custom) && customRegistry = useNpmrc.

Credenciais a serem usadas para registros externos localizados no .npmrcdo projeto. Deixe isso em branco para registros nesta conta/coleção; a tarefa usa as credenciais do build automaticamente.

de localização do Registro publishRegistry -
string. Opcional. Use quando command = publish. Valores permitidos: useExternalRegistry (Registro npm externo (incluindo outras contas/coleções)), useFeed (Registro que seleciono aqui). Valor padrão: useExternalRegistry.

Especifica o registro para o qual o comando será direcionado.

publishFeed - registro de destino
string. Necessário quando publishRegistry = useFeed && command = publish.

Especifica um registro hospedado na conta. Você deve ter o Gerenciamento de Pacotes instalado e licenciado para selecionar um registro aqui.

publishPackageMetadata - Publicar de metadados de pipeline
boolean. Opcional. Use quando command = publish && publishRegistry = useFeed. Valor padrão: true.

Associa os metadados do pipeline de build/versão (a execução # e as informações do código-fonte) ao pacote.

publishEndpoint - do Registro Externo
string. Necessário quando publishRegistry = useExternalRegistry && command = publish.

Especifica as credenciais a serem usadas para publicação em um registro externo.

Opções de controle de tarefa

Todas as tarefas têm opções de controle além das suas entradas de tarefas. Para obter mais informações, consulte as opções de Controle de e as propriedades comuns da tarefa.

Variáveis de saída

Nenhum.

Observações

Observação

O do Serviço de Compilação de Coleção de Projetos e a identidade do do Serviço de Build do projeto devem ser definidos como colaborador para publicar seus pacotes em um feed usando o Azure Pipelines. Consulte Adicionar novos usuários/grupos para obter mais detalhes.

Onde posso saber mais sobre os comandos npm listados?

• não me importo

• instalação do npm

• publicação npm

Exemplos

• Usar tarefas JavaScript

• Criar e publicar um pacote de Node.js

• Implantar aplicativos em VMs do Linux

Requisitos

Requisito	Descrição
Tipos de pipeline	YAML, build clássico, versão clássica
Execuções em	Agent, DeploymentGroup
de demandas	Os agentes auto-hospedados devem ter recursos que correspondam às seguintes demandas de para executar trabalhos que usam esta tarefa: npm
recursos	Essa tarefa não atende a nenhuma demanda para tarefas subsequentes no trabalho.
restrições de comando	Qualquer
variáveis settable	Qualquer
Versão do agente	2.115.0 ou superior
Categoria de tarefa	Pacote