Referensi - mengintegrasikan tugas build kustom ke dalam ekstensi

Layanan Azure DevOps | Azure DevOps Server 2022 - Azure DevOps Server 2019

Gunakan referensi ini saat Anda ingin membuat dan mengintegrasikan tugas alur build kustom dengan ekstensi di Azure DevOps.

Tip

Lihat dokumentasi terbaru kami tentang pengembangan ekstensi menggunakan Azure DevOps Extension SDK.

Tugas kustom

Tugas adalah blok penyusun untuk menentukan otomatisasi dalam alur build atau rilis. Kami menawarkan banyak tugas bawaan untuk mengaktifkan skenario build dan penyebaran mendasar . Kami menyarankan agar Anda meninjau skenario ini sebelum membangun skenario Anda sendiri. Jika tugas yang ada tidak memenuhi kebutuhan Anda, Anda dapat membangun tugas kustom.

Tugas build kustom JSON

Saat Anda membuat tugas build atau rilis kustom dengan ekstensi, ekstensi Anda menyertakan task.json file untuk setiap tugas build atau rilis. File menjelaskan task.json tugas build atau rilis. Sistem build menggunakannya untuk merender opsi konfigurasi kepada pengguna dan untuk mengetahui skrip mana yang akan dijalankan pada waktu build.

Dokumentasi SDK tugas build/rilis ada di GitHub. Secara khusus, Anda mungkin tertarik dengan skema task.json.

Bundel beberapa versi tugas build/rilis dalam satu ekstensi

Anda dapat menyertakan beberapa versi tugas build atau rilis dalam ekstensi Anda. Luncurkan versi ekstensi Anda di masa mendatang tanpa mengganggu layanan pengguna pada versi yang lebih lama. Informasi berikut menunjukkan tata letak untuk memiliki beberapa versi dalam satu ekstensi.

Tata letak ekstensi tradisional

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

Catatan

Saat Anda menyiapkan ikon tugas, pastikan hal berikut ini benar.

  • Nama ikon icon.png
  • Ukuran ikon adalah 32x32 piksel
  • Ikon berada di lokasi yang sama dengan task.json file

Tata letak beberapa versi

Catatan

Kode mencari file di task.json dalam folder tugas lalu satu tingkat lebih dalam. Jika tidak ditemukan di salah satu tingkat, Anda akan melihat pesan kesalahan.

  • extensionManifest.json
  • extensionIcon.png
  • Tugas1
    • Tugas1V1
      • task.json
      • icon.png
      • taskScript.ps1
    • Tugas1V2
      • task.json
      • icon.png
      • taskScript.ps1
  • Tugas2
    • Tugas2V1
      • task.json
      • icon.png
      • taskScript.ps1
    • Tugas2V2
      • task.json
      • icon.png
      • taskScript.ps1

Tip

Untuk memastikan _build/Tasks/ssrsfilesdeploy folder berisi konten V1 dan V2, atur matchCopy(item, srcPath, destPath, { noRecurse: ke falsemake-util.js dalam file.