TL;DR

Sencho는 호스트의 Compose 파일을 소스 오브프로 유지하면서 단일 컨테이너로 로컬과 다중 노드를 웹 UI에서 관리하는 플랫폼이다. 각 노드에서 /var/run/docker.sock을 마운트하여 로컬 Docker API로 작업을 수행하고 프라이머리 인스턴스가 장기 API 토큰을 통해 HTTP 및 WebSocket 프록시 역할을 하여 원격 노드를 제어한다. 헬스 기반 롤아웃, Git 소스 스택 동기화, 로그 집계와 스택 사전검사 기능을 통해 운영 안정성과 배포 안전성을 높이며 NAT 환경에서는 Pilot Agent의 아웃바운드 터널로 인바운드 포트를 열지 않고 연결을 유지한다. 다만 호스트 Docker 소켓 마운트는 높은 권한을 부여하므로 프로덕션 배포 시 리버스 프록시와 비루트 컨테이너 실행 등 보안 강화가 필요하다.

핵심 포인트

• Compose 파일을 호스트 파일 시스템의 소스 오브스로 그대로 유지하여 기존 파일 기반 워크플로와 충돌하지 않고 UI를 통해 운영 편의를 추가한다. 이는 Git 동기화와 에디터 기반 diff/롤백 기능과 함께 작동하여 코드 기반 배포와 수동 편집을 동시에 허용한다.
• 멀티 노드 통신에 별도의 인바운드 Docker 소켓 노출이나 SSH 의존성이 없도록 설계되어 NAT 및 방화벽 환경에서도 Pilot Agent의 아웃바운드 WebSocket 터널을 통해 안전하게 연결된다. 이 방식은 원격 노드가 공용 네트워크에 Docker API를 노출하지 않으면서 중앙에서 제어 가능하게 만든다.
• 헬스 게이티드 업데이트와 Compose Doctor 같은 배포 전 검사 기능을 내장하여 자동 이미지 롤아웃 중 실패 지점을 감지하고 인앱 복구 절차를 제공한다. 이는 단순한 UI 제어를 넘어 헬스 기반 롤백과 stalled-update 감지로 운영 리스크를 낮춘다.
• 스택 생성과 배포를 수행하고 재시작, 중지, 이미지 풀 같은 전체 Compose 라이프사이클 작업을 UI에서 직접 실행할 수 있다. 에디터는 Monaco 편집기를 사용하며 저장 전 diff 미리보기와 단일 클릭 롤백 기능을 제공한다. Compose 파일을 파일 시스템에 그대로 두고 편집하는 워크플로를 보존하면서 GUI로 운영성을 높인다.

이미지 분석