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

Kaynak: https://3dsinifi.com/haber/blender-flamenco-render-ciftligi-nasil-kurulur-manager-ve · Kategori: Eğitimler · Yayın: 26 Ekim 2026

> Blender Flamenco ile render işlerini Manager ve Worker’lar arasında dağıtmayı öğrenin. Rehber; yapılandırma dosyalarını, ortak depolamayı, görev türlerini ve sık karşılaşılan ayar hatalarını ele alıyor.

## Kısaca
- Flamenco Manager ayarlarını flamenco-manager.yaml dosyasından okur; dosya yoksa kurulum asistanı başlatır.
- Worker’lar Manager’a bağlanır ve Blender render’ı dâhil izin verilen görev türlerini yürütür.
- Manager ile Worker’ların dosya alışverişi için ortak depolama yolu yapılandırılır.
- Her Worker’ın kimlik bilgileri ve görev güncelleme veritabanı kendine özgü dosyalarda tutulur.

## 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:

```yaml
_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.

2. **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:

```yaml
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.

3. **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.

4. **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.

## Pro ipucu
İlk render işinden önce Manager ve Worker’ların `shared_storage_path` üzerinden aynı iş dosyalarına ve çıktı konumuna erişebildiğini doğrulayın.

## 3dsınıfı yorumu
Türkiye’deki mimarlık ofisleri ve archviz ekipleri için Flamenco’nun pratik katkısı, Blender işlerini bir Manager üzerinden Worker’lara dağıtabilmesi ve render önizlemelerini Manager tarafında sunabilmesi. Birden fazla makineyi iş akışına katmadan önce ortak depolama yollarını ve her Worker’ın alacağı görev türlerini netleştirmek, deneme sürecini daha yönetilebilir kılar.

Resmî kılavuzlar fiyat, lisans koşulları, donanım gereksinimleri veya Blender sürüm uyumluluğu konusunda bilgi vermiyor. Bu nedenle maliyet ve donanım kararları mevcut ofis ortamına göre ayrıca değerlendirilmelidir. Özellikle yoğun işlerde Worker hatalarını takip etmek ve önce küçük bir kurulumla ayarları doğrulamak, üretim öncesi riskleri görünür kılabilir.

## Kaynaklar
- [flamenco.blender.org](https://flamenco.blender.org/usage/manager-configuration/) (özet)
- [flamenco.blender.org](https://flamenco.blender.org/usage/worker-configuration/) (özet)
- [flamenco.blender.org](https://flamenco.blender.org/usage/jobs-tasks-commands/) (özet)

_Yapay zekâ ile yazıldı, kaynaklarla doğrulandı. © 3dsınıfı_