Not
Bu sayfaya erişim yetkilendirme gerektiriyor. Oturum açmayı veya dizinleri değiştirmeyi deneyebilirsiniz.
Bu sayfaya erişim yetkilendirme gerektiriyor. Dizinleri değiştirmeyi deneyebilirsiniz.
Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022
Azure DevOps için Node CLI'yi (tfx-cli) kullanarak özel veya kutu içi işlem hattı görevlerini Azure DevOps kuruluşunuza veya Azure DevOps Server proje koleksiyonuna yükleyin.
Önemli
Azure DevOps Server örneğine yerleşik görevleri yüklediğinizde, aracı sürümü veya sunucu tarafında destek eksikliği nedeniyle bazı görev özellikleri desteklenmeyebilir.
tfx-clihakkında daha fazla bilgi için gitHub'da Azure DevOps için Node CLIbölümüne bakın.
Önkoşullar
| Kategori | Gereksinimler |
|---|---|
| Permissions | Kuruluş veya koleksiyon düzeyinde Aracı Havuzu Yöneticileri grubu üyeliği. Bkz . Güvenlik grupları, hizmet hesapları ve izinler. |
| Belirteçler | Agent Havuzları (Okuma ve yönetme) kapsamına sahip bir kişisel erişim belirteci (PAT) veya bir Microsoft Entra belirteci. Daha iyi güvenlik için Entra belirteçleri, Kişisel Erişim Belirteçleri (PAT'ler) üzerinden önerilir. |
| Tools | Genel olarak yüklenen Node.jsve tfx-cli'ninen son sürümü:npm install -g tfx-cli |
tfx-cli ile oturum açma
Görevleri karşıya yüklemeden önce tfx-cli kullanarak Azure DevOps'ta oturum açın. Daha fazla kimlik doğrulama seçeneği için bkz. Azure DevOps için platformlar arası CLI kimlik doğrulaması.
Aşağıdaki komutu çalıştırın ve istendiğinde hizmet URL'sini ve PAT'yi sağlayın:
tfx login
Ortamınızla eşleşen hizmet URL'sini kullanın:
| Çevre | URL biçimi |
|---|---|
| Azure DevOps Services | https://dev.azure.com/{organization} |
| Azure DevOps Server | http://{server}:{port}/DefaultCollection |
Görevleri yükleme
Bahşiş
Kutu içi işlem hattı görevlerini güncelleştirmeniz gerekiyorsa azure-pipelines-tasks deposunu kopyalayabilirsiniz. Ardından, yönergeleri izleyerek gerekli görevleri oluşturun - görevleri oluşturma.
Bir görevi tfx-cli kullanarak yükleyin.
tfx build tasks upload --task-path <PATH_TO_TASK>
PATH_TO_TASK , dahil olmak üzere task.jsonderlenmiş görevi içeren klasörün yoludur.
Önemli
İşlem hattı aracıları, görevleri sürüme göre önbelleğe alır. Bir görevi değiştirir ve aynı sürüm numarasıyla yeniden yüklerseniz aracılar önbelleğe alınmış kopyayı kullanmaya devam eder. Güncellenmiş bir görevi yüklemeden önce her zaman task.json içindeki yama sürümünü en azından arttırın.
Yüklemeyi doğrula
Görevin başarıyla yüklendiğinden emin olun.
tfx build tasks list
Çıktı, sunucudaki tüm görevleri, her görevin id, name ve version dahil olmak üzere, listeler.
Görev sil
Yüklenen bir görevi kimlik numarasını belirtirerek kaldırın. Çıktıdan tfx build tasks list görev kimliğini alın.
tfx build tasks delete --task-id <TASK_ID>
Uyarı
Bir görev silindiğinde, görev sunucudan kaldırılır. Silinen göreve başvuran herhangi bir işlem hattı bir sonraki çalıştırmada başarısız olur.
Sorun giderme
| Error | Nedeni | Düzelt |
|---|---|---|
| 401 Yetkisiz | PAT'nin süresi doldu, iptal oldu veya Aracı Havuzları (Okuma ve yönetme) kapsamı eksik. | Doğru kapsama sahip yeni bir PAT oluşturun. |
| 403 Yasak | Hesabınız Aracı Havuzu Yöneticileri grubunda değil. | Bir kuruluş yöneticisinin sizi eklemesini isteyin. |
| Görev zaten var | Zaten sunucuda olan sürümü karşıya yükledi. | Yama sürümünü artır task.json ve yeniden karşıya yükleyin. |
tfx-cli hakkında daha fazla bilgi için Azure DevOps için Node CLI belgelerine bakın.