Bu rehber, production orkestrasyonu yazısında anlattığım süreci, kendi projeniz için tekrarlanabilir adımlara döküyor. Hedef: bir AI ajanı (Claude Code) kullanarak bir projeyi Docker ile VPS’e deploy etmek, GitHub’dan otomatik yayınlamak, ve arama motorlarına (Google, Bing) görünür hale getirmek.
1. Adım: VPS + Docker + Reverse Proxy
Projenizi bir container’a alın (Dockerfile) ve bir reverse proxy’nin (Traefik, Nginx veya Caddy) arkasına koyun — asla portu doğrudan 0.0.0.0’a açık bırakmayın, her zaman bir proxy katmanı olsun. Claude Code’a bu adımda verilecek görev net: “Bu Go/Node/Python uygulamasını multi-stage bir Dockerfile ile containerize et, non-root kullanıcı kullan, image boyutunu optimize et.” Hazır bir Dockerfile şablonuna ihtiyacınız varsa Dockerfile & Compose Jeneratörü aracımı kullanabilirsiniz; mevcut bir Dockerfile’ı güvenlik/boyut açısından denetlemek için Dockerfile Denetleyici’yi deneyin.
2. Adım: Cloudflare — Hem Hız Hem Güvenlik
Domain’inizi Cloudflare’e bağlayın (proxied/“orange cloud”), SSL modunu Full (strict) yapın (Flexible modda Cloudflare↔origin arası şifresiz kalır). Origin sertifikasını (Cloudflare dashboard → SSL/TLS → Origin Server) reverse proxy’nize yükleyin. En kritik adım burada: VPS’inizin firewall’ını, sadece Cloudflare’in yayınladığı IP aralıklarından 80/443 trafiği kabul edecek şekilde kısıtlayın (https://www.cloudflare.com/ips-v4 ve ips-v6). Bunu yapmazsanız, biri origin IP’nizi bulup Cloudflare’i tamamen atlayabilir — WAF’ınız, rate limit’iniz, her şeyiniz devre dışı kalır. Kendi _headers/_redirects kurallarınızı hızlıca üretmek için Cloudflare Rules Generator’ı kullanabilirsiniz.
Önemli not (bu sitede yaşadığımız): Docker kullanıyorsanız, VPS’in kendi işletim sistemi seviyesindeki firewall’ı (firewalld/ufw) bu kısıtlamayı uygulayamayabilir — Docker, yayınladığı portlar için kendi NAT kurallarını ekler ve bu, OS firewall’ının INPUT zincirini atlar. Çözüm: ya Docker’ın kendi DOCKER-USER zincirine doğrudan kural eklemek, ya da (daha güvenilir) VPS sağlayıcınızın guest OS’tan bağımsız çalışan bir network-level firewall API’si sunup sunmadığını kontrol etmek.
3. Adım: GitHub’dan Otomatik Yayın
Frontend’iniz statik veya Node tabanlıysa, Cloudflare Pages / Vercel / Netlify gibi bir servisin GitHub entegrasyonunu kullanın — master’a her push, otomatik build+deploy tetikler, ek bir CI/CD pipeline’ı yazmanıza gerek kalmaz. Backend/API tarafı için (container olarak deploy ediyorsanız) bir GitHub Action ile VPS’e SSH üzerinden image build+restart tetiklenebilir, ya da (bu sitede yaptığımız gibi) manuel/yarı-otomatik bir deploy akışı tercih edilebilir — otomasyonun karmaşıklığı, deploy sıklığınızla orantılı olmalı.
4. Adım: Arama Motorlarına Bağlanmak
Üç ayrı entegrasyon gerekiyor, üçü de farklı mekanizmalarla çalışıyor:
- Google Search Console — bir Google Cloud servis hesabı oluşturup (Search Console API + Analytics Data API etkinleştirilmiş bir projede), bu hesabı GSC mülkünüze “kullanıcı” olarak ekleyin. Servis hesabının JSON key’i ile Node’un yerleşik
cryptomodülünü kullanarak RS256 imzalı bir JWT oluşturup token alabilirsiniz — Python/google-auth kütüphanesine ihtiyacınız yok. - Bing Webmaster — çok daha basit: bing.com/webmasters’tan tek bir API key alıyorsunuz, ek kurulum yok.
- IndexNow — Bing/Yandex/Naver/Seznam/Yep’in paylaştığı protokol (Google desteklemiyor). Bir key dosyası yayınlayıp, içerik değiştiğinde
api.indexnow.org’a tek bir POST isteğiyle URL listesi gönderiyorsunuz — her yeni/değişen sayfa dakikalar içinde bu motorlara bildiriliyor.
Google için IndexNow’un eşdeğeri yok — eski /ping?sitemap= endpoint’i 2023’te kaldırıldı (artık 404 dönüyor). Google’a otomatik sitemap bildirimi için gerçek ve çalışan yol, Search Console API’sinin sitemaps.submit metodu — aynı servis hesabı kimlik bilgisiyle, her deploy sonrası tetiklenebilir.
5. Adım: Hepsini Tek GitHub Action’da Birleştirmek
Her push’ta build’in sonunda şunları yapan bir adım ekleyin: sitemap’teki tüm URL’leri oku, IndexNow’a toplu gönder, ardından aynı URL listesini (veya sadece sitemap feed’ini) Search Console API’sine bildir. Böylece her içerik değişikliği, elle hiçbir şey yapmadan dakikalar içinde üç ayrı arama motoruna ulaşır.
Sonuç
Bu beş adımın hiçbiri tek başına karmaşık değil — zorluk, hepsini doğru sırayla ve her adımı doğrulayarak birleştirmekte. Bir AI ajanının buradaki asıl faydası, bu adımların her birinde gereken (Docker networking, Cloudflare API, OAuth/servis hesabı akışları, GitHub Actions syntax’ı) farklı bilgi alanlarını aynı oturumda, hatasız şekilde bir araya getirebilmesi — ve bir adım yanlış gittiğinde (bu sitede firewall denemesinde olduğu gibi) bunu hemen fark edip geri alabilmesi.