Criar e publicar um pacote de Node.js

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

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

Pré-requisitos

• Uma conta do GitHub onde você pode criar um repositório. Crie uma conta no GitHub gratuitamente.
• Uma organização Azure DevOps. Crie um gratuitamente.
• Um projeto de DevOps do Azure. Crie um usando o Assistente de Criação de Projeto do Azure DevOps.
• A capacidade de executar pipelines em agentes hospedados pela Microsoft. Você precisa solicitar a concessão gratuita de empregos paralelos ou comprar um trabalho paralelo.

Fork o código de exemplo

Fork o exemplo Express.js aplicativo de servidor.

1. Vá para o repositório js-e2e-express-server .
2. Selecione Forquilha no canto superior direito da página.
3. Selecione sua conta no GitHub. Por padrão, a bifurcação tem o mesmo nome que o repositório pai, mas você pode nomeá-la como algo 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 concluir o processo. Para obter mais informações, consulte Acesso a repositórios do GitHub.

Crie seu pipeline

YAML

1. Em seu projeto do Azure DevOps, selecione Pipelines>Create Pipeline e, em seguida, selecione GitHub como o local do seu código-fonte.
2. Na tela Selecione um repositório, selecione seu repositório de exemplo bifurcado.
3. Na tela Configurar seu pipeline, selecione Pipeline inicial. O Azure Pipelines gera um arquivo YAML chamado azure-pipelines.yml para seu pipeline.
4. Selecione o cursor suspenso ao lado de Salvar e executar, selecione Salvar e selecione Salvar novamente. O arquivo é salvo em seu repositório GitHub bifurcado.
5. Na tela seguinte, selecione Editar.

Crie o pacote e publique 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 pública para o diretório de preparo do artefato de compilação.

   • A tarefa de artefato de pipeline de publicação obtém os arquivos do local de preparação do artefato e os publica como artefatos a serem enviados com compilações de 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'
   

Execute seu pipeline

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

Após a execução do pipeline, verifique se a tarefa foi executada com êxito e se vê um artefacto publicado.

Clássico

1. Selecione GitHub como a fonte 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 na ordem. Para cada tarefa, selecione a + tarefa no Agente 1, selecione a tarefa à direita e selecione Adicionar e configure a tarefa, se necessário.

   1. npm

   2. npm

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

   3. Publicar resultados de teste

   4. Arquivar ficheiros

      • Pasta raiz ou arquivo a ser arquivado: $(System.DefaultWorkingDirectory)
      • Anexar o nome da pasta raiz aos caminhos de arquivamento: Desmarque

   5. Publicar artefatos de compilação

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

   

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

Próximos passos

Configurar JavaScript