DeployerPHP zero-downtime deploy'da OPcache'ten gelen 500 hatalarını nasıl engellerim?
Soru
DeployerPHP ile deploy ediyoruz: `releases/X` oluşuyor, `composer install` çalışıyor, asset'ler derleniyor, en son `current` symlink yeni klasöre dönüyor. Bu symlink değişiminde PHP-FPM'in OPcache'inde eski kodlar kaldığı için (cache poisoning) 500 hataları çıkıyor. Pipeline'a `php-fpm reload` ve OPcache temizliğini güvenli şekilde nasıl entegre ederim?
Cevap
Kısa cevap
Symlink çevirmek atomik ama yeterli değil — flip’ten sonra PHP-FPM’i graceful reload etmeniz lazım; OPcache’i hiçbir release’ten sonra eski koda yapışık bırakmayın.
Bağlam
Yaşadığınız şey klasik OPcache cache poisoning: OPcache, derlenmiş bytecode’u dosya yoluna göre keyler. Yani sorun deploy aracınızda değil, kodun bellekte nasıl tutulduğunda — Octane kullanıyorsanız aynı mesele bir kat daha derinleşiyor; kalıcı süreç modelini Octane yazısında temelden anlatmıştım.
Neden
-
currentsymlink’inin kendi yolu hiç değişmez. Bu yüzden worker’lar bir önceki release’in bytecode’unu sunmaya devam eder; bazı worker’lar eski, bazıları yeni realpath’i görünce dosya yolları karışır ve 500 patlar. -
opcache.revalidate_freq’i ayarlamak tek başına çözüm değil. Aynı dosya yolu değiştiğinde işe yarar; ama release’ler arası yol farkında revalidate sizi kurtarmaz. Release sınırında garantili olan reset/reload’dur. -
Octane bambaşka bir hikaye. Octane’de kod diskten değil bellekten sunulur; uzun ömürlü worker’lar eski sınıfları RAM’da tutar. Bu yüzden OPcache’i ne yaparsanız yapın, worker’ları yenilemedikçe eski kod ayakta kalır.
Ne yapmalı
-
En temiz yol: symlink’ten sonra PHP-FPM’i graceful reload edin.
kill -USR2 <fpm-master>ya dasystemctl reload php-fpm— bu, FPM’in yenirealpath’i görmesini sağlar ve OPcache’i tazeler. Reload, restart değil: mevcut istekler tamamlanır, yeni worker’lar yeni kodu derler, kesinti olmaz. Deployer’da bunudeploy:symlinkadımına hook’layın. -
Alternatif:
opcache_reset()’i deploy hook’undan çağırın. FPM soketinecachetoolile bağlanıp cache’i resetlemek, web’den bir reset endpoint’i tetiklemekten daha temiz — CLI ve FPM ayrı OPcache tutar, yaniphp artisanile resetlemek FPM’i etkilemez. Reload bunu zaten kapsadığı için çoğu zaman gerek kalmaz. -
Octane’deyseniz symlink flip’ten sonra
php artisan octane:reloadçalıştırın. Worker’ları bu komutla yenilemeniz şart; aksi halde bellekteki eski sınıflar yerinde kalır ve OPcache tarafında yaptığınız hiçbir şey işe yaramaz.
Sonuç: Akış net olsun — symlink’i çevirin → PHP-FPM’i graceful reload edin (Octane’deyseniz octane:reload) → isterseniz opcache_reset. Bunu Deployer’da symlink adımına bağlayın ve bir release’ten sonra OPcache’i asla eski koda yapışık bırakmayın. Octane’in bellekte kod tutmasının deploy tarafındaki bedeli ayrı bir hub yazısının konusu; oradaki kalıcı-süreç modelini iyi tanırsanız bu reload adımını atlamazsınız.
Sahada karşılaşılan ve bana sorulan sorulardan derlendi.
İlgili Yazılar
Yorumlar
Yorum yapmak için GitHub hesabınızla giriş yapmanız yeterli. Yorumlar GitHub Discussions üzerinde saklanır.