Avvio rapido: Usare Azure Pipelines per compilare e pubblicare un pacchetto Node.js

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

È possibile usare una pipeline di Azure DevOps per compilare, distribuire e testare app JavaScript.

Questa guida introduttiva illustra come usare una pipeline per creare un pacchetto Node.js con Node Gestione pacchetti (npm) e pubblicare un artefatto della pipeline.

Prerequisiti

In Azure DevOps devono essere presenti gli elementi seguenti:

• Un account GitHub in cui è possibile creare un repository. Crearne una gratuitamente.
• Un'organizzazione e un progetto di Azure DevOps. Crearne una gratuitamente.
• Possibilità di eseguire pipeline su agenti ospitati da Microsoft. È possibile acquistare un processo parallelo oppure richiedere un livello gratuito.

1 - Creare una copia tramite fork del codice di esempio

Creare una copia tramite fork dell'esempio seguente di app server Express.js in GitHub.

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

2 - Creare la pipeline

1. Accedere ad Azure Pipelines. Il browser passerà a https://dev.azure.com/my-organization-name e visualizzerà il dashboard di Azure DevOps.

2. Passare al progetto e selezionare Pipeline>Crea una nuova pipeline.

3. Selezionare GitHub come percorso del codice sorgente.

4. Se si viene reindirizzati a GitHub per accedere, immettere le credenziali di GitHub.

5. Quando viene visualizzato l'elenco dei repository, selezionare il repository di esempio Node.js.

6. Azure Pipelines analizza il codice nel repository e consiglia il Node.js modello per la pipeline. Selezionare il modello.

7. Azure Pipelines genera un file YAML per la pipeline. Selezionare Salva ed esegui>Commit direttamente nel ramo principale e quindi scegliere Salva ed esegui di nuovo.

8. Viene avviata una nuova esecuzione. Attendere il completamento dell'esecuzione.

Al termine, è disponibile un file YAML funzionante azure-pipelines.yml nel repository pronto per la personalizzazione.

3 - Compilare il pacchetto e pubblicare un artefatto

1. Modificare il file azure-pipelines.yml .

2. Aggiornare l'attività Programma di installazione strumenti Node.js per usare Node.js versione 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. Aggiungere nuove attività alla pipeline per copiare il pacchetto npm, package.json e pubblicare l'artefatto. L'attività Copia file copia i file dal percorso locale dell'agente in cui vengono scaricati i file del codice sorgente e salva i file in un percorso locale nell'agente in cui vengono copiati tutti gli artefatti prima di essere inseriti nella destinazione. Solo le src cartelle e public ottengono copie. L'attività Pubblica artefatto pipeline scarica i file dalle attività Copia file precedenti e li rende disponibili come artefatti della pipeline che verranno pubblicati con la compilazione della 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 - Eseguire la pipeline

Salvare ed eseguire la pipeline. Dopo l'esecuzione della pipeline, verificare che il processo sia stato eseguito correttamente e che venga visualizzato un artefatto pubblicato.

1. Creare una copia tramite fork del repository seguente in GitHub.

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

2. Dopo aver ottenuto il codice di esempio nel proprio repository, creare la prima pipeline e selezionare il modello Processo vuoto.

3. Selezionare Processo nella scheda Attività nell'editor della pipeline e modificare le proprietà come indicato di seguito:

   • Coda agente:Hosted Ubuntu Latest

4. Aggiungere le attività seguenti alla pipeline nell'ordine specificato:

   • npm

     • Comandoinstall:

   • npm

     • Nome visualizzatonpm test:
     • Comandocustom:
     • Comandi e argomenti:test

   • Pubblicare i risultati dei test

     • Lasciare tutti i valori predefiniti per le proprietà

   • Archivia file

     • Cartella radice o file da archiviare:$(System.DefaultWorkingDirectory)
     • Anteporre il nome della cartella radice ai percorsi di archiviazione: deselezionato

   • Pubblicare artefatti di compilazione

     • Lasciare tutti i valori predefiniti per le proprietà

5. Salvare la pipeline e accodare una compilazione per visualizzarla in azione.

Passaggi successivi

L'argomento avvio rapido è stato completato.

Configurare JavaScript