Uncloud
lastmod 2026-11-16created 2025-12-073 edits
Uncloud는 psviderski 가 만든 오픈 소스 경량 클러스터링·컨테이너 오케스트레이션 도구이다. 클라우드 VM 과 베어메탈의 Docker 호스트를 WireGuard 메시 네트워크로 묶고, Docker Compose 파일로 웹 앱을 여러 서버에 배포한다. Swarm 이나 Kubernetes 와 달리 중앙 컨트롤 플레인과 쿼럼이 없고, 각 머신이 P2P 로 동기화한 클러스터 상태 사본을 가지고 있어 일부 머신이 꺼져도 클러스터 작업을 계속할 수 있다.
About
- 서비스와 볼륨은 표준 Docker Compose 형식으로 정의함. CLI 는
uc run,uc ls,uc rm처럼 Docker 와 비슷함 - 클러스터 상태는 Fly.io 의 Corrosion(CRDT 기반 분산 SQLite)으로 공유함. 상태 조정(reconciliation)보다 명령형 작업을 택해 동작을 이해하고 문제를 찾기 쉽게 함
- WireGuard 메시는 피어 탐색과 NAT 통과를 자동으로 처리하고, 컨테이너마다 고유 IP 를 받아 머신 간에 직접 통신함
- 내장 DNS 서버로 서비스 이름을 컨테이너 IP 로 풀어 줌. 무중단 롤링 업데이트 지원
- Caddy 리버스 프록시가 Let's Encrypt 인증서를 발급·갱신하고, 인증서와 ACME 토큰은 머신 사이에 공유함. 관리형 Uncloud DNS 로
*.xxxxxx.uncld.dev레코드도 받을 수 있음 - Unregistry 로 외부 레지스트리 없이 이미지를 머신에 바로 푸시함. 없는 레이어만 전송함
- 클러스터 안 아무 머신에 SSH 로 접속해 전체를 관리함.
uc machine init root@서버IP로 첫 머신을 초기화함 - 1.0 이전 단계라 릴리스 사이에 호환성이 깨질 수 있음. Apache-2.0 라이선스