
VDS'te Laravel Queue ve Horizon Kurulumu
Laravel kuyruklarını VDS üzerinde Horizon ile çalıştırın: gereksinimler, Redis bağlantısı, Supervisor yönetimi ve panel güvenliği tek rehberde.
Laravel Horizon, kuyruk işlerini Redis üzerinden izleyen ve yöneten bir panel sunar. VDS'te Laravel Horizon kurulumu; PHP, Composer, Redis ve Supervisor bileşenlerinin doğru sırayla yapılandırılmasıyla tamamlanır. Büyükweb Linux hosting paketlerinde SSH, terminal ve komut satırı erişimi yoktur; bu adımlar SSH ile bağlanabildiğiniz VDS sunucusunda uygulanır. Laravel kuyrukları için VDS sunucu seçerken işlemci, bellek ve disk türünü kuyruk yükünüze göre planlamanız gerekir.
Kısa cevap:
- Horizon, Redis tabanlı kuyruk bağlantısı ister; veritabanı sürücüsüyle panel çalışmaz.
- Supervisor, Horizon komutunu arka planda ayakta tutan ve süreç beklenmedik şekilde durduğunda yeniden başlatan süreç yöneticisidir.
- Timeout işin gerçek süresine, deneme sayısı ise işin tekrar çalıştırılabilirliğine göre ayarlanır.
- Panel yalnız yetkili kullanıcılara açık tutulmalı ve HTTPS üzerinden erişilmelidir.
Laravel Queue ve Horizon İçin VDS Gereksinimleri
Horizon kuyruk işlerini Redis üzerinden izler, panelde canlı görünüm sağlar ve işlerin durumunu tek yerden yönetmenize yardımcı olur. Bu nedenle sunucuda PHP ile Redis servisinin birlikte çalışması gerekir. Kuyruk işleri arka planda sürekli döndüğü için sunucu kaynakları tek seferlik bir web isteğinden daha uzun süre meşgul olur; bu yük, eşzamanlı iş sayısı, süreç sayısı ve işlerin bellek ihtiyacıyla birlikte planlanmalıdır.
VDS seçerken eşzamanlı iş sayısını ve işlerin bellek ihtiyacını düşünün. Görsel işleme, dosya dönüştürme gibi ağır işler daha fazla bellek ve işlemci payı ister. Yalnız e-posta gönderimi gibi hafif işler için daha küçük bir yapılandırma yeterli olabilir. Disk tarafında NVMe disk, veritabanı ve log yazımının yoğun olduğu anlarda bekleme süresini kısaltır.
| Bileşen | Görevi | Nasıl kontrol edilir |
|---|---|---|
| PHP | Laravel uygulamasını çalıştırır | php -v |
| Composer | PHP paketlerini kurar | composer --version |
| Redis | Kuyruk verisini tutar | redis-cli ping |
| Supervisor | Horizon sürecini yönetir | supervisorctl status |
| SSH erişimi | Kurulum komutlarını çalıştırır | Terminal bağlantısı |
Büyükweb Linux hosting paketlerinde SSH, terminal ve komut satırı erişimi yoktur; bu yüzden kurulum komutlarını çalıştıramazsınız. Aradaki farkı hosting'de SSH ve terminal kullanımı yazısında bulabilirsiniz. Hangi ortamın size uyduğunu görmek için Laravel için hosting seçimi rehberine göz atın.
VDS'te Composer, PHP ve Redis Hazırlığı
Sunucunuza SSH ile bağlanın ve paket listesini güncelleyin. PHP sürümünün projenizin istediği sürümle uyumlu olduğunu doğrulayın. Laravel'in ihtiyaç duyduğu yaygın eklentileri baştan kurmak, kurulum sırasında yaşanan eksik eklenti hatalarını önler.
sudo apt update
php -v
composer --version
Composer kurulu değilse resmi yöntemle kurun ve sürümü doğrulayın. Ardından Redis servisini kurup başlatın.
sudo apt install redis-server
sudo systemctl enable redis-server
sudo systemctl status redis-server
redis-cli ping
ping komutuna PONG yanıtı gelmesi servisin ayakta olduğunu gösterir. Redis'i kuyruk için kullanırken noeviction politikasını tercih edin; aksi halde bellek dolduğunda anahtarlar tahliye edilebilir ve bekleyen işler kaybolabilir. Bellek sınırını sunucunun toplam belleğine göre planlayın ve Redis'e diğer servislerle ortak kullanacağı payı bırakın.
Projeyi sunucuya kopyaladıktan sonra bağımlılıkları üretim modunda kurun. Geliştirme paketlerini dahil etmeyin.
composer install --no-dev --optimize-autoloader
Redis'in kurulum ve önbellekleme tarafını daha geniş okumak isterseniz Redis kurulumu ve önbellekleme yazısına bakabilirsiniz. Sunucuyu sıfırdan hazırlıyorsanız VDS sunucu kurulumu rehberi adımları takip etmenizi kolaylaştırır.
Kuyruk Bağlantısı ve Horizon Yapılandırması
Önce ortam dosyasında kuyruk bağlantısını Redis olarak ayarlayın. Aynı dosyada Redis sunucu adresi ve portu için ortam değişkenleri bulunur; sunucu ve uygulama aynı makinedeyse yerel adres kullanılabilir.
QUEUE_CONNECTION=redis
REDIS_HOST=127.0.0.1
REDIS_PORT=6379
Önce composer require laravel/horizon ile paketi kurun, ardından Horizon kurulum komutunu çalıştırın.
php artisan horizon:install
Bu komut config/horizon.php dosyasını yayımlar ve Horizon paneli için gerekli yapılandırmayı ekler. Yapılandırma dosyasındaki environments bölümünde her ortam için süreç sayısını ve kuyruk listesini tanımlarsınız. Horizon'da balance ayarı auto seçildiğinde süreçler kuyruk yüküne göre dağıtılır; kuyruk sırasını öncelik olarak kullanmak için bu ayarı kapatabilirsiniz, ancak bu değişiklik çalışan uzun işleri kesmez.
Üretim ortamında tek süreç yerine iş yüküne uygun sayıda süreç vermek, kuyruğun birikme olasılığını azaltır. Süreç sayısını artırdıkça bellek tüketiminin de arttığını unutmayın; sunucu kaynaklarını izleyerek denge kurun.
Ayarları değiştirdikten sonra yapılandırma önbelleğini yenileyin ve Horizon'u elle bir kez çalıştırıp hata olmadığını görün. Panel adresini tarayıcıda açtığınızda kuyruk ve iş listeleri görünmelidir. Bu aşamada süreç ön planda çalışır; kalıcı hale getirmek için süreç yöneticisi gerekir.
Supervisor ile Horizon Sürecini Yönetme
Supervisor, Horizon komutunu arka planda tutan, ayarlandığında sunucu açılışında devreye giren ve süreç beklenmedik şekilde durduğunda yeniden başlatan süreç yöneticisidir. Önce Supervisor paketini kurun, sonra Horizon için bir yapılandırma dosyası oluşturun.
- Supervisor paketini kurun.
/etc/supervisor/conf.d/altındahorizon.confdosyasını oluşturun.- Komut, çalışma dizini ve kullanıcı bilgilerini projenize göre yazın.
- Yapılandırmayı yeniden okuyup süreci başlatın.
- Durumu ve log dosyasını kontrol edin.
[program:horizon]
process_name=%(program_name)s
command=php /var/www/proje/artisan horizon
autostart=true
autorestart=true
user=www-data
redirect_stderr=true
stdout_logfile=/var/www/proje/storage/logs/horizon.log
stopwaitsecs=3600
Dosyayı kaydettikten sonra Supervisor'a yeni ayarı okutun ve süreci başlatın.
sudo supervisorctl reread
sudo supervisorctl update
sudo supervisorctl status
Durum çıktısında süreç RUNNING görünmelidir. Görünmüyorsa log dosyasındaki son satırlara bakın; hataların çoğu yanlış proje yolu veya eksik PHP eklentisinden kaynaklanır. user değerinin proje dosyalarına yazma yetkisi olan kullanıcı olduğundan emin olun. Sunucu yeniden başladığında Supervisor servisi etkinse ayarları kendiliğinden devreye girer.
Timeout, Retry ve Başarısız İşleri Düzenleme
Bir iş beklenenden uzun sürerse kuyruk onu başarısız sayabilir. Timeout değerini işin gerçekçi süresine göre belirleyin; çok kısa değer sağlıklı işleri keser, çok uzun değer takılan işlerin kuyruğu tıkamasına yol açar. Deneme sayısını da işin tekrar çalıştırılabilir olup olmadığına göre seçin.
Başarısız işleri artisan komutlarıyla inceleyebilirsiniz.
php artisan queue:failed
php artisan queue:retry 5
queue:failed başarısız işleri listeler, queue:retry tek bir işi yeniden kuyruğa alır. queue:flush tüm başarısız iş kayıtlarını siler ve bu kayıtlardan yeniden denemeyi engeller; yalnızca bu veri kaybını göze alıyorsanız isteğe bağlı temizlik adımı olarak kullanın. Horizon'daki başarısız iş kaydını silmek için horizon:forget komutunu iş kimliğiyle kullanın. Aynı işin iki kez çalışması veri bozabilir; bu yüzden işleri tekrar çalıştırıldığında aynı sonucu verecek şekilde tasarlayın. Ödeme, stok ve bildirim gibi kritik işlemlerde bu kural özellikle önemlidir.
Kuyruk yapılandırmasındaki yeniden deneme bekleme süresi ile iş timeout'u arasında tutarlılık olmalıdır. Redis kuyruk bağlantısındaki retry_after değeri, ayrılmış işin yeniden alınabilir olacağı süreyi belirler; Horizon timeout değeri bu değerden birkaç saniye kısa olmalıdır, yoksa aynı iş iki süreç tarafından eşzamanlı ele alınabilir. Horizon panelinde başarısız işlerin hata mesajını ve deneme sayısını görebilirsiniz. Aynı hatayı tekrar tekrar alıyorsanız sorun çoğunlukla işin kendisindedir; kuyruk ayarlarını değiştirmek tek başına çözüm olmaz.
Horizon Panelini Koruma ve Dağıtım Sonrası Yenileme
Horizon paneli, uygulamanızın bir yolu üzerinden erişilir; kuyruk verilerini, süreçleri ve başarısız işleri gösterir. Bu nedenle herkese açık bırakılmamalıdır. Yetkilendirmeyi Horizon servis sağlayıcısındaki kontrol üzerinden yapın ve paneli yalnız yönetici rolündeki kullanıcılara açın. Erişimi sunucu düzeyinde kısıtlamak isterseniz web sunucusu ayarlarında adres sınırı da tanımlayabilirsiniz.
Panelin yalnız HTTPS üzerinden açılmasına dikkat edin; oturum bilgileri, kuyruk içeriği ve panel verileri ağ üzerinde açık gitmemelidir. Yetkisiz erişim girişimlerini görmek için web sunucusunun erişim kayıtlarını düzenli olarak izleyin.
Yeni sürüm yayına aldığınızda çalışan Horizon süreci eski kodu bellekte tutmaya devam eder. Dağıtım sonunda süreci nazikçe yeniden başlatın.
php artisan horizon:terminate
Bu komut mevcut işlerin bitmesini bekler ve süreci kapatır; Supervisor süreci kısa süre içinde yeni kodla yeniden başlatır. Yapılandırma önbelleğini de yenilemeyi unutmayın. Kurulumu tamamladıktan sonra kuyruğu birkaç gün izleyin; işler birikmeye başlıyorsa süreç sayısını ya da sunucu kaynaklarını artırma zamanı gelmiş olabilir. İhtiyacınıza uygun yapılandırmayı VDS sunucu paketlerini karşılaştırarak planlayabilirsiniz.
Sık Sorulan Sorular
Horizon yerine queue:work kullanabilir miyim?
Kullanabilirsiniz, ancak queue:work komutu panel ve iş izleme sunmaz. Kuyruk davranışını görmek, başarısız işleri panelden incelemek ve süreçleri tek yerden yönetmek istiyorsanız Horizon daha uygundur. Küçük ve tek kuyruklu projelerde queue:work yeterli olabilir. Horizon seçerseniz Redis bağlantısını ve Supervisor ayarını birlikte kurmanız gerekir.
Horizon paneli neden boş görünüyor?
Bekleyen iş yoksa listeler boş görünür. Kuyruk bağlantısı yanlışsa işler başka sürücüye yazılır ve panelde hiç görünmez. Ortam dosyasındaki kuyruk ayarını ve yapılandırma önbelleğini kontrol edin. Panelde süreç de görünmüyorsa Supervisor durumunu ve log dosyasını inceleyin.
Redis yerine veritabanı kuyruğu kullanılabilir mi?
Uygulama veritabanı sürücüsüyle kuyruk çalıştırabilir, ancak Horizon yalnızca Redis ile çalışır. Panel kullanmak istiyorsanız Redis kurulumu zorunludur. Veritabanı sürücüsü yoğun yükte tabloyu daha fazla meşgul edebilir; bu nedenle kuyruk hacmi büyüdükçe Redis daha uygun bir seçenek olur.
Supervisor olmadan Horizon çalışır mı?
Elle başlattığınızda çalışır, fakat terminal oturumu kapanınca süreç de durur. Sunucu yeniden başladığında kendiliğinden açılmaz. Kuyruğun sürekli çalışması gerekiyorsa Supervisor gibi bir süreç yöneticisi kullanın. Bu yönetici ayrıca süreç beklenmedik şekilde kapandığında onu yeniden başlatır.
Güncelleme sonrası Horizon'u yeniden başlatmak gerekir mi?
Evet. Çalışan süreç eski kodu bellekte tuttuğu için yeni sürüm devreye girmez. Dağıtım sonunda php artisan horizon:terminate komutunu çalıştırın; Supervisor süreci yeni kodla yeniden başlatır. Yapılandırma önbelleğini de yenilemek, ayar değişikliklerinin etkili olmasını sağlar.
Sunucu Yönetimi İlgili Hizmetlerimiz
Bu yazıda anlatılan teknik konuyu profesyonel altyapıyla deneyimleyin
Etiketler:

