Guia de início rápido - Usar o Azure Pipelines para criar e publicar um pacote de Node.js

Serviços de DevOps do Azure | Azure DevOps Server 2022 - Azure DevOps Server 2019

Você pode usar um pipeline do Azure DevOps para criar, implantar e testar aplicativos JavaScript.

Este guia de início rápido explica como usar um pipeline para criar um pacote de Node.js com o Gerenciador de Pacotes de Nó (npm) e publicar um artefato de pipeline.

Pré-requisitos

Você deve ter os seguintes itens no Azure DevOps:

• Uma conta do GitHub onde você pode criar um repositório. Crie um gratuitamente.
• Uma organização e um projeto do Azure DevOps. Crie um gratuitamente.
• Capacidade de executar pipelines em agentes hospedados pela Microsoft. Você pode comprar um trabalho paralelo ou solicitar um nível gratuito.

1 – Bifurcar o código de exemplo

Bifurque a aplicação de servidor Express.js de exemplo seguinte no GitHub.

https://github.com/Azure-Samples/js-e2e-express-server

2 - Crie seu pipeline

1. Entre no Azure Pipelines. Seu navegador irá e https://dev.azure.com/my-organization-name exibirá seu painel do Azure DevOps.

2. Vá para o seu projeto e selecione Pipelines>Criar um novo pipeline.

3. Selecione GitHub como o local do seu código-fonte.

4. Se você for redirecionado para o GitHub para entrar, insira suas credenciais do GitHub.

5. Quando a lista de repositórios for exibida, selecione seu repositório de exemplo Node.js.

6. O Azure Pipelines analisa o código em seu repositório e recomenda o Node.js modelo para seu pipeline. Selecione esse modelo.

7. O Azure Pipelines gera um arquivo YAML para seu pipeline. Selecione Salvar e executar>Confirmar diretamente na ramificação principal e, em seguida, escolha Salvar e executar novamente.

8. Uma nova corrida começa. Aguarde a conclusão da execução.

Quando terminar, você terá um arquivo YAML em funcionamento azure-pipelines.yml em seu repositório pronto para personalizar.

3 - Construa seu pacote e publique um artefato

1. Edite seu arquivo azure-pipelines.yml .

2. Atualize a tarefa Node.js Tool Installer para usar o 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'
   

3. Adicione novas tarefas ao seu pipeline para copiar seu pacote npm, package.json e publicar seu artefato. A tarefa Copiar arquivos copia arquivos do caminho local no agente onde os arquivos de código-fonte são baixados e salva os arquivos em um caminho local no agente para o qual todos os artefatos são copiados antes de serem enviados por push para o destino. Apenas as src pastas e public recebem cópias. A tarefa Publicar Artefato de Pipeline baixa os arquivos das tarefas anteriores de Copiar Arquivos e os disponibiliza como artefatos de pipeline que serão publicados com sua compilação 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'
   

4 - Execute seu pipeline

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

1. Fork o seguinte repo no GitHub.

   https://github.com/Azure-Samples/js-e2e-express-server
   

2. Depois de ter o código de exemplo em seu próprio repositório, crie seu primeiro pipeline e selecione o modelo de processo vazio.

3. Selecione Processar na guia Tarefas no editor de pipeline e altere as propriedades da seguinte maneira:

   • Fila de agentes:Hosted Ubuntu Latest

4. Adicione as seguintes tarefas ao pipeline na ordem especificada:

   • npm

     • Comando:install

   • npm

     • Nome a apresentarnpm test:
     • Comando:custom
     • Comando e argumentos:test

   • Publicar resultados de teste

     • Deixe todos os valores padrão para propriedades

   • Arquivar Ficheiros

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

   • Publicar artefatos de compilação

     • Deixe todos os valores padrão para propriedades

5. Salve o pipeline e enfileire uma compilação para vê-la em ação.

Próximos passos

Parabéns, você concluiu com sucesso este início rápido!

Configurar JavaScript