Yapılandırılmış Değişikliklerden Otomatik Sürüm Notları Oluşturma
Yapılandırılmış değişiklik verileri, bu workflow ile tutarlı sürüm notlarına hızlıca dönüştürülebilir. Veriler webhook üzerinden alınır, doğrulanır ve otomatik olarak Markdown formatında hazırlanır. Değişiklikler türlerine göre (özellik, düzeltme, bakım) gruplanır ve kritik değişiklikler öne çıkarılır. Geliştirme ekipleri, zamandan tasarruf sağlayan ve kendi standartlarına uyarlanabilen net bir dokümantasyondan faydalanır.
Geliştirme ekipleri, yapılandırılmış değişiklik verilerinden otomatik olarak sürüm notları oluşturma olanağına bu workflow ile sahip olur. Süreç, type, title ve isteğe bağlı olarak issue ile breaking alanlarını içeren bir dizi değişikliği bekleyen bir webhook uç noktasına POST isteğiyle başlar. Girişler eksiksizlik ve doğru tür (feature, fix, maintenance) açısından kontrol edilir. Geçerli verilerde değişiklikler uygun şekilde gruplanır ve önemli yenilikler ile kritik değişiklikleri öne çıkaran bir Markdown belgesi oluşturulur. Hatalı veya eksik girişler, net bir hata mesajı ile yanıtlanır. Çıktı doğrudan kullanılabilir ya da diğer sistemlere entegre edilebilir. Yetkisiz erişimi önlemek için webhook kimlik doğrulaması n8n'de ayrı olarak etkinleştirilmelidir. Veri yürütme ve depolama, n8n yapılandırmasına göre yapılır. Workflow, düzenli olarak sürüm notları yayınlayan ve tutarlılık ile verimliliğe önem veren ekipler için özellikle uygundur. Kendi format standartlarınıza göre uyarlama yapılabilir.
Yapay Zekâ Tarafından Oluşturulan Görsel
Kurulum
1. Workflow'u n8n'e içe aktarın.
2. Webhook düğümünü seçin ve test dinleyicisini başlatın.
3. Webhook için gösterilen test URL'sini kopyalayın.
4. Content-Type application/json ve uygun gövde ile test URL'sine bir POST isteği gönderin (aşağıdaki örneğe bakınız).
5. Yanıtı kontrol edin ve başarılıysa workflow'u yayınlayıp etkinleştirin.
6. Etkinleştirmeden sonra üretim URL'si için webhook düğümünü kullanın.
7. Erişimi güvence altına almak için n8n'de webhook kimlik doğrulamasını yapılandırın.
Kullanım
Geçerli bir istek örneği:
```json
{
"changes": [
{"type": "feature", "title": "Neue Benutzeroberfläche", "issue": "#123"},
{"type": "fix", "title": "Login-Fehler behoben"},
{"type": "maintenance", "title": "Abhängigkeiten aktualisiert", "breaking": true}
]
}
```
Beklenen yanıt:
```json
{
"status": "success",
"groups": {
"feature": [
{"type": "feature", "title": "Neue Benutzeroberfläche", "issue": "#123"}
],
"fix": [
{"type": "fix", "title": "Login-Fehler behoben"}
],
"maintenance": [
{"type": "maintenance", "title": "Abhängigkeiten aktualisiert", "breaking": true}
]
},
"breaking": [
{"type": "maintenance", "title": "Abhängigkeiten aktualisiert", "breaking": true}
],
"markdown": "# Release Notes\n\n## feature\n- Neue Benutzeroberfläche (#123)\n\n## fix\n- Login-Fehler behoben\n\n## maintenance\n- Abhängigkeiten aktualisiert\n\n## Breaking Changes\n- Abhängigkeiten aktualisiert"
}
```
Hata durumu (boş changes dizisi):
```json
{
"changes": []
}
```
Yanıt:
```json
{
"status": "error",
"message": "changes muss ein nicht-leeres Array sein."
}
```
HTTP Durumu: 200 (başarı durumunda), 200 (hata durumunda, çünkü açıkça böyle uygulanmıştır)
Notlar:
- type (feature, fix, maintenance) ve title alanları zorunludur.
- İsteğe bağlı: issue (örneğin bilet numarası), breaking (true/false).
- Webhook kimlik doğrulaması n8n'de ayrı olarak etkinleştirilmelidir.
- Yürütme verileri n8n'de saklanabilir; saklama ve erişim n8n yapılandırmasına bağlıdır.
Gerekli Bağlantılar ve API'ler
API Bağlantıları
İş akışı JSON'unda kayıtlı API erişim bilgisi bulunmadı. Etkinleştirmeden önce yine de webhookları, hedef sistemleri, erişim bilgilerini ve veri korumayı kontrol edin.
Düğümler
WebhookCodeRespond to Webhook
Yalıtılmış işlev testi başarılı
İsteğe bağlı yalıtılmış işlev testi
Yalıtılmış veri akışı, harici hizmetler veya erişim bilgileri olmadan test edildi.
✓ 5 test başarıyla tamamlandıTest edilen durumları gösterTest edilen durumları gizle
✓ Eksiksiz verilerle standart durumGeçerli örnek verilerle eksiksiz standart akışı denetler.Yalıtılmış işlev testi başarılı✓ Varyasyon veya sınır durumuGeçerli bir varyasyonu veya önemli bir sınır durumunu denetler.Yalıtılmış işlev testi başarılı✓ Ek işleme kuralıBu iş akışının ek işleme kuralını denetler.Yalıtılmış işlev testi başarılı✓ Geçersiz veya eksik girdiGeçersiz veya eksik verilerin kontrollü biçimde reddedildiğini denetler.Yalıtılmış işlev testi başarılı✓ Boş girdiBoş bir isteğin kontrollü bir yanıt aldığını denetler.Yalıtılmış işlev testi başarılı
