Dela via


Integrera uppgifter för anpassad bygg-pipeline med tillägg

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022 | Azure DevOps Server 2020

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

Tips/Råd

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. Mer information finns i Aktivitetstyper och användning.

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 bygguppgift

När du skapar en anpassad bygg- eller lanseringsuppgift med ett tillägg innehåller tillägget en task.json fil för varje bygg- eller versionsuppgift. Den task.json filen 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.

Mer information finns i SDK-dokumentationen för bygg- och lanseringsuppgifter på GitHub. Mer specifikt kanske du är intresserad av task.json-schemat.

Paketera flera versioner av bygg- eller versionsuppgifter 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 utvidgningslayout

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

Anmärkning

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

  • Ikonens namn är icon.png
  • Ikonstorleken är 32 x 32 bildpunkter
  • Ikonen finns på samma plats som den task.json filen

Layout för flera versioner

Anmärkning

Koden letar efter den task.json filen i uppgiftsmapparappen 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

Tips/Råd

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