Mengunggah tugas alur ke Azure DevOps

Layanan Azure DevOps | Azure DevOps Server | Azure DevOps Server 2022

Unggah tugas pipeline kustom atau bawaan ke organisasi Azure DevOps Anda atau koleksi proyek Azure DevOps Server dengan menggunakan Node CLI untuk Azure DevOps (tfx-cli).

Penting

Saat Anda mengunggah tugas bawaan ke instans Azure DevOps Server, beberapa kapabilitas tugas mungkin tidak didukung karena versi agen atau kurangnya dukungan di sisi server.

Untuk informasi selengkapnya tentang tfx-cli , lihat Node CLI untuk Azure DevOps di GitHub.

Prasyarat

Kategori Persyaratan
Permissions Keanggotaan dalam grup Administrator Kumpulan Agen di tingkat organisasi atau koleksi. Lihat Grup keamanan, akun layanan, dan izin.
Token Token akses pribadi (PAT) dengan lingkup Kumpulan Agen (Baca &kelola), atau token Microsoft Entra. Token Entra lebih direkomendasikan dibandingkan PAT untuk keamanan yang lebih baik.
Alat Versi terbaru Node.js dan tfx-cli yang diinstal secara global: npm install -g tfx-cli

Masuk dengan tfx-cli

Masuk ke Azure DevOps dengan menggunakan tfx-cli sebelum Anda mengunggah tugas. Untuk opsi autentikasi lainnya, lihat Autentikasi CLI lintas platform untuk Azure DevOps.

Jalankan perintah berikut dan berikan URL layanan dan PAT saat diminta:

tfx login

Gunakan URL layanan yang cocok dengan lingkungan Anda:

Lingkungan Format URL
Layanan Azure DevOps https://dev.azure.com/{organization}
Azure DevOps Server http://{server}:{port}/DefaultCollection

Mengunggah tugas

Saran

Jika Anda perlu memperbarui tugas alur kerja bawaan, Anda dapat mengkloning repositori azure-pipelines-tasks. Kemudian, buat tugas yang diperlukan dengan mengikuti panduan - cara membangun tugas.

Unggah tugas dengan menggunakan tfx-cli:

tfx build tasks upload --task-path <PATH_TO_TASK>

PATH_TO_TASK adalah jalur ke folder yang berisi tugas yang dikompilasi, termasuk task.json.

Penting

Agen pipeline menyimpan tugas berdasarkan versi. Jika Anda mengubah tugas dan mengunggahnya kembali dengan nomor versi yang sama, agen terus menggunakan salinan yang di-cache. Selalu tingkatkan setidaknya versi patch di task.json sebelum Anda mengunggah tugas yang telah diperbarui.

Memverifikasi unggahan

Konfirmasikan bahwa tugas Anda berhasil diunggah:

tfx build tasks list

Output mencantumkan semua tugas di server, termasuk id, name, dan version dari setiap tugas.

Hapus tugas

Hapus tugas yang diunggah dengan menentukan ID-nya. Dapatkan ID tugas dari keluaran tfx build tasks list.

tfx build tasks delete --task-id <TASK_ID>

Peringatan

Menghapus tugas akan menghapusnya dari server. Alur apa pun yang mereferensikan tugas yang dihapus gagal pada eksekusi berikutnya.

Troubleshooting

Kesalahan Penyebab Perbaiki
401 Tidak Sah PAT kedaluwarsa, dicabut, atau hilang cakupan Kumpulan Agen (Baca & kelola). Buat PAT baru dengan cakupan yang benar.
403 Dilarang Akun Anda tidak berada dalam grup Administrator Kumpulan Agen . Minta admin organisasi untuk menambahkan Anda.
Tugas sudah ada Mengunggah versi yang sama yang sudah ada di server. Naikkan versi patch di task.json dan unggah lagi.

Untuk informasi selengkapnya tentang tfx-cli, lihat dokumentasi Node CLI untuk Azure DevOps.

Konten terkait

  • Last updated on