Publicar pacotes npm com o Azure Pipelines (YAML/Clássico)

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Com o Azure Pipelines, você pode publicar seus pacotes npm em feeds do Azure Artifacts e registros públicos como npmjs.com. Este artigo guiará você pela publicação de seus pacotes npm usando pipelines YAML e Clássico.

Pré-requisitos

• Uma organização do Azure DevOps. Crie um gratuitamente.

• Um projeto do Azure DevOps. Crie um projeto se ainda não tiver um.

• Um feed do Azure Artifacts. Crie um gratuitamente.

Publicar em feeds do Azure Artifacts

Observação

Para publicar seus pacotes em um feed usando o Azure Pipelines, certifique-se de que o Serviço de Compilação de Coleção de Projetos e a identidade do Serviço de Compilação do seu projeto sejam configurados como um Editor de Feed (Colaborador). Confira Adicionar novos usuários/grupos para obter mais detalhes.

YAML

- task: Npm@1
  inputs:
    command: publish
    publishRegistry: useFeed
    publishFeed: <FEED_NAME>        ## For project-scoped feeds, use: <PROJECT_NAME>/<FEED_NAME> 

• publishRegistry: selecione useFeed para usar um feed em sua organização. Opções: useExternalRegistry, useFeed
• publishFeed: o feed no qual você deseja publicar. Obrigatório quando publishRegistry = useFeed.

Dica

Ao adicionar a tarefa npm ao pipeline YAML usando o editor YAML, as IDs de projeto e e feed para seu publishFeed serão geradas automaticamente.

Clássico

1. Navegue até o portal do Azure DevOps e selecione seu projeto.

2. Selecione Pipelines e, em seguida, selecione a definição do pipeline.

3. Selecione Editar e, em seguida, selecione o sinal + para adicionar uma nova tarefa. Pesquise pela tarefa npm e selecione Adicionar para adicioná-la ao pipeline.

   

4. Dê um nome à tarefa e selecione Publicar no menu suspenso de comandos. Especifique o caminho de package.json, a localização do Registro e o Registro de destino.

   • Pasta de trabalho que contém package.json: caminho para a pasta que contém os arquivos package.json e .npmrc de destino. Deixe isso em branco se esses arquivos estiverem na raiz do repositório.
   • Localização do Registro: selecione Registro que eu seleciono aqui para publicar em um feed.
   • Registro de destino: selecione seu feed no menu suspenso.

   

Publicar em um Registro público

Antes de publicar seus pacotes em um Registro npm público, como npmjs.com, primeiro crie uma conexão de serviço para se autenticar no serviço externo desejado.

1. Entre na sua organização do Azure DevOps e navegue até seu projeto.

2. Selecione Configurações do projeto>Conexões de serviço e selecione Criar conexão de serviço.

   

3. Selecione npm e selecione Avançar. Preencha os campos necessários e selecione Salvar quando terminar.

YAML

- task: Npm@1
  inputs:
    command: publish
    publishRegistry: useExternalRegistry
    publishEndpoint: '<NAME_OF_YOUR_SERVICE_CONNECTION>'

• publishRegistry: selecione useExternalRegistry para publicar em um registro público. Opções: useExternalRegistry | useFeed.
• publishEndpoint: substitua o espaço reservado pelo nome da conexão de serviço que você criou anteriormente. necessário quando publishRegistry == useExternalRegistry.

Clássico

1. Navegue até o portal do Azure DevOps e selecione seu projeto.

2. Selecione Pipelines e, em seguida, selecione a definição do pipeline.

3. Selecione Editar e, em seguida, selecione o sinal + para adicionar uma nova tarefa. Pesquise pela tarefa npm e selecione Adicionar para adicioná-la ao pipeline.

   

4. Dê um nome à tarefa e selecione Publicar no menu suspenso de comandos. Especifique o caminho de package.json, a localização do Registro e o Registro externo.

   • Pasta de trabalho que contém package.json: caminho para a pasta que contém os arquivos package.json e .npmrc de destino. Deixe isso em branco se esses arquivos estiverem na raiz do repositório.
   • Localização do Registro: selecione Registro npm externo para publicar em um Registro público, como npmjs.com.
   • Registro externo: selecione a conexão de serviço criada anteriormente.

   

Artigos relacionados

• Publique e restaure pacotes npm na linha de comando.
• Use pacotes de npmjs.com.
• Publique e baixe artefatos de pipeline.