Files
trex-core/docs/batches/bat-013_20260607_multi-instance-topology/index.md
T
genichinandClaude Opus 4.8 941d324899 docs(release): REL-002/003 feedback-captured + 포함 batch released 정합
REL-002(BAT-009)·REL-003(BAT-010~013) 을 released→feedback-captured 로 전환해
REL-001/004 와 동일한 완료(종착) 상태로 정합. REL-002 Feedback Handoff 빈
플레이스홀더 정리(tooling 릴리즈, Discovery/REQ Input=없음). 포함 batch
BAT-009~013 release-candidate→released(register + 개별 index) — 누락 정정.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-09 13:59:41 +09:00

2.2 KiB

BAT-013: 다중 인스턴스 RabbitMQ 토폴로지 — TOML config + instance_key 큐 + direct/broadcast exchange

  • Status: released
  • Profile: standard
  • Source Discovery: dcy-009
  • Included REQ: REQ-048, REQ-049, REQ-050, REQ-051

Summary

  • dcy-009(다중 인스턴스 RabbitMQ 토폴로지)를 단일 standard batch 로 delivery 한다. per-instance TOML 설정 로더 + --config 필수(REQ-048), instance_key 기반 동적 큐명 + default 하위호환(REQ-049), trex.direct(topic)/trex.broadcast(fanout) exchange + 바인딩(REQ-050), baseline 3문서 정합(REQ-051). 다중 인스턴스를 동일 RabbitMQ 에 붙여도 인스턴스 전용 큐로 split-brain(WatchdogStore/SafetySellService 경쟁 소비)을 구조적으로 방지한다.

Scope

  • In Scope:
    • DaemonInstanceConfig.from_toml + --config 필수 진입점 + env 병합 + .gitignore TOML (REQ-048)
    • topology.py 동적 큐명 빌더(intent_queue/snapshot_queue/control_queue(instance_key), default=리터럴 하위호환) + declare_topology(instance_key) + daemon per-instance consume (REQ-049)
    • trex.direct(topic) + trex.broadcast(fanout) exchange + per-instance/control dual binding + routing key 빌더 (REQ-050)
    • baseline 3문서(interface-contract/runtime-flows/project-structure) (REQ-051)
  • Out of Scope:
    • strategy 모듈(orb-v1) publish 코드 변경 — 계약만 정의
    • WatchdogStore Redis 외부화 / leader election / failover
    • 전체 env 의 TOML 일원화(KIS/DSN/RABBITMQ_URL 은 .env 유지)
    • old 큐 자동 삭제 스크립트(운영 절차)

Documents

Notes

  • Source discovery 단일(dcy-009). OQ-1(old 큐 자연 소멸)·OQ-2(--config 필수) Answered.
  • 하위호환 핵심(REQ-049): instance_key="default" → 리터럴 큐명 → 기존 테스트/배포 무회귀(FR-5/NFR-1).
  • NFR-2(pika per-thread) 유지, NFR-3(split-brain) 인스턴스 전용 큐로 달성, NFR-4(민감값) TOML+gitignore.
  • multi-instance 라우팅(directed/broadcast)·split-brain 격리는 인프라 게이트(RabbitMQ) 통합/e2e 로 검증.