9. 컨테이너 실행¶
컨테이너 실행 기능을 사용하면 Squad 에이전트와 예약 작업을 격리된 컨테이너(Docker 또는 Apple Container) 내에서 실행할 수 있습니다. 이를 통해 강력한 보안 경계, 재현 가능한 환경, 외부 메시징 채널과의 원활한 통합을 제공합니다.
개요¶
컨테이너 실행이 활성화되면 에이전트는 다음 특징을 가진 경량 컨테이너 내에서 실행됩니다:
- 호스트 파일시스템 및 네트워크로부터 에이전트 격리
- API 키가 컨테이너에 절대 유입되지 않도록 자격증명 프록시
- 구성 가능한 허용 목록에 기반한 승인된 디렉터리만 마운트
- 낮은 지연 시간의 호스트-컨테이너 메시징을 위한 파일 기반 IPC
주요 섹션¶
-
실행 가이드 — Docker 또는 Apple Container 설치, 에이전트 이미지 빌드, 마운트 허용 목록 설정
-
Squad 컨테이너 모드 — Squad 에이전트에서 컨테이너 격리를 활성화하는 단계별 가이드
-
멀티 채널 메시징 — Telegram, Slack, Discord, WhatsApp을 에이전트에 연결
-
채널-Squad 매핑 — 외부 채널의 메시지를 특정 Squad 그룹으로 라우팅
-
보안 모델 — 자격증명 프록시, 마운트 보안, IPC 권한, 감사 로그
-
작업 스케줄링 — cron, 인터벌, 일회성 컨테이너 실행 예약
-
Cowork 컨테이너 모드 — 단일 에이전트 작업에서 컨테이너 격리 사용
아키텍처¶
flowchart TB
subgraph External["외부 채널"]
TG[Telegram 봇]
SL[Slack 봇]
DC[Discord 봇]
WA[WhatsApp Business]
end
subgraph Core["Backend.AI GO 코어"]
CR[채널 레지스트리]
MR[메시지 라우터]
NS[네임스페이스 관리자]
CP[자격증명 프록시]
MA[마운트 허용 목록]
end
subgraph Containers["격리된 컨테이너"]
C1[에이전트 컨테이너 1]
C2[에이전트 컨테이너 2]
C3[예약 컨테이너]
end
TG & SL & DC & WA --> CR
CR --> MR
MR --> NS
NS --> C1 & C2 & C3
CP -.->|자격증명 주입| C1 & C2 & C3
MA -.->|마운트 검증| C1 & C2 & C3 요구 사항¶
| 구성 요소 | 최소 버전 | 비고 |
|---|---|---|
| Docker | 24.0 | Windows, Linux, macOS (Intel) |
| Apple Container | 0.2 | macOS Apple Silicon 전용 |
| Backend.AI GO | 1.4.0 | NanoClaw 릴리스 |