REST API ile Yeni Bir Azure DevOps Yapısı Oluşturma ve Değişkenlerini Güncelleme.
Azure DevOps, ekiplerin yazılımları daha hızlı ve daha verimli bir şekilde oluşturmasına ve göndermesine yardımcı olmak için tasarlanmış kapsamlı bir geliştirme araçları ve hizmetleri paketidir.. Azure DevOps'un temel özelliklerinden biri derleme sistemidir., bu da ekiplerin yapıyı otomatikleştirmesine olanak tanır, Ölçek, ve yazılımlarının dağıtım süreci.
Bu makalede, REST API kullanarak yeni bir Azure DevOps derlemesi oluşturmayı ve değişkenlerini güncellemeyi keşfedeceğiz.. CURL kullanarak yeni bir yapının nasıl oluşturulacağını gösteren örnek bir kod parçacığı kullanacağız., ancak REST API çağrılarını destekleyen herhangi bir programlama dilini kullanabilirsiniz..
Yeni bir Azure DevOps derlemesi oluşturmanın ilk adımı, özelliklerini tanımlamaktır., yapı tanımı ve yapı parametreleri gibi. Yapı tanımı, yapı adımlarını tanımlar, kod derleme gibi görevleri içerebilir, çalışan testler, ve eserler yaratmak. Derleme parametreleri, derleme sürecini özelleştirmek için derleme adımları tarafından kullanılan değişkenlerdir..
REST API'yi kullanarak yeni bir yapı oluşturmak için, adresine bir POST isteği göndermeniz gerekir. Derlemeler oluşturan Azure DevOps API uç noktası. Aşağıdaki kod parçacığı cURL kullanarak yeni bir yapının nasıl oluşturulacağını gösterir:
curl -X POST "https://dev.azure.com/{organization}/{project}/_apis/build/builds?api-version=7.0" \
-H "Content-Type: application/json" \
-d '{
"definition": {
"id": {definition_id}
},
"parameters": "{\"{parameter_name}\":\"{parameter_value}\"}"
}'
PAT ile çalışma örneği:
curl -X POST "https://{username}:{PAT}@dev.azure.com/{organization}/{project}/_apis/build/builds?api-version=7.0" \
-H "Content-Type: application/json" \
-d '{
"definition": {
"id": {definition_id}
},
"parameters": "{\"{parameter_name}\":\"{parameter_value}\"}"
}'
Bu kod pasajını parçalayalım:
- bu
-X POST
flag bir POST isteği göndermek istediğimizi belirtir. - Derlemeler oluşturmaya yönelik API uç noktası https'dir://dev.azure.com/{organizasyon}/{proje}/_apis/build/builds?api-versiyonu=7.0, Neresi {organizasyon} senin adın mı Azure DevOps organizasyon ve {proje} projenizin adı. bu
api-version
parametresi kullanmak istediğimiz API sürümünü belirtir. - bu
-H "Content-Type: application/json"
flag, JSON verilerini istek gövdesine gönderdiğimizi belirtir. - İstek gövdesi, aşağıdaki özellikleri içeren bir JSON nesnesidir:
definition
: yapı tanımını belirten bir nesne. buid
özellik, yapı tanımının kimliğini belirtir.parameters
: derleme parametrelerini belirten JSON biçimli bir dize. bu{parameter_name}
Ve{parameter_value}
yer tutucular gerçek parametre adı ve değeriyle değiştirilmelidir, sırasıyla.
Örnek kod parçacığında, ID'li yapı tanımını kullanarak yeni bir yapı oluşturuyoruz 15 ve güncellenmesi NUMBER_OF_WORKERS
Bir değişkenin değerini içeren parametre 2_NUMBER_OF_WORKERS
, çalışma zamanında gerçek bir değerle değiştirilebilir. Biz de ayarlıyoruz NUMBER_OF_WORKERS2
parametresini statik bir değere 5.
REST API'yi kullanarak bir yapı değişkenini güncellemek için, derleme değişkenlerini güncelleyen API uç noktasına bir PATCH isteği göndermeniz gerekir. Aşağıdaki kod parçacığı, cURL kullanarak bir yapı değişkeninin nasıl güncelleneceğini gösterir:
curl -X PATCH "https://dev.azure.com/{organization}/{project}/_apis/build/builds/{build_id}/variables?api-version=7.0" \
-H "Content-Type: application/json" \
-d '{
"variables": {
"{variable_name}": {
"value": "{new_value}"
}
}
}'
Bu kod pasajını parçalayalım:
- bu
-X PATCH
flag bir PATCH isteği göndermek istediğimizi belirtir. - Derleme değişkenlerini güncellemek için API uç noktası `https://dev.azure.com/{organizasyon}/{proje}/_apis/build/builds/{build_id}/değişkenler?api sürümü=7.0