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.

Captura de tela da execução bem-sucedida do pipeline com um artefato.

  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!