Blender Flamenco render çiftliği nasıl kurulur: Manager ve Worker ayarları

Bu rehberde ne öğreneceksiniz?

Blender Flamenco, render işlerini Manager ve Worker bileşenleri arasında paylaştırmak için kullanılan bir iş akışı sunar. Bu rehberde Manager ve Worker yapılandırma dosyalarının görevlerini, ortak depolama yolunun nasıl belirleneceğini ve Worker’ların hangi tür işleri alabileceğini adım adım ele alacağız. Ayrıca Blender render komutunun ne yaptığına ve yapılandırma sırasında kontrol edilmesi gereken noktalara değineceğiz.

Manager işleri yönetirken Worker’lar görevleri yürütür. İş ve görev durumları ayrı ayrı izlenir; örneğin bir iş, görevleri başarıyla tamamlandığında tamamlanmış duruma geçebilir. Flamenco’nun komutları arasında Blender render’ı, FFmpeg ile görüntü dizisini videoya dönüştürme ve dosya yönetimi işlemleri bulunur.

Gerekenler ve yapılandırma dosyaları

Resmî kılavuzlar belirli bir Blender sürümünü, kurulum paketini, hesap gereksinimini veya lisans ücretini belirtmiyor. Bu nedenle burada belirli bir yazılım sürümü ya da donanım şartı varsayılmıyor. Örnekler, Manager ve Worker yapılandırmalarını düzenleyebilecek ve ortak depolama alanını ayarlayabilecek bir Flamenco ortamı bulunduğunu kabul ediyor.

Manager ayarlarını flamenco-manager.yaml dosyasından alır. Dosya, flamenco-manager çalıştırılabilir dosyasının yanında yer alır. Manager ilk kez çalıştırıldığında bu dosya yoksa yapılandırma asistanı açılır. Worker ise ana ayarlarını çalıştığı dizindeki flamenco-worker.yaml dosyasından okur. Bu ana dosya birden fazla Worker tarafından paylaşılabilir; ancak Worker kimlik bilgileri ve görev güncelleme veritabanı her Worker için ayrıdır.

Manager ve Worker’ı yapılandırma

1. Manager dosyasını oluşturun. İlk açılışta yapılandırma asistanını kullanın. Elle dosya hazırlamak gerekiyorsa aşağıdaki örnek, temel ayarları göstermektedir:

_meta:
  version: 3
manager_name: Flamenco Manager
database: flamenco-manager.sqlite
listen: ":8080"
autodiscoverable: true
local_manager_storage_path: ./flamenco-manager-storage
shared_storage_path: /path/to/storage
shaman:
  enabled: true
  garbageCollect:
    period: 24h
    maxAge: 744h

manager_name Manager’ın adını, database ise SQLite veritabanının dosya yolunu belirler. listen ayarı, Manager’ın hangi IP ve port üzerinden bağlantı kabul edeceğini tanımlar. Resmî belgede bu adresin web arayüzü, API ve Shaman üzerinden dosya gönderimi için kullanıldığı, Manager için gereken tek port olduğu belirtiliyor. autodiscoverable aynı ağdaki Worker’ların Manager’ı otomatik bulup bulamayacağını belirler.

Yerel Manager dosyaları için local_manager_storage_path, Manager ve Worker’ların birlikte eriştiği işler ve çıktılar için shared_storage_path kullanılır. Örnekteki /path/to/storage yolunu gerçek ortamda kullanılacak paylaşımlı konumla değiştirin. Shaman depolama sistemi isteğe bağlıdır; örnekte etkinleştirilmiş ve dosya temizliği için süreler gösterilmiştir.

1. Worker bağlantısını ve görev kapsamını belirleyin. Worker’ın ortak yapılandırma dosyasında Manager adresini ve kabul edeceği görev türlerini tanımlayabilirsiniz:

manager_url: http://flamenco.local:8080/
task_types: [blender, ffmpeg, file-management, misc]
restart_exit_code: 47

manager_url boş bırakılırsa veya kaldırılırsa Worker ağ üzerinden Manager’ı bulmayı dener. task_types ise Worker’a hangi görevlerin verilebileceğini sınırlar. Örnekteki liste, varsayılan iş derleyici betiklerinin kullandığı türleri içerir; kendi iş derleyici betikleriniz farklı türler üretiyorsa bu ayarlarla uyumunu kontrol edin. Sıfırdan farklı restart_exit_code değeri Worker’ın yeniden başlatılabilir olarak işaretlenmesini sağlar.

1. Worker’a özel dosyaları koruyun. Her Worker’ın flamenco-worker-credentials.yaml adlı kimlik bilgisi dosyası ve Manager’a ulaşılamadığında görev güncellemelerini sıraya alan flamenco-worker.sqlite veritabanı bulunur. Bunlar ana yapılandırma dosyasından ayrıdır ve elle düzenlenmek için tasarlanmamıştır. Kılavuzdaki varsayılan konumlar Linux’ta $HOME/.local/share/flamenco, Windows’ta C:\Users\UserName\AppData\Local\Blender Foundation\Flamenco, macOS’ta $HOME/Library/Application Support/Flamenco şeklindedir.

2. Bir Blender işini takip edin. Blender render görevleri blender-render komutuyla yürütülür. Komut, Blender çalıştırılabilir dosyasını, açılacak .blend dosyasını ve iş derleyici betiğinden gelen ek argümanları kullanır. Çalıştırılabilir dosya blender olarak tanımlanırsa Worker programı arar; Windows’ta .blend dosya ilişkilendirmesinden de yararlanabilir. Render sırasında üretilen görseller, Worker tarafından Manager tarafında önizleme olarak görüntülenebilecek şekilde iletilir.

İşler ve görevler farklı durumlarla izlenir. Kuyruktaki görevler uygun Worker’lara atanabilir; görevlerin tümü başarılı olursa iş tamamlanır. Bir görevin farklı Worker’larda tekrar denendikten sonra da başarısız olması, işin başarısız duruma geçmesine yol açabilir. Tamamlanmış bir işi yeniden kuyruğa almak bütün görevleri yeniden sıraya alırken, içinde tamamlanmamış görev bulunan bir işte yalnızca bu görevler yeniden kuyruğa alınır.

Mimarlık, iç mekân ve archviz iş akışına etkisi

Blender kullanan mimarlık ofisleri ve görselleştirme ekipleri, birden fazla Worker’ı aynı iş akışına ekleyerek render görevlerini dağıtabilir. Her Worker’ın görev türlerini sınırlamak, makinelerin Blender render’ı, dosya yönetimi veya FFmpeg gibi hangi işleri üstleneceğini düzenlemeye yardımcı olur. Animasyon çıktılarında görüntü dizisini videoya çeviren FFmpeg komutu da belgelenen seçenekler arasındadır.

Kurulumda dosya erişimi ve uyumluluk özellikle önemlidir. .blend dosyalarının ve render çıktılarının Manager ile Worker’ların erişebildiği ortak depolamada bulunması gerekir. Ayrıca task_types ayarları, iş derleyici betiklerinin ürettiği görevlerle örtüşmelidir. Kılavuzda tekrar eden görev hatalarının, işin bir Worker’ın donanımına ağır gelebileceği değerlendirmesiyle ilişkilendirildiği belirtiliyor; bu nedenle işlerin başarısızlık durumlarını takip etmek yararlı olur. Belgeler donanım gereksinimi, Blender sürüm uyumluluğu veya lisans maliyeti vermediğinden bu konular kullanılan ortam için ayrıca doğrulanmalıdır.

Sık karşılaşılan hatalar

• Yanlış depolama yolunu kullanmak: Manager’ın yerel depolama dizini ile paylaşılan depolama alanı aynı amaçta değildir. İş dosyaları ve render çıktıları için ortak konumu tanımlayın.

• Worker’ın görev alamaması: manager_url ve task_types ayarlarını, ayrıca iş derleyici betiklerinin ürettiği görev türlerini kontrol edin.

• Worker’a özel dosyaları ortak kullanmak: Kimlik bilgileri ve görev güncelleme veritabanı Worker’a özgüdür; ana yapılandırma dosyasıyla karıştırılmamalıdır.

• Sıfırlama sırasında eski kaydı bırakmak: Worker’ı sıfırlamak gerektiğinde Worker kapatılır, ilgili yerel dosyalar silinir ve Manager web arayüzündeki eski Worker kaydı da kaldırılır; ardından Worker yeniden başlatılır.

• İsteğe bağlı ayarları gereksiz yere eklemek: MQTT yapılandırması zorunlu değildir. Ne için kullanıldığı bilinmiyorsa bu bölümü yapılandırmaya eklememek önerilir.

Sonraki adımlar

Önce Manager ve tek bir Worker ile temel yapılandırmayı kontrol edin. Ardından iş dosyalarının ortak depolamadan erişilebilir olduğunu ve Worker’ın beklenen görev türlerini alabildiğini doğrulayın. Blender dışında görüntü dizisini videoya dönüştürmeniz gerekiyorsa frames-to-video komutunun ayarlarını inceleyin. Linux kullanılıyorsa isteğe bağlı oom_score_adjust ayarı da değerlendirilebilir; bu seçenek Linux’a özeldir, 0 ile 1000 arasında değer alır ve Flamenco v3.5’te eklenmiştir.

Kaynak ve lisans

Bu eğitim, Flamenco’nun Manager yapılandırması, Worker yapılandırması ve işler, görevler ile komutlar hakkındaki resmî, açık lisanslı kılavuzlarından Türkçeye uyarlanmıştır.