Freigeben über


Integrieren von benutzerdefinierten Buildpipelineaufgaben mit Erweiterungen

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

Verwenden Sie diese Referenz, wenn Sie benutzerdefinierte Buildpipelineaufgaben mit Erweiterungen in Azure DevOps erstellen und integrieren möchten.

Tipp

Sehen Sie sich unsere neueste Dokumentation zur Erweiterungsentwicklung mithilfe des Azure DevOps-Erweiterungs-SDK an.

Benutzerdefinierte Aufgaben

Aufgaben sind die Bausteine zum Definieren der Automatisierung in einer Build- oder Releasepipeline. Weitere Informationen finden Sie unter Aufgabentypen und -verwendung.

Wir bieten viele integrierte Aufgaben , um grundlegende Build- und Bereitstellungsszenarien zu ermöglichen. Es wird empfohlen, dass Sie diese Szenarien überprüfen, bevor Sie eigene Szenarien erstellen. Wenn die vorhandenen Aufgaben nicht Ihren Anforderungen entsprechen, können Sie eine benutzerdefinierte Aufgabe erstellen.

JSON für benutzerdefinierte Buildaufgaben

Wenn Sie eine benutzerdefinierte Build- oder Releaseaufgabe mit einer Erweiterung erstellen, enthält Ihre Erweiterung eine task.json Datei für jede Build- oder Releaseaufgabe. Die task.json Datei beschreibt die Build- oder Releaseaufgabe. Das Build-System verwendet sie, um Konfigurationsoptionen für den Benutzer zu rendern und um zu wissen, welche Skripts zur Build-Zeit ausgeführt werden sollen.

Weitere Informationen finden Sie in der SDK-Dokumentation für Build- und Releaseaufgaben auf GitHub. Insbesondere könnten Sie an dem task.json Schema interessiert sein.

Bündeln mehrerer Versionen von Build- oder Releaseaufgaben in einer Erweiterung

Sie können mehrere Versionen einer Build- oder Releaseaufgabe in Ihre Erweiterung einschließen. Führen Sie zukünftige Versionen Ihrer Erweiterung ein, ohne den Service für Benutzer älterer Versionen zu unterbrechen. Die folgenden Informationen zeigen das Layout für mehrere Versionen in einer Erweiterung.

Traditionelles Erweiterungslayout

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

Hinweis

Wenn Sie ein Aufgabensymbol einrichten, stellen Sie sicher, dass Folgendes zutrifft.

  • Der Name des Symbols lautet icon.png
  • Die Größe des Symbols beträgt 32x32 Pixel
  • Das Symbol befindet sich an derselben Stelle wie die task.json Datei

Layout mehrerer Versionen

Hinweis

Der Code sucht nach der task.json Datei im Aufgabenordner und dann eine Ebene tiefer. Wenn in keiner der beiden Ebenen eine gefunden wird, wird eine Fehlermeldung angezeigt.

  • extensionManifest.json
  • extensionIcon.png
  • Aufgabe 1
    • Aufgabe1V1
      • task.json
      • icon.png
      • taskScript.ps1
    • Aufgabe1V2
      • task.json
      • icon.png
      • taskScript.ps1
  • Aufgabe 2
    • Aufgabe2V1
      • task.json
      • icon.png
      • taskScript.ps1
    • Aufgabe2V2
      • task.json
      • icon.png
      • taskScript.ps1

Tipp

Um sicherzustellen, dass der Ordner _build/Tasks/ssrsfilesdeploy den Inhalt von V1 und V2 enthält, der in der matchCopy(item, srcPath, destPath, { noRecurse: Datei auf festgelegt ist false.