Partilhar via

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 de Artefatos do Azure, 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.

Insumos

command - de comando
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 envolva a cadeia de caracteres 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 Download e instalação de pacotes globalmente e Download e instalação de pacotes localmente.


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

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


verbose - de registro 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 - Registos a utilizar
string. Opcional. Use quando command = install || command = ci || command = custom. Valores permitidos: useNpmrc (Registos no meu .npmrc), useFeed (Registo que seleciono aqui). Valor padrão: useNpmrc.

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


customFeed - Usar pacotes deste de 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.


customEndpoint - Credenciais 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 este espaço em branco para os registos desta conta/coleção; A tarefa usa as credenciais da compilação automaticamente.


publishRegistry - Local do Registro
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 que o comando terá como destino.


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 metadados de pipeline
boolean. Opcional. Use quando command = publish && publishRegistry = useFeed. Valor padrão: true.

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


publishEndpoint - Registo 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 controlo de tarefas

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

Variáveis de saída

Nenhum.

Observações

Observação

O do Serviço de Compilação da Coleção de Projetos e a identidade do Serviço de Criação de do seu projeto devem ser definidos como de 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?

Exemplos

Requerimentos

Requisito Descrição
Tipos de pipeline YAML, Construção clássica, Versão clássica
Funciona em Agente, DeploymentGroup
Exigências Os agentes auto-hospedados devem ter recursos que correspondam às seguintes demandas executar trabalhos que usam essa tarefa: npm
Capacidades Esta tarefa não satisfaz quaisquer exigências para tarefas subsequentes no trabalho.
Restrições de comando Qualquer
Variáveis configuráveis Qualquer
Versão do agente 2.115.0 ou superior
Categoria de tarefa Embalagem
  • Last updated on