Geliştiricilerin projelerini hızla ve güvenilir şekilde canlıya almak için kullanılan en etkili yöntemlerden biri, Git sunucusunda webhook kullanımıdır. Bu yöntem, kod depolarında yapılan değişiklikleri otomatik olarak algılayıp, belirlenen sunucuya anında dağıtım sağlar. Peki, bu süreci nasıl kurabiliriz ve nelere dikkat etmeliyiz? Bu yazıda detaylı bir şekilde anlatıyorum.
İlk olarak, webhook nedir ve nasıl çalışır sorusunu cevaplamamız gerekiyor. Webhook, belirli bir olay gerçekleştiğinde (örneğin, push işlemi), karşı taraftaki URL'ye HTTP POST isteği gönderen bir mekanizmadır. Git sunucularında, genellikle GitHub, GitLab veya Bitbucket gibi platformlar, repository'ye yapılan push veya merge işlemleri sonrası webhook tetiklenmesine imkan tanır.
İkinci aşamada, webhook'un tetiklediği sunucu tarafı script veya uygulamayı hazırlamak gerekir. Bu script, gelen POST isteğini doğrulamalı ve ardından otomatik dağıtım komutlarını çalıştırmalıdır. Örneğin, aşağıdaki adımlar izlenebilir:
- Sunucuda, webhook isteklerini dinleyecek bir endpoint kurmak. Bu genellikle Node.js, Python (Flask, Django), PHP veya herhangi bir backend teknolojisiyle yapılabilir.
- Gelen istekte, olayın doğruluğunu kontrol etmek (örneğin, imza ile doğrulama).
- Kodların güncellenmesini sağlayacak komutları çalıştırmak:
git pull origin master veya git fetch && git reset --hard origin/master- Bağımlılıkların güncellenmesi (örn.
npm install veya composer install) - Uygulamanın yeniden başlatılması (örn.
systemctl restart myapp, veya pm2 restart app)
Örnek bir Node.js webhook listener kodu şu şekilde olabilir:
123456789101112131415161718192021222324
const express = require('express');
const { exec } = require('child_process');
const app = express();
app.use(express.json());
app.post('/webhook', (req, res) => {
// Güvenlik doğrulaması ve olay kontrolü yapılabilir
if (req.body.ref === 'refs/heads/master') {
exec('git pull origin master && systemctl restart myapp', (err, stdout, stderr) => {
if (err) {
console.error([icode]Hata: ${err}[/icode]);
return res.status(500).send('Hata oluştu');
}
console.log([icode]Çalışma çıktı: ${stdout}[/icode]);
res.status(200).send('Başarıyla güncellendi');
});
} else {
res.status(200).send('İlgili olmayan branch');
}
});
app.listen(3000, () => console.log('Webhook dinleyicisi çalışıyor...'));
Son olarak, güvenlik açısından, webhook endpoint'ini yalnızca Git platformunun IP adreslerine veya imzaya göre doğrulamak önemlidir. Ayrıca, bu otomasyonun çalıştığı ortamda uygun izinler ve yedekleme stratejileri de göz önünde bulundurulmalıdır.
Webhook ile otomatik dağıtım, geliştirme sürecini hızlandırır ve hataları minimize eder, ancak doğru yapılandırma ve güvenlik önlemleri alınmadan kullanımı riskli olabilir. Bu yöntemi kullanırken, projeye uygun otomasyon ve güvenlik mekanizmalarını detaylıca planlamak gerekir.
