Netlify Nasıl Kullanılır? Kayıttan İlk Deploy’a Adım Adım

Netlify nasıl kullanılır? İlk kez başlayan biri için süreç beş temel adımdan oluşur: hesap oluşturmak, projeyi Git deposundan ya da hazır klasörden eklemek, build ayarlarını doğrulamak, ilk deploy’u incelemek ve projeyi production’da erişilebilir hâle getirmek. Ardından alan adı, SSL, environment variables, Deploy Previews ve kullanım kredileri gibi ayarlar tamamlanır.

Bu rehber iki farklı yolu birlikte ele alıyor. Git tabanlı akış, düzenli olarak geliştirilen projeler için daha sürdürülebilirdir. Netlify Drop ise build edilmiş statik bir klasörü hızla paylaşmak için uygundur. İkisini aynı şey gibi kullanmak, özellikle React veya Vite projelerinde en sık görülen başlangıç hatalarından biridir.

Başlamadan Önce Neye İhtiyacınız Var?

Netlify hesabı açmadan önce projenizin türünü belirleyin:

• Yalnız index.html, CSS, JavaScript ve görsellerden mi oluşuyor?
• Vite, Astro, Next.js veya başka bir framework ile build mi ediliyor?
• Server-side rendering, API endpoint’i veya veritabanı gerekiyor mu?
• Kod GitHub, GitLab ya da başka bir Git sağlayıcısında mı?

Basit HTML sitesi için doğrudan hazır klasör yüklemek yeterli olabilir. Framework projesinde ise önce package. json içindeki build script’ini ve build sonucunda oluşan dizini bilmeniz gerekir. Vite için tipik sonuç dist, eski Create React App projeleri için build olabilir. Next. js gibi framework’lerde publish klasörünü elle seçmek yerine Netlify’nin güncel adapter ve framework algılama akışını kullanmak daha doğrudur.

Yerel makinede şu kontrolleri yapın:

``bash node --version npm install npm run build ``

Build yerelde başarısız oluyorsa Netlify’da da büyük olasılıkla başarısız olacaktır. Önce eksik dependency, yanlış Node sürümü veya environment variable sorununu yerelde çözün.

1. Netlify Hesabı Nasıl Oluşturulur?

Netlify’ye e-posta veya desteklenen kimlik sağlayıcılarından biriyle kayıt olabilirsiniz. Hesap açtıktan sonra kişisel kullanım için bir team alanı ve projeleri yöneteceğiniz dashboard oluşur. Ekran adları zaman içinde değişebildiği için temel mantığa odaklanın: dashboard’daki yeni proje oluşturma seçeneği sizi Git’ten import, Netlify Drop, starter veya AI agent gibi mevcut başlangıç yollarına götürür.

2026’daki kredi tabanlı hesaplarda yeni projeler, team ayarına bağlı olarak private başlayabilir. Bu durumda başarılı production deploy yapılmış olsa bile siteyi dışarı açmak için ayrıca yayınlama veya görünürlük seçimi gerekebilir. “Deploy başarılı ama link başkasında açılmıyor” sorununun nedenlerinden biri budur.

İlk girişten sonra şu üç ayarı kontrol etmek iyi bir başlangıçtır:

1. Team ve proje adlandırması,
2. Aylık kullanım kredisi ve bildirimler,
3. Varsayılan proje ve preview görünürlüğü.

2. Git Deposundan Yeni Proje Oluşturma

Düzenli geliştirilen bir uygulamada önerilen akış, depoyu Netlify’ye bağlamaktır. Dashboard’dan Git tabanlı proje ekleme seçeneğini açın, Git sağlayıcısını yetkilendirin ve doğru repository’yi seçin.

Yetki verirken mümkün olan en dar kapsamı kullanın. Tüm organizasyon depolarını açmak yerine yalnız yayınlanacak depoya erişim vermek, gereksiz erişim alanını azaltır. Organizasyon politikaları nedeniyle repo görünmüyorsa Git sağlayıcısındaki uygulama izinlerini ve Netlify planınızın private organization repo desteğini kontrol edin.

Repository seçildikten sonra Netlify çoğu popüler framework’ü algılar. Yine de önerilen değerleri körü körüne kabul etmeyin. Şunları doğrulayın:

Ayar	Ne anlama gelir?	Vite örneği
Production branch	Canlı sürümü besleyen branch	main
Base directory	Monorepo içinde projenin bulunduğu dizin	Boş veya apps/web
Build command	Production çıktısını üreten komut	npm run build
Publish directory	Yayınlanacak nihai çıktı	dist
Functions directory	Function dosyalarının konumu	netlify/functions

Monorepo kullanıyorsanız base directory ve package manager workspace ayarları kritik hâle gelir. Yanlış dizinde çalışan build, package. json bulunamadı, dependency kurulamadı veya publish klasörü oluşmadı hatası verebilir.

3. İlk Deploy Nasıl Başlatılır?

Ayarları onayladığınızda Netlify depoyu klonlar, dependency’leri kurar, build komutunu çalıştırır ve çıkan dosyaları deploy eder. Deploy sayfasındaki log, sorun çözmede ana kaynaktır. Yalnız son kırmızı satıra değil, kullanılan Node sürümüne, install komutuna, environment context’e ve ilk gerçek hata mesajına bakın.

Başarılı bir deploy sonunda proje için netlify. app alt alan adı oluşur. Kredi tabanlı yeni projede görünürlük private ise bu URL yalnız yetkili kişilerce görülebilir. Projeyi public yapmak, production içeriğini internetten erişilebilir hâle getirir; preview görünürlüğü ayrıca yönetilebilir.

İlk deploy’dan sonra şu kontrolleri yapın:

• Ana sayfa HTTP 200 ile açılıyor mu?
• CSS, JavaScript ve görseller yükleniyor mu?
• Tarayıcı konsolunda 404 veya CORS hatası var mı?
• Doğrudan iç rota açıldığında SPA 404 veriyor mu?
• Form veya API endpoint’i gerçekten çalışıyor mu?
• Mobil görünüm ve temel erişilebilirlik doğru mu?

4. Netlify Drop ile İlk Site Nasıl Yayınlanır?

Git kullanmak istemiyorsanız Netlify Drop’a hazır site klasörünü sürükleyebilirsiniz. Buradaki kritik kelime hazırdır. Tarayıcının doğrudan sunabileceği dosyalar yüklenmelidir.

Basit HTML projesinde klasör şöyle görünebilir:

``text my-site/ ├── index.html ├── styles.css ├── script.js └── images/ ``

Vite projesinde önce build alın:

``bash npm install npm run build ``

Ardından proje kökünü veya src klasörünü değil, oluşan dist klasörünü Drop alanına bırakın. Drop akışı siteyi hızlıca paylaşır ancak kaynak kod build’i Netlify’da tekrarlanmaz. Güncelleme yaptığınızda yeni build çıktısını yeniden yüklemeniz gerekir.

Netlify Drop; portföy, tek sayfalık tanıtım, etkinlik microsite’ı ve prototip için pratiktir. Pull request preview, otomatik build ve ekip denetimi gereken projede Git akışı daha uygundur.

5. Build Ayarları Nereden Değiştirilir?

Build ve deploy ayarları dashboard’dan yönetilebilir; ancak uzun vadede kritik yapılandırmayı netlify. toml dosyasında version control altında tutmak daha izlenebilir olabilir.

Basit bir örnek:

```toml [build] command = "npm run build" publish = "dist"

[context. deploy-preview] command = "npm run build" ```

UI ve dosya tabanlı ayarlar arasında öncelik kuralları vardır. Aynı değeri iki yerde farklı biçimde tanımlamak kafa karıştırabilir. Ekip olarak tek bir “source of truth” belirleyin ve değişikliklerin nedenini commit mesajında açıklayın.

6. Environment Variables Nasıl Eklenir?

API endpoint’i, analytics kimliği veya server-side secret gibi değerler kaynak koda yazılmamalıdır. Netlify dashboard’daki environment variables bölümünden değişken eklenebilir; CLI veya API de kullanılabilir. Değişkenin hangi deploy context’lerinde ve hangi scope’larda kullanılacağını ayrıca düşünün.

Önemli ayrım şudur: Browser bundle’ına dahil edilen değişkenler secret değildir. Örneğin Vite’ta VITE_ önekiyle client tarafına açılan bir değer, kullanıcı tarafından JavaScript içinde görülebilir. Private API key yalnız Functions veya güvenli server-side runtime’da okunmalıdır.

Bir değişken eklendikten ya da değiştirildikten sonra mevcut deploy otomatik olarak yeniden yazılmaz. Yeni build/deploy gerekebilir. Production, Deploy Preview ve branch deploy için farklı değer kullanmak; test verisinin canlı servislere yazılmasını önlemeye yardımcı olur.

7. Deploy Preview Nasıl Kontrol Edilir?

Git bağlantısı kurulduktan sonra yeni bir branch açıp pull request oluşturun. Netlify yapılandırmaya bağlı olarak değişikliği build eder ve production’dan ayrı Deploy Preview URL’si üretir. Bu URL üzerinden tasarım, içerik, routing, form ve function değişiklikleri merge edilmeden incelenebilir.

Preview ortamında şu noktaları kontrol edin:

• Production secret’ları yanlışlıkla preview’a açılıyor mu?
• Preview veritabanı veya dış servis sandbox kullanıyor mu?
• URL public ise hassas test verisi içeriyor mu?
• Arama motorlarına indekslenmesini engelleyen varsayılan davranış korunuyor mu?
• İnceleyen kişi hangi commit’i gördüğünü anlayabiliyor mu?

Preview linkini “kimse tahmin edemez” düşüncesiyle güvenlik mekanizması saymayın. Netlify’nin proje görünürlüğü ve erişim kontrollerini kullanın.

8. Özel Alan Adı ve SSL Nasıl Eklenir?

İlk testler tamamlandıktan sonra projenize kendi domain’inizi ekleyebilirsiniz. İki ana yöntem vardır:

• Netlify DNS: Nameserver’ları Netlify’ye taşıyarak DNS’i platformda yönetmek.
• External DNS: DNS sağlayıcınızı koruyup gerekli A, ALIAS veya CNAME kayıtlarını tanımlamak.

Önce domain’i Netlify projesine ekleyin, ardından dashboard’un gösterdiği güncel kayıtları DNS sağlayıcısında uygulayın. www gibi alt alan adlarında CNAME yaygındır; apex/root domain’de sağlayıcının ALIAS veya CNAME flattening desteğine göre yöntem değişebilir. Eski bloglardaki IP’yi kopyalamak yerine her zaman güncel Netlify domain dokümanını ve proje ekranını kullanın.

DNS yayıldıktan ve sahiplik doğrulandıktan sonra Netlify HTTPS sertifikası sağlayabilir. DNS değişikliği dakikalar içinde görünebildiği gibi 24–48 saat, bazı durumlarda daha uzun sürebilir. Bu süre boyunca art arda rastgele kayıt değiştirmek çözümü geciktirebilir.

9. Netlify Nasıl Güncellenir ve Geri Alınır?

Git akışında güncelleme normalde production branch’e merge ile yapılır. Netlify yeni bir atomik deploy oluşturur. Önceki sürüm dosyaları yerinde değiştirilmediği için hatalı release durumunda daha önce çalışan deploy tekrar yayınlanabilir.

Drop akışında ise yeni build klasörünü manuel yüklemek gerekir. Bu yöntem hızlıdır ancak değişikliğin hangi commit’ten geldiği, kim tarafından yapıldığı ve review süreci Git kadar görünür değildir.

Rollback, veritabanı değişikliklerini otomatik olarak geri çevirdiğiniz anlamına gelmez. Kod eski sürüme dönerken database schema ileri sürümde kalabilir. Migration stratejisini geriye uyumlu tasarlamak gerekir.

10. Kullanım ve Kredi Tüketimi Nasıl İzlenir?

Netlify’nin güncel Free, Personal ve Pro planları kredi tabanlıdır. Production deploy, compute, bandwidth, web request, form submission ve AI inference gibi kalemler kullanım yaratabilir. Branch deploy ve Deploy Preview sayısı ile production deploy maliyeti aynı biçimde değerlendirilmez; güncel kredi tablosunu pricing ve billing dokümanından kontrol edin.

İlk günden usage dashboard’unu izleyin. Özellikle şu davranışlar beklenenden fazla tüketim yaratabilir:

• Her küçük commit’i production’a yayınlamak,
• Büyük, optimize edilmemiş dosyaları sık indirtmek,
• Cache’siz dinamik Function yanıtları,
• Kontrolsüz bot veya API trafiği,
• Yüksek maliyetli modellerle tekrarlanan AI çağrıları.

Auto-recharge varsayılan olarak kapalı olabilir. Free plan sınırına ulaşınca projelerin davranışı ile ücretli planlardaki ek kredi seçenekleri aynı değildir; kritik production projesinde limit politikasını önceden belirleyin.

İlk Deploy Kontrol Listesi

• [ ] Yerel production build başarılı.
• [ ] Build command ve publish directory doğrulandı.
• [ ] Production branch doğru seçildi.
• [ ] Secret’lar Git geçmişinde bulunmuyor.
• [ ] İç rotalar ve 404 sayfası test edildi.
• [ ] Preview erişimi ve verileri kontrol edildi.
• [ ] Domain/DNS kayıtları güncel dokümana göre ayarlandı.
• [ ] HTTPS aktif ve mixed-content hatası yok.
• [ ] Usage bildirimleri gözden geçirildi.
• [ ] Rollback ve migration planı yazıldı.

> Editör notu — zorunlu uygulama kanıtı: Bu taslak hazırlanırken yeni bir hesap üzerinde ekran ekran deploy yapılmadı. Yayından önce temiz bir test hesabıyla Git ve Drop akışları uygulanmalı; kullanılan UI adları, build logu, production görünürlük adımı, domain ekranı ve toplam adım sayısı görsellerle doğrulanmalıdır.

> Görsel notu: Kayıt → proje ekleme → build ayarları → deploy logu → project URL → custom domain akışını gösteren numaralı ekran görüntüsü serisi hazırlanmalıdır. Test hesabında gerçek secret veya kişisel veri görünmemelidir.

> İç link editör notu: İlgili içerikler yayınlandıktan sonra GitHub deploy, Netlify Drop, domain bağlama ve environment variables rehberlerine bağlantı eklenmelidir.

Sık Karşılaşılan Hatalar

“Page not found” hatası

Publish directory yanlış olabilir veya SPA route fallback kuralı eksiktir. Deploy logunda hangi klasörün yayınlandığını kontrol edin. React Router gibi client-side routing kullanan projelerde /about isteğini uygulamanın index. html dosyasına rewrite etmek gerekebilir.

Build yerelde çalışıyor, Netlify’da çalışmıyor

Node sürümü, büyük-küçük harf duyarlılığı, eksik environment variable, lockfile farkı veya monorepo base directory ayarı neden olabilir. Logdaki ilk hata satırından ilerleyin.

Site açılıyor ama eski içerik görünüyor

Yanlış deploy URL’sine bakıyor, production yerine preview’ı inceliyor veya browser/service-worker cache’i kullanıyor olabilirsiniz. Deploy ID ve production publish durumunu karşılaştırın.

Domain doğrulanmıyor

Çakışan A/AAAA/CNAME kayıtları, yanlış nameserver veya henüz tamamlanmamış DNS yayılımı olabilir. Aynı hostname için eski kayıtları ve CAA kısıtlarını kontrol edin.

Kaynaklar

• Choose your path on Netlify
• Create deploys
• Netlify Drop quickstart
• Netlify CLI
• Build configuration
• Environment variables
• Custom domains
• Project visibility

Sonuç

Netlify nasıl kullanılır sorusunun pratik cevabı, doğru yayınlama yolunu seçmekle başlar. Tek seferlik, build edilmiş statik bir klasör için Drop hızlıdır; düzenli geliştirilen uygulamada Git bağlantısı, otomatik deploy ve Deploy Preview daha sürdürülebilir bir akış sunar. İlk deploy’dan sonra yalnız linkin açılmasına değil, routing, environment variables, preview erişimi, domain, SSL, rollback ve kredi tüketimine de bakılmalıdır.

Bu başlangıç adımlarını uygulamak için [ücretsiz Netlify hesabı oluşturabilirsiniz](https://join. netlify. com/wmkqymu1heo2). Bu bir iş ortaklığı bağlantısıdır; bağlantı üzerinden kayıt olmanız veya ücretli plana geçmeniz halinde Ortak Alan komisyon kazanabilir.