Referenz – Integrieren von benutzerdefinierten Buildaufgaben in Erweiterungen

  • Artikel

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

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. Wir bieten viele integrierte Aufgaben , um grundlegende Build- und Bereitstellungsszenarien zu ermöglichen. Es wird empfohlen, diese Szenarien vor dem Erstellen eigener Szenarien zu überprüfen. Wenn die vorhandenen Aufgaben Ihre Anforderungen nicht erfüllen, können Sie eine benutzerdefinierte Aufgabe erstellen.

JSON der benutzerdefinierten Buildaufgabe

Wenn Sie eine benutzerdefinierte Build- oder Freigabeaufgabe mit einer Erweiterung erstellen, enthält die Erweiterung eine task.json Datei für jeden Build- oder Freigabevorgang. Die task.json Datei beschreibt die Build- oder Freigabeaufgabe. Das Buildsystem verwendet es, um Konfigurationsoptionen für den Benutzer zu rendern und zu wissen, welche Skripts zur Erstellungszeit ausgeführt werden sollen.

Die Build/Release Task SDK-Dokumentation befindet sich auf GitHub. Insbesondere interessieren Sie sich für das task.json Schema.

Bündeln mehrerer Versionen von Build-/Releaseaufgaben innerhalb einer Erweiterung

Sie können mehrere Versionen einer Build- oder Freigabeaufgabe in Ihre Erweiterung einschließen. Bereitstellen zukünftiger Versionen Ihrer Erweiterung, ohne den Dienst von Benutzern in älteren Versionen zu unterbrechen. Die folgenden Informationen zeigen das Layout für mehrere Versionen in einer Erweiterung.

Herkömmliches Erweiterungslayout

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

Hinweis

Stellen Sie beim Einrichten eines Aufgabensymbols sicher, dass Folgendes zutrifft.

  • Der Symbolname ist icon.png
  • Die Symbolgröße beträgt 32 x 32 Pixel.
  • Das Symbol befindet sich am gleichen Speicherort wie die task.json Datei.

Layout mehrerer Versionen

Hinweis

Der Code sucht nach der task.json Datei innerhalb des Aufgabenordners und dann eine Ebene tiefer. Wenn eine in beiden Ebenen nicht gefunden wird, wird eine Fehlermeldung angezeigt.

  • extensionManifest.json
  • extensionIcon.png
  • Vorgang 1
    • Task1V1
      • task.json
      • icon.png
      • taskScript.ps1
    • Task1V2
      • task.json
      • icon.png
      • taskScript.ps1
  • Vorgang2
    • Task2V1
      • task.json
      • icon.png
      • taskScript.ps1
    • Task2V2
      • task.json
      • icon.png
      • taskScript.ps1

Tipp

Um sicherzustellen, dass der _build/Tasks/ssrsfilesdeploy Ordner die V1- und V2-Inhalte enthält, legen Sie sie in der make-util.js Datei fest matchCopy(item, srcPath, destPath, { noRecurse:false.