Dela via

Referens – integrera anpassade bygguppgifter i tillägg

  • Artikel

Azure DevOps Services | Azure DevOps Server 2022 – Azure DevOps Server 2019

Använd den här referensen när du vill skapa och integrera anpassade bygg-pipelineuppgifter med tillägg i Azure DevOps.

Dricks

Läs vår senaste dokumentation om tilläggsutveckling med hjälp av Azure DevOps Extension SDK.

Anpassade uppgifter

Uppgifter är byggstenarna för att definiera automatisering i en bygg- eller versionspipeline. Vi erbjuder många inbyggda uppgifter för att möjliggöra grundläggande bygg- och distributionsscenarier. Vi rekommenderar att du granskar dessa scenarier innan du skapar egna. Om de befintliga aktiviteterna inte uppfyller dina behov kan du skapa en anpassad uppgift.

JSON för anpassad build-uppgift

När du skapar en anpassad bygg- eller versionsuppgift med ett tillägg innehåller tillägget en task.json fil för varje bygg- eller versionsuppgift. Filen task.json beskriver bygg- eller versionsuppgiften. Byggsystemet använder det för att återge konfigurationsalternativ till användaren och för att veta vilka skript som ska köras vid bygget.

SDK-dokumentationen för build/release-uppgiften finns på GitHub. Mer specifikt kan du vara intresserad av task.json-schemat.

Paketering av flera versioner av bygg-/versionsaktiviteter i ett tillägg

Du kan inkludera flera versioner av en bygg- eller versionsuppgift i tillägget. Distribuera framtida versioner av tillägget utan att avbryta tjänsten för användare i äldre versioner. Följande information visar layouten för att ha flera versioner i ett tillägg.

Traditionell tilläggslayout

  • extensionManifest.json
  • extensionIcon.png
  • Uppgift 1
    • task.json
    • Icon.png
    • taskScript.ps1

Kommentar

När du konfigurerar en aktivitetsikon kontrollerar du att följande är sant.

  • Ikonnamnet är icon.png
  • Ikonstorleken är 32 x 32 bildpunkter
  • Ikonen är på samma plats som task.json filen

Layout för flera versioner

Kommentar

Koden söker task.json efter filen i aktivitetsmappen och sedan en nivå djupare. Om en inte hittas på någon av nivåerna visas ett felmeddelande.

  • extensionManifest.json
  • extensionIcon.png
  • Uppgift 1
    • Uppgift 1V1
      • task.json
      • Icon.png
      • taskScript.ps1
    • Uppgift 1V2
      • task.json
      • Icon.png
      • taskScript.ps1
  • Uppgift 2
    • Uppgift2V1
      • task.json
      • Icon.png
      • taskScript.ps1
    • Uppgift2V2
      • task.json
      • Icon.png
      • taskScript.ps1

Dricks

För att säkerställa att _build/Tasks/ssrsfilesdeploy mappen innehåller V1- och V2-innehållet anger du matchCopy(item, srcPath, destPath, { noRecurse: till false i make-util.js filen.