docs(deploy): synchronize deploy/ assets with nats-docker submodule and hermes prefix defaults

This commit is contained in:
2026-08-23 16:40:22 +09:00
parent adecff2194
commit f133e52863
4 changed files with 216 additions and 1 deletions
+6
View File
@@ -127,6 +127,12 @@ $ bash .agents/skills/multi-agent-mux-orc-onboard/scripts/orc_onboard.sh --list
$ bash .agents/skills/multi-agent-mux-orc-onboard/scripts/orc_onboard.sh --remove <orchestrator_uuid>
```
### 7) 전용 NATS 메시징 브로커 설정 (.mam.env)
MAM은 비동기 작업 위임(`multi-agent-mux-delegate-job`) 및 이벤트 스트림 중계를 위해 MQTT 3.1.1 및 JetStream 기반의 사설 NATS 브로커(`nats-docker`)를 표준으로 지원합니다.
* **환경 설정 생성**: `bash deploy/generate-env.sh` (또는 `cp .mam.env.example .mam.env`)를 실행하여 로컬 `.mam.env`를 생성합니다.
* **서브모듈 동기화**: `git submodule update --init --recursive` 명령어로 `nats-docker/` 배포 자산을 초기화합니다.
* **사설 서버 배포 가이드**: 자세한 도커 배포 및 Tailscale 연동 절차는 [`nats-docker/PRIVATE_SERVER.md`](../nats-docker/PRIVATE_SERVER.md) 및 [`MESSAGING.md`](../MESSAGING.md)를 참조하십시오.
---
## 🛡️ 협업 및 보안 가이드라인
+13
View File
@@ -68,6 +68,19 @@ To register these skills globally or for a specific workspace:
}
```
### 5. Private NATS Broker & Submodule Integration (`nats-docker`)
For production deployments and private networks, MAM utilizes a dedicated NATS broker (`nats:2.12-alpine` with MQTT 3.1.1 and JetStream enabled). The container assets and deployment guides are managed in the `nats-docker` submodule:
```bash
# When cloning the repository, initialize submodules:
git clone --recurse-submodules https://git.godopu.com/tmpl/multi-agent-mux.git
# Or initialize submodules in an existing clone:
git submodule update --init --recursive
```
Refer to [`nats-docker/PRIVATE_SERVER.md`](../nats-docker/PRIVATE_SERVER.md) and [`MESSAGING.md`](../MESSAGING.md) for detailed configuration, `.mam.env` generation, and security guidelines.
---
## 🤖 Gitea Actions CI/CD Setup
+1 -1
View File
@@ -506,7 +506,7 @@ fi
if [ ! -f "$MAM_ENV" ]; then
echo "📝 Initializing $MAM_ENV with default orchestration configuration..."
MAM_CLIENT_PREFIX="mam-agent"
MAM_CLIENT_PREFIX="hermes"
MAM_PORT="1883"
cat <<EOF > "$MAM_ENV"