
Bu kapsamlı içerikte, bir uygulamanın source control aşamasından production ortama alınmasına kadar geçen tüm teknik süreçler detaylı biçimde ele alınır. Commit ve branch mantığından dependency installation, build, test, artifact üretimi, CI/CD pipeline yapısı ve deploy stratejilerine kadar her adım, junior geliştiriciler ve teknik site yöneticileri için anlaşılır ama derinlikli şekilde açıklanır.
Bir yazılım projesinde kullanıcıların gördüğü son çıktı, yani production ortamında çalışan uygulama, aslında birbirine bağlı birçok teknik aşamanın sonucudur. Kodun yazılması bu yolculuğun yalnızca başlangıcıdır; asıl kritik kısım, bu kodun güvenli, tekrarlanabilir ve yönetilebilir biçimde canlıya taşınmasıdır. Junior geliştiriciler için bu süreci bütün olarak anlamak, sadece kod yazmayı değil, yazılımın nasıl teslim edildiğini de kavramayı sağlar.
Modern ekiplerde deployment süreci; source control, branch yönetimi, test otomasyonu, build alma, artifact üretimi, CI/CD pipeline kurulumu ve deploy stratejileriyle birlikte düşünülür. Bu yazıda, commit anından production yayınına kadar olan akışı teknik ama anlaşılır bir dille inceleyeceğiz. Amaç yalnızca tanımları vermek değil, bu parçaların neden gerekli olduğunu ve pratikte nasıl birlikte çalıştığını netleştirmektir.
Source control, yani kaynak kod versiyonlama sistemi, yazılım projelerinde yapılan değişikliklerin kayıt altına alınmasını sağlar. En yaygın kullanılan araç Git'tir ve neredeyse tüm modern geliştirme süreçleri Git tabanlı ilerler. Source control olmadan hangi değişikliğin ne zaman yapıldığını, kimin yaptığını ve bir hata durumunda nasıl geri dönüleceğini yönetmek oldukça zor hale gelir.
Bir dosyanın son halini saklamak tek başına yeterli değildir, çünkü yazılım ekip işi olduğunda değişikliklerin geçmişi büyük önem taşır. Kodun neden değiştirildiği, hangi iş için eklendiği ve hangi sürümde yayına çıktığı gibi bilgiler operasyonel açıdan kritiktir. Özellikle production'da yaşanan bir problemde, son çalışan sürüm ile son değişiklikler arasındaki farkı görmek çoğu zaman sorunun çözümünü hızlandırır.
Git gibi sistemler sadece geçmiş takibi yapmaz, aynı zamanda paralel geliştirme imkanı sağlar. Farklı geliştiriciler aynı proje üzerinde birbirlerinin işini ezmeden çalışabilir. Bu da branch yapılarının, merge süreçlerinin ve code review mekanizmalarının temelini oluşturur.
Teknik site yöneticileri açısından da source control önemlidir, çünkü deployment sürecinin güvenilirliği çoğu zaman versiyonlama disiplinine bağlıdır. Eğer kod tabanı kontrolsüz biçimde sunucuya elle kopyalanıyorsa, hangi kodun canlıda çalıştığını doğrulamak güçleşir. Oysa iyi yönetilen bir repository, operasyonel görünürlük ve izlenebilirlik sağlar.
Commit, belirli bir değişiklik setinin Git geçmişine kaydedilmesidir. Basitçe söylemek gerekirse, proje üzerinde yaptığınız anlamlı bir değişikliği açıklamalı biçimde versiyon geçmişine eklersiniz. Her commit, benzersiz bir hash ile tanımlanır ve bu sayede o değişiklik daha sonra takip edilebilir, karşılaştırılabilir veya geri alınabilir.
İyi bir commit sadece kodu kaydetmek değildir, aynı zamanda niyet beyanıdır. Örneğin, düzeltme, yeni özellik, refactor veya performans iyileştirmesi gibi değişiklik tipleri commit mesajında anlaşılır olmalıdır. Kötü yazılmış mesajlar, ekip içinde geçmişi anlamayı zorlaştırırken, iyi yazılmış commit mesajları hem code review hem de hata ayıklama süreçlerinde büyük kolaylık sağlar.
Commit'lerin küçük ve anlamlı tutulması önemli bir pratiktir. Tek commit içinde hem arayüz değişikliği, hem veri tabanı düzenlemesi, hem de ilgisiz refactor işlemleri yapmak geçmişi kirletir. Daha temiz bir Git geçmişi, sorun çıktığında hangi değişikliğin etkili olduğunu izole etmeyi kolaylaştırır.
Pratikte birçok ekip Conventional Commits benzeri standartlar kullanır. Örneğin feat, fix, chore, refactor veya docs gibi önekler, commit'in niteliğini ilk bakışta belli eder. Bu standartlar, otomatik changelog üretimi, sürümleme ve release notları gibi süreçlerde de fayda sağlar.
Örnek iyi commit mesajları:
Branch, mevcut kod tabanının ayrı bir geliştirme çizgisi olarak kopyalanmış halidir. Ana amaç, ana kod akışını bozmadan yeni özellikler, düzeltmeler veya deneysel çalışmalar yapabilmektir. En yaygın yapı, main veya master gibi bir ana branch ve bunun etrafında feature, hotfix, release gibi yan branch'lerin oluşturulmasıdır.
Junior geliştiricilerin branch kavramını doğru anlaması önemlidir, çünkü bu yapı ekip çalışmasının omurgalarından biridir. Ana branch genellikle production'a en yakın, kararlı kodu temsil eder. Yeni geliştirmeler doğrudan bu branch üzerinde yapılmaz; bunun yerine ayrı bir feature branch açılır, iş tamamlanınca test ve code review sonrasında merge edilir.
Branch stratejileri projeye göre değişebilir. Küçük ekiplerde trunk-based development tercih edilirken, daha kurumsal yapılarda Git Flow benzeri stratejiler görülebilir. Burada önemli olan hangi stratejinin kullanıldığından çok, ekipte herkesin aynı kurala göre hareket etmesidir.
Merge işlemi sırasında çatışmalar yaşanabilir; buna merge conflict denir. Aynı satırların veya aynı dosya bölümlerinin farklı branch'lerde değiştirilmesi sonucu ortaya çıkar. Bu durum teknik olarak normaldir, ancak branch'leri uzun süre açık tutmak conflict riskini artırır. Bu yüzden feature branch'lerin kısa ömürlü olması genellikle daha sağlıklıdır.
| Branch Türü | Amaç | Özellik |
|---|---|---|
| main | Canlıya en yakın kararlı kod | Production kaynağı olabilir |
| develop | Geliştirmelerin toplandığı alan | Bazı ekiplerde ara katman olarak kullanılır |
| feature | Yeni özellik geliştirme | İş bazlı açılır ve kapatılır |
| hotfix | Acil canlı düzeltme | Production sorunlarına hızlı müdahale sağlar |
| release | Yayın hazırlığı | Sürüm sabitleme ve son kontroller için kullanılır |
Modern yazılım projeleri yalnızca sizin yazdığınız koddan oluşmaz. Neredeyse her uygulama, framework'ler, kütüphaneler, yardımcı araçlar ve derleme sistemleri gibi bağımlılıklara sahiptir. Dependency installation süreci, bu bağımlılıkların proje ortamına kurulmasını ifade eder.
JavaScript ekosisteminde npm, yarn veya pnpm; Python tarafında pip; PHP tarafında Composer; Java tarafında Maven veya Gradle gibi araçlar bu iş için kullanılır. Projede hangi paketlerin gerektiği package.json, requirements.txt, composer.json veya benzeri dosyalarda tanımlanır. Pipeline çalıştığında ilk adımlardan biri genellikle bu bağımlılıkları kurmaktır.
Burada kritik konu, yalnızca paketleri kurmak değil, doğru sürümleri kurmaktır. Aynı paketin farklı sürümleri farklı davranışlar gösterebilir ve bu da "benim bilgisayarımda çalışıyordu" sorununa yol açar. Lock dosyaları bu nedenle önemlidir; örneğin package-lock.json veya yarn.lock dosyası, bağımlılık ağacını sabitleyerek her ortamda daha tutarlı kurulum yapılmasını sağlar.
Dependency installation aşaması güvenlik açısından da önem taşır. Dış paketler zaman zaman güvenlik açığı içerebilir ve CI süreçlerinde bağımlılık taraması yapılması iyi bir pratiktir. Ayrıca production ortamında gereksiz geliştirme bağımlılıklarının kurulup kurulmayacağı da deployment stratejisine göre planlanmalıdır.
Build, kaynak kodun çalıştırılabilir veya dağıtılabilir bir çıktıya dönüştürülmesi sürecidir. Her projede build aynı anlama gelmez; bazen TypeScript'in JavaScript'e derlenmesi, bazen frontend asset'lerinin optimize edilmesi, bazen de bir backend uygulamasının paketlenmesi anlamına gelir. Ama ortak amaç, canlıda çalışacak çıktının kontrollü biçimde hazırlanmasıdır.
Özellikle frontend projelerinde build aşaması oldukça görünürdür. Kod minify edilir, dosyalar bundle haline getirilir, kullanılmayan parçalar temizlenir ve performans için optimize edilmiş statik çıktılar oluşturulur. Backend tarafında ise uygulamanın çalıştırılabilir paketi, container imajı veya release dosyası üretilebilir.
Build süreci, geliştirme ve production davranışı arasındaki farkları da yönetir. Örneğin development modunda ayrıntılı loglar, source map'ler veya hot reload gibi araçlar aktif olabilir. Production build alındığında ise daha hızlı, daha güvenli ve daha optimize bir çıktı hedeflenir.
Başarılı bir deployment için build sürecinin deterministik olması gerekir. Aynı commit, aynı ortamda tekrar build edildiğinde mümkün olduğunca aynı çıktıyı üretmelidir. Bu, sürüm güvenilirliği ve rollback senaryoları açısından kritik öneme sahiptir.
Test aşaması, deployment zincirinin kalite kapısıdır. Kodun derlenmesi veya ayağa kalkması tek başına yeterli değildir; beklenen davranışı verip vermediğinin doğrulanması gerekir. Bu yüzden testler, CI/CD süreçlerinde en kritik karar noktalarından biridir.
Bir projede birden fazla test seviyesi bulunabilir. Unit test'ler küçük fonksiyonların veya bileşenlerin doğru çalıştığını kontrol eder. Integration test'ler modüllerin birbiriyle uyumunu sınar, end-to-end test'ler ise kullanıcının göreceği senaryoları uçtan uca doğrular. Her seviyenin amacı farklıdır ve ideal pipeline bu testleri ihtiyaca göre dengeli kullanır.
Testlerin otomatik çalıştırılması, insan hatasını azaltır. Aksi halde bir geliştirici bazı senaryoları atlayabilir veya yalnızca kendi değiştirdiği bölgeye bakabilir. Oysa otomasyon, her commit veya merge işleminde aynı kontrollerin istikrarlı şekilde yapılmasını sağlar.
Junior geliştiriciler için önemli bir bakış açısı şudur: testler geliştirme sürecine ek yük değil, değişiklik yapma güvenidir. İyi test edilen bir projede refactor yapmak, yeni özellik eklemek ve production'a çıkmak daha kontrollü hale gelir. Teknik yöneticiler için de bu, canlı riskini azaltan temel mekanizmalardan biridir.
| Test Türü | Amaç | Hız | Kapsam |
|---|---|---|---|
| Unit Test | Tekil fonksiyon veya modülü sınamak | Yüksek | Dar |
| Integration Test | Modüller arası uyumu doğrulamak | Orta | Orta |
| End-to-End Test | Gerçek kullanıcı akışını test etmek | Düşük | Geniş |
| Smoke Test | Temel sistemin ayağa kalktığını görmek | Yüksek | Temel |
Artifact, build veya test süreçleri sonunda üretilen ve sonraki aşamalarda kullanılabilen çıktıdır. Bu bir zip paketi, derlenmiş uygulama klasörü, container image, rapor dosyası veya dağıtıma hazır başka bir paket olabilir. Artifact kavramı, "kodu tekrar tekrar aynı yerde derleyelim" yaklaşımından daha güvenilir bir çalışma biçimi sunar.
Önemli olan fikir şudur: test edilen şey ile deploy edilen şey mümkün olduğunca aynı olmalıdır. Eğer CI ortamında bir commit için build alındı, testler bunun üzerinde geçti ve sonra production'da yeniden farklı koşullarda build alındıysa tutarsızlık riski doğar. Artifact kullanımı, doğrulanmış çıktının sonraki aşamaya taşınmasına imkan tanır.
Artifact'ler genellikle CI sistemi içinde geçici olarak saklanabilir veya harici bir artifact repository'de tutulabilir. Örneğin Docker registry, package registry ya da özel binary depoları bu iş için kullanılır. Böylece belirli bir sürüm numarasına veya commit hash'ine karşılık gelen paket daha sonra kolayca bulunabilir.
Rollback senaryolarında artifact yönetimi çok değerlidir. Sorunlu sürüm tespit edildiğinde önceki çalışan artifact tekrar deploy edilerek hızlı geri dönüş sağlanabilir. Bu, özellikle kritik sistemlerde kesinti süresini azaltır ve operasyon ekibine kontrol kazandırır.
CI, yani Continuous Integration, geliştiricilerin yaptığı değişikliklerin sık aralıklarla ortak kod tabanına entegre edilmesi ve bu entegrasyonun otomatik kontrollerden geçirilmesi yaklaşımıdır. CD ise bağlama göre Continuous Delivery veya Continuous Deployment anlamına gelir. Delivery, deploy'a hazır çıktıyı otomatik üretmeyi; Deployment ise bu çıktının otomatik olarak canlıya alınmasını ifade eder.
Bir CI/CD pipeline, kod depoya gönderildiğinde tetiklenen otomatik iş akışıdır. Bu iş akışında tipik olarak checkout, dependency installation, lint, test, build, artifact oluşturma ve deploy adımları bulunur. Her adımın başarılı olması, bir sonraki adıma geçilmesini sağlar. Böylece manuel süreçler azalır ve tekrarlanabilirlik artar.
Pipeline yapısının en büyük faydası standartlaşmadır. Her geliştirici kendi bilgisayarında farklı şekillerde işlem yapmak yerine, aynı kontroller merkezi bir sistem tarafından uygulanır. Bu da kaliteyi artırır, sürüm alma hızını yükseltir ve insan kaynaklı hataları azaltır.
Günümüzde GitHub Actions, GitLab CI, Jenkins, Bitbucket Pipelines, CircleCI ve Azure DevOps gibi araçlar bu amaçla sık kullanılır. Hangi aracın seçildiğinden bağımsız olarak temel mantık aynıdır: bir tetikleyici vardır, iş adımları vardır, koşullar vardır ve sonuçlar kayıt altına alınır.
Deploy, üretilen yazılım çıktısının hedef ortama yerleştirilmesi ve çalışır hale getirilmesidir. Bu hedef ortam staging, test, pre-production veya doğrudan production olabilir. Deploy aşaması yalnızca dosya kopyalamaktan ibaret değildir; çoğu zaman ortam değişkenleri, servis yeniden başlatma, migration, cache temizleme ve sağlık kontrolleri gibi ek işlemleri de kapsar.
Production deploy, işletme açısından en hassas adımdır çünkü gerçek kullanıcı trafiğini etkiler. Bu nedenle deploy işlemi planlı, gözlemlenebilir ve mümkünse geri alınabilir olmalıdır. Tek tuşla çalışan ama ne yaptığı bilinmeyen deployment sistemleri kısa vadede pratik görünse de, sorun çıktığında ciddi belirsizlik üretir.
Deploy yöntemi altyapıya göre değişir. Bazı sistemlerde uygulama doğrudan sanal sunucuya kopyalanır, bazılarında Docker image çekilip container ayağa kaldırılır, bazılarında Kubernetes gibi orkestrasyon sistemleri kullanılır. Statik sitelerde ise build çıktısı CDN veya object storage üzerine yüklenebilir.
Pratikweb benzeri hizmet modellerinde teknik yayın altyapısının merkezi biçimde yönetilmesi, kullanıcı açısından büyük kolaylık sağlar. Müşteri domain sahibi olsa bile yayınlama, barındırma ve servis işletimi platform tarafından yürütüldüğünde deploy süreçleri daha düzenli hale gelir. Özellikle hazır web sitesi ve yönetilebilir platform çözümlerinde bu yaklaşım, teknik yükü azaltırken operasyonel standardizasyon sağlar.
Eski sürüm kapatılır, yeni sürüm açılır. Uygulaması kolaydır ancak kısa süreli kesinti oluşturabilir. Küçük ve düşük riskli projelerde kullanılabilir.
Tüm sunucular aynı anda değil, kademeli olarak yeni sürüme geçirilir. Trafik tamamen kesilmez ve hata durumunda etki sınırlı kalabilir. Mikroservis ve yük dengeleyici kullanılan yapılarda sık tercih edilir.
İki ayrı production benzeri ortam tutulur. Aktif trafik bir ortamdayken yeni sürüm diğerinde hazırlanır, ardından trafik yeni ortama yönlendirilir. Hızlı rollback avantajı sunar ama altyapı maliyeti daha yüksektir.
Yeni sürüm önce kullanıcıların küçük bir kısmına açılır. Sorun görülmezse trafik oranı kademeli artırılır. Risk yönetimi açısından güçlüdür, özellikle yüksek trafikli sistemlerde etkilidir.
Bir deployment teknik olarak başarılı görünse bile, bu her şeyin gerçekten sorunsuz olduğu anlamına gelmez. Production öncesinde yapılandırma doğruluğu, ortam değişkenleri, veri tabanı migration etkileri, servis bağımlılıkları ve erişim izinleri kontrol edilmelidir. Özellikle staging ortamı, production'a mümkün olduğunca benzer kurulduğunda sürprizler azalır.
Deploy sonrasında ise izleme ve doğrulama devreye girer. Uygulama ayağa kalktı mı, health check başarılı mı, hata oranı arttı mı, CPU veya bellek kullanımı anormal mi, kritik kullanıcı akışları çalışıyor mu gibi soruların yanıtı gözlemlenmelidir. Bu noktada log toplama, metrik izleme ve alarm sistemleri deployment sürecinin ayrılmaz parçası olur.
Teknik site yöneticileri için en önemli konulardan biri rollback hazırlığıdır. Eğer yeni sürüm sorun çıkarırsa geri dönüş prosedürü önceden tanımlanmalıdır. "Gerekirse bakarız" yaklaşımı production krizlerinde işe yaramaz; hangi sürüme dönüleceği, bunun ne kadar süreceği ve veri uyumluluğunun nasıl korunacağı net olmalıdır.
Bir başka kritik başlık da veri tabanı migration yönetimidir. Uygulama kodu geri alınabilir, ancak şema değişiklikleri bazen daha karmaşık sonuçlar doğurur. Bu yüzden migration'ların ileri ve geri uyumluluk mantığıyla planlanması, güvenli deployment kültürünün önemli parçasıdır.
Junior geliştiriciler çoğu zaman yalnızca kod yazma kısmına odaklanır, ancak profesyonel yazılım geliştirme bundan çok daha geniştir. Yazdığınız kodun branch stratejisine uygun ilerlemesi, commit geçmişinin anlaşılır olması, testlerden geçmesi, build üretmesi ve güvenli şekilde deploy edilebilmesi gerekir. Bu zincirin herhangi bir halkası zayıfsa, iyi yazılmış kod bile operasyonel sorunlara neden olabilir.
Bu nedenle deployment sürecini bir teslim mekanizması olarak görmek gerekir. Kodun repository'ye push edilmesi işin bittiği nokta değil, kontrollü yayın sürecinin başladığı noktadır. Bir geliştirici ne kadar erken aşamada test, build ve deploy mantığını kavrarsa, ekip içinde o kadar değerli ve bağımsız hareket edebilir.
Teknik site yöneticileri için de bu süreç yalnızca yazılım ekibinin meselesi değildir. Yayın güvenilirliği, bakım kolaylığı, güncelleme hızı ve kriz anındaki müdahale kapasitesi doğrudan bu pipeline kalitesine bağlıdır. Hazır web sitesi, içerik yönetimi veya daha gelişmiş platform altyapılarında bile temel mantık aynıdır: izlenebilir kaynak kod, otomatik doğrulama, güvenilir build ve kontrollü deploy.
Özellikle Pratikweb gibi yönetilebilir web tabanlı çözüm yaklaşımında, arka plandaki teknik altyapının servis tabanlı ve genişleyebilir olması deployment disiplinini daha da önemli hale getirir. Hazır çözümle başlanıp zamanla daha gelişmiş platformlara geçilecekse, commit'ten production'a kadar uzanan süreçlerin standartlaştırılması sürdürülebilir büyüme açısından büyük avantaj sağlar.
Commit, branch, dependency installation, build, test, artifact, CI/CD ve deploy süreçleri birbirinden bağımsız teknik kelimeler değil, tek bir teslim zincirinin parçalarıdır. Bu zinciri doğru kuran ekipler daha az hata yapar, daha hızlı yayın alır ve production riskini daha iyi yönetir. Yazılımın kalitesi yalnızca kodun içinde değil, o kodun nasıl üretildiği, doğrulandığı ve canlıya taşındığında da ortaya çıkar.
Eğer siz de web projelerinde daha güvenilir bir yayın süreci kurmak istiyorsanız, ilk adım olarak mevcut akışınızı haritalandırın: Kod nerede tutuluyor, testler ne zaman çalışıyor, build nasıl alınıyor, deploy nasıl yapılıyor ve geri dönüş planı var mı? Bu soruların net cevapları, hem küçük ekiplerde hem de büyüyen platform projelerinde teknik olgunluğun temelini oluşturur. Süreci sadeleştirip standartlaştırdıkça, production'a çıkmak bir risk alanı olmaktan çıkar ve yönetilebilir bir operasyon haline gelir.