Condividi tramite

Integrare attività personalizzate della pipeline di compilazione con estensioni

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

Utilizza questo riferimento quando desideri creare e integrare attività personalizzate della pipeline di compilazione con estensioni in Azure DevOps.

Suggerimento

Vedere la documentazione più recente sullo sviluppo di estensioni con Azure DevOps Extension SDK.

Attività personalizzate

Le attività sono gli elementi fondamentali per definire l'automazione in una pipeline di compilazione o rilascio. Per altre informazioni, vedere Tipi di attività e utilizzo.

Sono disponibili molte attività predefinite per abilitare scenari di compilazione e distribuzione fondamentali. È consigliabile esaminare questi scenari prima di crearne uno personalizzato. Se le attività esistenti non soddisfano le proprie esigenze, è possibile compilare un'attività personalizzata.

JSON dell'attività di build personalizzata

Quando si crea un'attività di compilazione o versione personalizzata con un'estensione, l'estensione include un file task.json per ogni attività di compilazione o versione. Il file task.json descrive l'attività di compilazione o versione. Il sistema di compilazione lo usa per eseguire il rendering delle opzioni di configurazione all'utente e per sapere quali script eseguire in fase di compilazione.

Per altre informazioni, vedere la documentazione relativa all'SDK dell'attività di compilazione e rilascio in GitHub. In particolare, si potrebbe essere interessati allo schema ditask.json.

Aggregare più versioni di attività di compilazione o rilascio all'interno di un'unica estensione

È possibile includere più versioni di un'attività di compilazione o rilascio all'interno dell'estensione. Implementare versioni future dell'estensione senza interrompere il servizio degli utenti nelle versioni precedenti. Le informazioni seguenti illustrano il layout per avere più versioni in un'unica estensione.

Layout di estensione tradizionale

  • extensionManifest.json
  • extensionIcon.png
  • Attività1
    • task.json
    • icon.png
    • taskScript.ps1

Annotazioni

Quando si configura un'icona dell'attività, verificare che quanto segue sia corretto.

  • Il nome dell'icona è icon.png
  • La dimensione dell'icona è 32x32 pixel
  • L'icona si trova nella stessa posizione del file task.json

Layout di più versioni

Annotazioni

Il codice cerca il file task.json all'interno della cartella dell'attività e poi a un livello inferiore. Se non viene trovato in nessuno dei due livelli, viene visualizzato un messaggio di errore.

  • extensionManifest.json
  • extensionIcon.png
  • Attività1
    • Compito1V1
      • task.json
      • icon.png
      • taskScript.ps1
    • Attività1V2
      • task.json
      • icon.png
      • taskScript.ps1
  • Attività2
    • Compito2V1
      • task.json
      • icon.png
      • taskScript.ps1
    • Compito2V2
      • task.json
      • icon.png
      • taskScript.ps1

Suggerimento

Per assicurarsi che la cartella _build/Tasks/ssrsfilesdeploy contenga il contenuto V1 e V2, impostare matchCopy(item, srcPath, destPath, { noRecurse: su false nel file make-util.js.

Contenuti correlati