Condividi tramite


Compilare e pubblicare un pacchetto Node.js

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

In questa guida introduttiva si usa una pipeline per creare un pacchetto Node.js con Node Gestione pacchetti (npm) e pubblicare un artefatto della pipeline. Si apprenderà come usare Azure Pipelines per compilare, distribuire e testare le app JavaScript.

Prerequisiti

Prodotto Requisiti
Azure DevOps - Un progetto Azure DevOps.
- La possibilità di eseguire pipeline su agenti ospitati da Microsoft. È possibile acquistare un incarico parallelo oppure richiedere un piano gratuito.
- Conoscenza di base di YAML e Azure Pipelines. Per maggiori informazioni, vedere Creare la prima pipeline.
Autorizzazioni - :
     - Per creare una pipeline, è necessario trovarsi nel gruppo Collaboratori e il gruppo deve avere l'autorizzazione Crea pipeline di compilazione impostata su Consenti. I membri del gruppo Project Administrators possono gestire le pipeline.
    - Per creare connessioni al servizio: è necessario disporre del ruolo di Administrator o Creator per le connessioni al servizio .
GitHub - Un account GitHub.
- Una connessione al servizio GitHub per autorizzare Azure Pipelines.
Azzurro Una sottoscrizione di Azure.
Prodotto Requisiti
Azure DevOps - Un progetto Azure DevOps.
- Agente autogestito. Per crearne uno, vedere la sezione su Agenti self-hosted.
- Conoscenza di base di YAML e Azure Pipelines. Per maggiori informazioni, vedere Creare la prima pipeline.
Autorizzazioni - :
    - Per creare una pipeline, è necessario trovarsi nel gruppo Collaboratori e il gruppo deve avere l'autorizzazione Crea pipeline di compilazione impostata su Consenti. I membri del gruppo Project Administrators possono gestire le pipeline.
    - Per creare connessioni al servizio: è necessario disporre del ruolo di Administrator o Creator per le connessioni al servizio .
GitHub - Un account GitHub.
- Una connessione al servizio GitHub per autorizzare Azure Pipelines.
Azzurro Una sottoscrizione di Azure.

Esegui un fork del codice di esempio

Effettuare un fork dell'app server di esempio Express.js.

  1. Vai al repository js-e2e-express-server.
  2. Selezionare Fork nell'angolo superiore destro della pagina.
  3. Selezionare l'account GitHub. Per impostazione predefinita, il fork ha lo stesso nome del repository padre, ma è possibile dargli un nome diverso.

Importante

Durante le procedure seguenti, potrebbe essere richiesto di creare una connessione al servizio GitHub o reindirizzare a GitHub per accedere, installare Azure Pipelines o autorizzare Azure Pipelines. Seguire le istruzioni visualizzate per completare il processo. Per altre informazioni, vedere Accedere ai repository GitHub.

Crea la tua pipeline

  1. Nel progetto Azure DevOps, selezionare Pipelines>Crea Pipeline e quindi selezionare GitHub come percorso del codice sorgente.
  2. Nella schermata Selezionare un repository, selezionare il repository di esempio creato tramite fork.
  3. Nella schermata Configura la pipeline, selezionare Pipeline di base. Azure Pipelines genera un file YAML denominato azure-pipelines.yml per la pipeline.
  4. Selezionare la freccia a discesa accanto a Salva ed esegui, selezionare Salva e quindi selezionare nuovamente Salva. Il file viene salvato nel tuo repository GitHub forkato.
  5. Nella schermata successiva selezionare Modifica.

Compilare il pacchetto e pubblicare un artefatto

Modificare il file azure-pipelines.yml come indicato di seguito.

  1. Sostituire il contenuto del file con il codice seguente. Il codice aggiorna l'attività dello strumento di installazione Node.js per utilizzare la versione 16 LTS di Node.js.

    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. Aggiungere le nuove attività seguenti alla pipeline:

    • L'attività copia file copia i file dalle cartelle src e public nella directory di staging dell'artefatto di compilazione.

    • L'attività pubblica artefatti della pipeline ottiene i file dalla posizione di staging dell'artefatto e li pubblica come artefatti da generare con le build 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'
    

Esegui la tua pipeline

Selezionare Convalida e salva, quindi Salva, selezionare Esegui e selezionare nuovamente Esegui.

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

Screenshot dell'esecuzione corretta della pipeline con un artefatto.

Congratulazioni, hai creato ed eseguito con successo una pipeline che ha compilato e testato un pacchetto Node.js. È possibile compilare, testare e distribuire app Node.js come parte del sistema di integrazione continua e recapito continuo (CI/CD) di Azure Pipelines.

Passaggi successivi