# Blender Flamenco nasıl yapılandırılır? Manager, Worker ve MQTT rehberi

Kaynak: https://3dsinifi.com/haber/blender-flamenco-nasil-yapilandirilir-manager-worker-ve · Kategori: Eğitimler · Yayın: 21 Kasım 2026

> Bu rehber, Blender Flamenco’da Manager ve Worker yapılandırma dosyalarının nasıl düzenleneceğini anlatıyor. Paylaşımlı depolama, görev türleri ve isteğe bağlı MQTT bildirimleri de ele alınıyor.

## Kısaca
- Manager ayarları, çalıştırılabilir dosyanın yanındaki flamenco-manager.yaml dosyasında tutulur.
- Worker’ın ana yapılandırması paylaşılabilir; kimlik bilgileri ve görev güncelleme veritabanı her Worker’a özeldir.
- Manager ile Worker’ların ortak iş dosyalarına erişmesi için shared_storage_path kullanılır.
- MQTT bildirimleri Manager yapılandırmasına eklenen isteğe bağlı bir bölümle açılır.

## Bu rehberde ne öğreneceksiniz?

Bu eğitimde Blender Flamenco render çiftliğinin temel yapılandırmasını düzenleyeceksiniz. Manager’ın nereden ayar okuduğunu, Worker’ların Manager’a nasıl bağlandığını, ortak depolama yolunun ne işe yaradığını ve MQTT bildirimlerinin nasıl etkinleştirildiğini göreceksiniz. Ayrıca Worker’lara özel kimlik bilgileri ile ortak kullanılabilen ana ayar dosyasının farkını öğreneceksiniz.

Flamenco Manager, render işlerini ve Worker’ları yöneten bileşendir. Worker’lar ise kendilerine izin verilen görev türlerini yürütür. Yapılandırma dosyaları YAML biçimindedir. Bu rehber mevcut Flamenco kurulumunun ayarlarına odaklanır; kurulum adımları veya kaynaklarda belirtilmeyen sistem gereksinimleri hakkında varsayım yapmaz.

## Gereksinimler ve dosyaların konumu

Flamenco Manager’ın yapılandırma dosyasının adı `flamenco-manager.yaml`’dır ve Manager çalıştırılabilir dosyasının yanında bulunur. İlk kez başlatıldığında dosya yoksa Manager, dosyayı oluşturmak için bir kurulum yardımcısı açar. Yardımcı kullanılamıyorsa yapılandırma elle oluşturulabilir.

Worker, ana ayarlarını bulunduğu çalışma dizinindeki `flamenco-worker.yaml` dosyasından okur. Bu dosya birden fazla Worker arasında paylaşılabilir. Buna karşılık Worker kimlik bilgilerini içeren `flamenco-worker-credentials.yaml` ile görev güncellemelerini sıraya alan `flamenco-worker.sqlite` dosyası Worker’a özeldir ve elle düzenlenmek üzere tasarlanmamıştır.

Ayarları uygulamadan önce Manager ve Worker yapılandırma dosyalarına erişim olduğundan emin olun. Paylaşımlı depolama kullanılıyorsa Manager ile Worker’ların ilgili dosyalara ulaşacağı yolu belirleyin. Kaynaklar, belirli bir Blender veya işletim sistemi sürümünü genel gereksinim olarak belirtmiyor. Worker yapılandırmasındaki `oom_score_adjust` seçeneği ise yalnızca Linux’ta kullanılabiliyor.

## Manager ve Worker ayarlarını adım adım düzenleme

1. **Manager yapılandırmasını açın veya oluşturun.** Manager’ı başlatarak kurulum yardımcısının yapılandırma dosyasını oluşturmasını sağlayabilir ya da çalıştırılabilir dosyanın yanına `flamenco-manager.yaml` ekleyebilirsiniz. Aşağıdaki örnek temel ayarların yanı sıra ortak depolama ve Shaman dosya depolama sistemi için örnek değerler içerir:

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

`listen`, Manager’ın web arayüzü, API’si ve Shaman üzerinden dosya gönderimi için kullandığı dinleme adresini ve portu belirler. `shared_storage_path`, Manager ile Worker’ların ortak kullandığı render çıktıları ve `.blend` iş dosyalarının bulunduğu konumu gösterir. `local_manager_storage_path` ise günlükler ve son render görüntüleri gibi yalnızca Manager’ın ihtiyaç duyduğu dosyalar içindir. Örnekteki `/path/to/storage` yer tutucusunu gerçek paylaşımlı depolama yoluyla değiştirin.

2. **Worker’ların Manager adresini ve görev türlerini tanımlayın.** Her Worker’ın çalışma dizinindeki `flamenco-worker.yaml` dosyasına bağlantı ve izin verilen görev türleri eklenebilir:

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

`manager_url`, Worker’ın bağlanacağı Manager adresidir. Bu ayar boş bırakılır veya kaldırılırsa Worker, Manager’ı ağda otomatik algılamaya çalışır. `task_types` listesi, Worker’ın hangi görev türlerini yürütebileceğini sınırlar; kullanılabilir görev türleri iş derleyici betiklerine bağlıdır. Örnekteki adresi kendi Manager adresinizle değiştirin ve Worker’a yalnızca yürütmesi gereken türleri verin. `restart_exit_code` sıfırdan farklı bir değer olduğunda Worker yeniden başlatılabilir olarak işaretlenir.

3. **İşletim sistemine göre değişen değerleri tanımlayın.** Manager yapılandırmasındaki `variables` bölümü, farklı işletim sistemlerinde kullanılacak değerlerin ayrı ayrı belirtilmesini sağlar. Değişken adının altında `values` listesi oluşturulur; her girdide bir platform ve o platforma ait değer yer alır. Kaynakta örneklenen platformlar `linux`, `windows`, `darwin` ve tüm platformları kapsayan `all` seçenekleridir. Örneğin Blender çalıştırma komutu işletim sistemine göre değişiyorsa bu bölümde her platform için uygun değer tanımlanabilir.

4. **İsteğe bağlı MQTT bildirimlerini ekleyin.** Manager, iç olaylarını bir MQTT aracısına iletebilir. `flamenco-manager.yaml` içine aşağıdaki bölümü ekleyin ve değişikliğin uygulanması için Manager’ı yeniden başlatın:

```yaml
mqtt:
  client:
    broker: "tcp://mqttserver.local:1883"
    username: "username"
    password: "your-password-here"
    topic_prefix: flamenco
```

Broker adresi `tcp://` veya `ws://` biçiminde olabilir. Anonim erişim kullanılacaksa `username` ve `password` anahtarları kaldırılabilir. `topic_prefix`, olayların konu adlarının başındaki bölümü belirler; örnek değer `flamenco` olduğunda iş güncellemeleri `flamenco/jobs` konusuna gönderilir. Örnekteki kullanıcı adı, parola ve broker adresini gerçek bağlantı bilgileriyle değiştirin. MQTT yapılandırması isteğe bağlıdır; etkinleştirildiğinde Manager’ın yeniden başlatılması gerekir.

## Yaygın hatalar ve dikkat edilecekler

**Ortak ve yerel depolamayı karıştırmayın.** İş dosyaları ve render çıktıları Manager ile Worker’ların paylaşması gereken içeriklerdir; bunların konumu `shared_storage_path` ile tanımlanır. Manager’ın kendi günlük ve son render görüntüsü dosyaları ise `local_manager_storage_path` altında tutulur. Bu iki ayarın farklı amaçları vardır.

**Worker’a özel dosyaları ortak yapılandırma sanmayın.** `flamenco-worker.yaml` paylaşılabilir; ancak kimlik bilgileri ve Worker’ın görev güncelleme veritabanı her Worker’a özgüdür. Worker’ı sıfırlamak gerekirse önce kapatılması, bu dosyaların silinmesi ve Manager’ın web arayüzündeki eski Worker kaydının da kaldırılması gerekir.

**Zaman aşımı ve başarısızlık ayarlarını anlayarak kullanın.** Manager’daki `task_timeout` ve `worker_timeout`, Worker’ın sorunlu veya zaman aşımına uğramış sayılmasında kullanılır. `blocklist_threshold`, bir işte belirli türdeki görevlerde başarısız olan Worker’ın o işte aynı görev türünden daha fazla almasını engelleyebilir. `task_fail_after_softfail_count` ise bir görev kesin olarak başarısız sayılmadan önce kaç Worker’ın o görevi başarısız tamamlamasına izin verileceğini belirler. Bu ayarların neyi değiştirdiğini bilmek, render çiftliğindeki sorunları incelerken önemlidir.

**MQTT’yi ihtiyaç yoksa eklemeyin.** Resmî yapılandırma rehberi, MQTT’nin amacı bilinmiyorsa ilgili bölümü boş bırakmayı öneriyor. MQTT açık olduğunda Manager yaşam döngüsü, çiftlik durumu, işler, görevler, Worker’lar ve son render görüntüleriyle ilgili olayları belirlenen konulara gönderebilir.

## Mimarlık, iç mimarlık ve archviz iş akışına etkisi

Birden fazla makinede Blender render’ı alan mimarlık ve görselleştirme ekipleri, Flamenco ile iş dağıtımını yapılandırırken öncelikle ortak dosya yolunu ve Worker görev izinlerini netleştirmelidir. İş dosyaları ile çıktılar için paylaşımlı depolama kullanılması, Manager ve Worker’ların aynı iş içeriğine erişmesi açısından önem taşır. `task_types` ayarı, bir Worker’ın hangi iş türlerini üstleneceğini belirlemeye yardımcı olur.

Worker yapılandırmasındaki `oom_score_adjust`, Linux’ta bellek yetersizliği durumunda Worker alt süreçlerinin nasıl değerlendirileceğini ayarlayan isteğe bağlı bir seçenektir. Kaynağa göre bu ayar 0 ile 1000 arasında bir değer alabilir. Değer yükseltildiğinde, render sırasında bellek tükendiğinde Blender’ın Flamenco Worker’dan önce sonlandırılması hedeflenir. Ekipler bu seçeneği yalnızca Linux kullanıyorsa ve belirtilen davranış kendi iş yükleri için uygunsa değerlendirmelidir. Rehber donanım satın alma önerisi veya lisans fiyatı vermiyor.

## Sonraki adımlar

Önce Manager ve Worker bağlantısını, ardından paylaşımlı depolama yolunu kontrol edin. Daha sonra Worker’lara verilecek görev türlerini belirleyin ve yapılandırmada kullanılan adreslerle örnek değerlerin gerçek ortamla eşleştiğini doğrulayın. MQTT’ye ihtiyaç varsa broker erişim bilgilerini ekleyip Manager’ı yeniden başlatın. Olayları dinleyen istemciler, yapılandırılmış konu önekini ve Flamenco’nun kullandığı konu adlarını dikkate almalıdır.

## Kaynak ve lisans

Bu eğitim, Blender Flamenco’nun resmî Manager Configuration, Worker Configuration ve Manager Configuration: MQTT kılavuzları temel alınarak Türkçeye uyarlanmıştır. Üç kaynak da sağlanan kaynak bilgisinde `lisans=serbest` olarak belirtilmiştir.

## Pro ipucu
Worker’ları paylaşılabilen ana YAML dosyasıyla yapılandırın; kimlik bilgileri ve görev güncelleme veritabanını her Worker için ayrı tutun.

## 3dsınıfı yorumu
Türkiye’de küçük ve orta ölçekli görselleştirme ekipleri için Flamenco’nun yapılandırma esnekliği, mevcut makineleri görev türlerine göre düzenleme açısından pratik olabilir. Özellikle paylaşımlı depolama yolunu ve Worker izinlerini baştan doğru tanımlamak, render işlerinin ekip içinde daha öngörülebilir yürütülmesine yardımcı olur.

Bununla birlikte rehber, donanım maliyeti veya lisans fiyatı konusunda bilgi vermiyor; dolayısıyla karar mevcut iş yükü ve altyapı üzerinden değerlendirilmelidir. MQTT de her ekip için gerekli değil. Önce temel Manager-Worker bağlantısını ve dosya erişimini doğrulamak, ardından izleme ihtiyacı varsa MQTT’yi devreye almak daha temkinli bir yaklaşım.

## 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/manager-configuration/mqtt/) (özet)

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