Criar e publicar um pacote Node.js

Azure DevOps Services | Azure DevOps Server 2022 – Azure DevOps Server 2019

Neste início rápido, você usará um pipeline para criar um pacote Node.js com o Node Package Manager (npm) e publicar um artefato de pipeline. Você aprenderá a usar o Azure Pipelines para criar, implantar e testar seus aplicativos JavaScript.

Pré-requisitos

Produto	Requisitos
Azure DevOps	- Um projeto do Azure DevOps. – Capacidade de executar pipelines em agentes hospedados pela Microsoft. Você pode comprar um trabalho paralelo ou solicitar uma camada gratuita. – Conhecimento básico do YAML e do Azure Pipelines. Para obter mais informações, consulte Criar seu primeiro pipeline. - Permissões:      - Para criar um pipeline: você deve estar no grupo Colaboradores e o grupo precisa ter a permissão Criar pipeline de build definida como Permitir. Os membros do grupo Administradores do Projeto podem gerenciar pipelines.     – Para criar conexões de serviço: você deve ter a função Administrador ou Criador para conexões de serviço.
GitHub	- Uma conta do GitHub . – Uma conexão de serviço do GitHub para autorizar o Azure Pipelines.
Azul	Uma assinatura do Azure.

Bifurcar o código de exemplo

Bifurque o aplicativo de servidor de exemplo Express.js.

1. Vá para o repositório js-e2e-express-server .
2. Selecione Fork no canto superior direito da página.
3. Selecione sua conta do GitHub. Por padrão, a bifurcação tem o mesmo nome do repositório pai, mas você pode nomeá-la de forma diferente.

Importante

Durante os procedimentos a seguir, você pode ser solicitado a criar uma conexão de serviço do GitHub ou redirecionado para o GitHub para entrar, instalar o Azure Pipelines ou autorizar o Azure Pipelines. Siga as instruções na tela para efetuar o processo. Para obter mais informações, confira Acesso ao repositórios do GitHub.

Criar o pipeline

YAML

1. No projeto do Azure DevOps, selecione Pipelines>Create Pipeline e, em seguida, selecione GitHub como o local do código-fonte.
2. Na tela Selecionar um repositório, selecione o repositório de sua amostra bifurcado.
3. Na página Configurar seu pipeline, selecione Pipeline inicial. O Azure Pipelines gera um arquivo YAML chamado azure-pipelines.yml para o pipeline.
4. Selecione a seta para baixo ao lado de Salvar e executar, selecione Salvar e, em seguida, selecione Salvar novamente. O arquivo é salvo no repositório do GitHub bifurcado.
5. Na próxima tela, selecione Editar.

Compilar o pacote e publicar um artefato

Edite seu arquivo azure-pipelines.yml da seguinte maneira.

1. Substitua o conteúdo do arquivo pelo código a seguir. O código atualiza a tarefa do instalador da ferramenta Node.js para usar Node.js versão 16 LTS.

   trigger:
   - main
   
   pool:
     vmImage: 'ubuntu-latest'
   
   steps:
   - task: UseNode@1
     inputs:
       version: '16.x'
     displayName: 'Install Node.js'
   
   - script: |
       npm install
     displayName: 'npm install'
   
   - script: |
       npm run build
     displayName: 'npm build'
   
   - script: 
       npm test
     displayname: 'npm test'
   
   

2. Adicione as seguintes novas tarefas ao pipeline:

   • A tarefa copiar arquivos copia os arquivos das pastas src e public para o diretório de preparação do artefato de compilação.

   • A tarefa de publicação de artefato de pipeline obtém os arquivos do local de preparo dos artefatos e os publica como artefatos para serem incluídos nas compilações do pipeline.

   - task: CopyFiles@2
     inputs:
       sourceFolder: '$(Build.SourcesDirectory)'
       contents: |
          src/*
          public/*
       targetFolder: '$(Build.ArtifactStagingDirectory)'
     displayName: 'Copy project files'
   
   - task: PublishPipelineArtifact@1
     inputs:
       artifactName: e2e-server
       targetPath: '$(Build.ArtifactStagingDirectory)'
       publishLocation: 'pipeline'
     displayName: 'Publish npm artifact'
   

Executar seu pipeline

Selecione Validar e salvar, selecione Salvar, selecione Executar e selecione Executar novamente.

Depois que o pipeline for executado, verifique se o trabalho foi executado com êxito e se você vê um artefato publicado.

Clássico

1. Selecione GitHub como a origem do seu código.

2. Em Repositório, selecione o repositório bifurcado e selecione Continuar.

3. Selecione Pipeline vazio e selecione Aplicar.

4. Em Especificação do agente no painel direito, selecione ubuntu-latest.

5. No painel esquerdo, adicione as seguintes tarefas ao pipeline em ordem. Para cada tarefa, selecione o + no trabalho de Agente 1, escolha a tarefa à direita, clique em Adicionar, e configure a tarefa, se necessário.

   1. npm

   2. npm

      • Nome de exibição:teste npm
      • Comando:personalizado
      • Comando e argumentos:teste

   3. Publicar resultados de teste

   4. Arquivos de Arquivo

      • Pasta raiz ou arquivo a ser arquivado:$(System.DefaultWorkingDirectory)
      • Prefixar o nome da pasta raiz aos caminhos da camada de arquivos: Desmarcar

   5. Publicar artefatos de compilação

6. Selecione Salvar & colocar na fila e, em seguida, selecione Salvar e executar.

   

Parabéns, você criou e executou com êxito um pipeline que criou e testou um pacote Node.js. Você pode criar, testar e implantar aplicativos Node.js como parte do sistema de CI/CD (integração contínua e entrega contínua) do Azure Pipelines.

Próximas etapas

Configurar JavaScript