Dokumentacja — integrowanie niestandardowych zadań kompilacji z rozszerzeniami

  • Artykuł

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

Użyj tej dokumentacji, jeśli chcesz utworzyć i zintegrować niestandardowe zadania potoku kompilacji z rozszerzeniami w usłudze Azure DevOps.

Napiwek

Zapoznaj się z naszą najnowszą dokumentacją dotyczącą programowania rozszerzeń przy użyciu zestawu SDK rozszerzenia usługi Azure DevOps.

Zadania niestandardowe

Zadania to bloki konstrukcyjne służące do definiowania automatyzacji w potoku kompilacji lub wydania. Oferujemy wiele wbudowanych zadań umożliwiających podstawowe scenariusze kompilacji i wdrażania. Zalecamy przejrzenie tych scenariuszy przed utworzeniem własnego. Jeśli istniejące zadania nie spełniają Twoich potrzeb, możesz utworzyć zadanie niestandardowe.

Niestandardowy kod JSON zadania kompilacji

Podczas tworzenia niestandardowego zadania kompilacji lub wydania z rozszerzeniem rozszerzenie zawiera task.json plik dla każdego zadania kompilacji lub wydania. Plik task.json opisuje zadanie kompilacji lub wydania. System kompilacji używa go do renderowania opcji konfiguracji dla użytkownika i dowiedzieć się, które skrypty do wykonania w czasie kompilacji.

Dokumentacja zestawu SDK zadań kompilacji/wydania znajduje się w witrynie GitHub. W szczególności możesz zainteresować się schematem task.json.

Łączenie wielu wersji zadań kompilacji/wydania w ramach jednego rozszerzenia

W ramach rozszerzenia można uwzględnić wiele wersji zadania kompilacji lub wydania. Wdrażanie przyszłych wersji rozszerzenia bez przerywania obsługi użytkowników w starszych wersjach. Poniższe informacje przedstawiają układ dla wielu wersji w jednym rozszerzeniu.

Tradycyjny układ rozszerzenia

  • extensionManifest.json
  • extensionIcon.png
  • Zadanie1
    • task.json
    • icon.png
    • taskScript.ps1

Uwaga

Podczas konfigurowania ikony zadania upewnij się, że są spełnione następujące warunki.

  • Nazwa ikony to icon.png
  • Rozmiar ikony to 32x32 piksele
  • Ikona znajduje się w tej samej lokalizacji co task.json plik

Układ wielu wersji

Uwaga

Kod wyszukuje task.json plik w folderze zadań, a następnie bardziej szczegółowe. Jeśli jeden z nich nie zostanie znaleziony na każdym poziomie, zostanie wyświetlony komunikat o błędzie.

  • extensionManifest.json
  • extensionIcon.png
  • Zadanie1
    • Zadanie1V1
      • task.json
      • icon.png
      • taskScript.ps1
    • Zadanie1V2
      • task.json
      • icon.png
      • taskScript.ps1
  • Zadanie 2
    • Zadanie2V1
      • task.json
      • icon.png
      • taskScript.ps1
    • Zadanie 2V2
      • task.json
      • icon.png
      • taskScript.ps1

Napiwek

Aby upewnić się, że _build/Tasks/ssrsfilesdeploy folder zawiera zawartość V1 i V2, ustaw wartość matchCopy(item, srcPath, destPath, { noRecurse: na false w make-util.js pliku .