Início Rápido – Usar o Azure Pipelines para criar e publicar um pacote de Node.js

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

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 Node.js com o NPM (Gerenciador de Pacotes de Nó) e publicar um artefato de pipeline.

Pré-requisitos

Você deve ter os seguintes itens no Azure DevOps:

• Uma conta do GitHub, na qual você pode criar um repositório. Crie um gratuitamente.
• Uma organização e um projeto do Azure DevOps. Crie um gratuitamente.
• Uma capacidade de executar pipelines em agentes hospedados pela Microsoft. Você pode comprar um trabalho paralelo ou solicitar uma camada gratuita.

O YAML não está disponível para o TFS 2018.

1 – Bifurcar o código de exemplo

Bifurque o exemplo a seguir Express.js aplicativo de servidor no GitHub.

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

2 – Criar seu pipeline

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

2. Acesse seu projeto e selecione Pipelines>Criar um novo pipeline.

3. Selecione o GitHub como o local do 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 Node.js repositório de exemplo.

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

7. O Azure Pipelines gera um arquivo YAML para o pipeline. Selecione Salvar e executar>Confirmar diretamente no branch principal e escolha Salvar e executar novamente.

8. Uma nova execução é iniciada. Aguarde a conclusão da execução.

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

1. Crie um pipeline e selecione o modelo YAML .

2. Defina o pool de agentes e o caminho do arquivo YAML para o pipeline.

3. Salve o pipeline e enfileira um build. Quando a mensagem Build #nnnnnnnn.n for exibida na fila , selecione o link de número para ver o pipeline em ação.

3 – Criar seu pacote e publicar um artefato

1. Edite seu arquivo azure-pipelines.yml .

2. Atualize a tarefaNode.js Tool Installer para usar Node.js versão 16 LTS.

   trigger:
   - main
   
   pool:
     vmImage: 'ubuntu-latest'
   
   steps:
   - task: NodeTool@0
     inputs:
       versionSpec: '16.x'
     displayName: 'Install Node.js'
   
   - script: |
       npm install
     displayName: 'npm install'
   
   - script: |
       npm run build
     displayName: 'npm build'
   

3. Adicione novas tarefas ao pipeline para copiar seu pacote npm, package.json e publicar seu artefato. A tarefa Copiar Arquivos copia arquivos do caminho local no agente no qual os arquivos de código-fonte são baixados e salva arquivos em um caminho local no agente para o qual todos os artefatos são copiados antes de serem enviados para o destino. Esses arquivos são salvos em uma pasta npm . Atarefa Artefato de Pipeline de Publicação de artefatos de pipeline, baixa os arquivos das tarefas anteriores dos Arquivos de Cópia e os disponibiliza como artefatos de pipeline que serão publicados com seu build de pipeline.

   - task: CopyFiles@2
     inputs:
       sourceFolder: '$(Build.SourcesDirectory)'
       contents: '*.tgz' 
       targetFolder: $(Build.ArtifactStagingDirectory)/npm
     displayName: 'Copy npm package'
   
   - task: CopyFiles@2
     inputs:
       sourceFolder: '$(Build.SourcesDirectory)'
       contents: 'package.json' 
       targetFolder: $(Build.ArtifactStagingDirectory)/npm
     displayName: 'Copy package.json'   
   
   - task: PublishPipelineArtifact@1
     inputs:
       targetPath: '$(Build.ArtifactStagingDirectory)/npm'
       artifactName: npm
     displayName: 'Publish npm artifact'
   

4 – Executar seu pipeline

Salve e execute seu pipeline. Após a execução do pipeline, verifique se o trabalho foi executado com êxito e se você vê um artefato publicado.

1. Bifurque o repositório a seguir 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 Processo na guia Tarefas no editor de pipeline e altere as propriedades da seguinte maneira:

   • Fila do agente:Hosted Ubuntu 1604

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

   • npm

     • Comando:install

   • npm

     • Nome de exibição de:npm test
     • Comando:custom
     • Comando e argumentos:test

   • Publicar resultados do teste

     • Deixe todos os valores padrão para propriedades

   • Arquivar arquivos

     • Pasta raiz ou arquivo a ser arquivado:$(System.DefaultWorkingDirectory)
     • Preenviar o nome da pasta raiz para arquivar caminhos: Desmarcada

   • Publicar artefatos de build

     • Deixe todos os valores padrão para propriedades

5. Salve o pipeline e enfileira um build para vê-lo em ação.

Próximas etapas

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

Configurar JavaScript