Informazioni di riferimento: integrare attività di compilazione personalizzate nelle estensioni

  • Articolo

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

Usare questo riferimento quando si vogliono creare e integrare attività della pipeline di compilazione personalizzate 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 i blocchi predefiniti per definire l'automazione in una pipeline di compilazione o versione. 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 compilazione personalizzata

Quando si crea un'attività di compilazione o versione personalizzata con un'estensione, l'estensione include un task.json file per ogni attività di compilazione o rilascio. Il task.json file descrive l'attività di compilazione o rilascio. 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.

La documentazione dell'SDK dell'attività di compilazione/versione è disponibile in GitHub. In particolare, si potrebbe essere interessati allo schema task.json.

Aggregare più versioni delle attività di compilazione/rilascio in 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

Nota

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

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

Layout di più versioni

Nota

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

  • extensionManifest.json
  • extensionIcon.png
  • Attività1
    • Task1V1
      • task.json
      • icon.png
      • taskScript.ps1
    • Task1V2
      • task.json
      • icon.png
      • taskScript.ps1
  • Task2
    • Task2V1
      • task.json
      • icon.png
      • taskScript.ps1
    • Task2V2
      • task.json
      • icon.png
      • taskScript.ps1

Suggerimento

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