🚢 Openship 분석: 차세대 플랫폼 엔지니어링을 위한 올인원 자체 호스팅 배포 솔루션

[toptip (경헌)]

Openship (oblien/openship)은 오픈소스 기반의 자체 호스팅(Self-hosted) 배포 플랫폼입니다. 쉽게 말해 개인이나 팀이 직접 서버에 설치해서 사용할 수 있는 ‘나만의 Vercel’ 또는 '나만의 Heroku’를 만들어주는 도구라고 볼 수 있습니다.

저장소(Repository)의 README 문서를 바탕으로 분석한 핵심 내용은 다음과 같습니다.

1. 주요 특징 및 목적

• 올인원(All-in-One) 배포 자동화: GitHub 저장소나 로컬 폴더를 연결하면 코드를 감지하고, 빌드하고, 배포하며, 도메인 라우팅과 SSL(TLS) 인증서 발급까지 모든 과정을 알아서 처리합니다.
• 다양한 인터페이스 지원: 보통의 배포 도구들이 CLI나 웹 대시보드만 제공하는 것과 달리, Openship은 데스크톱 앱(macOS, Windows, Linux), 웹 대시보드, CLI의 3가지 방식을 모두 지원합니다.
• 다양한 환경 지원: Node, Python, Go, Rust, PHP, Ruby, Java, .NET 같은 언어는 물론 Docker 및 모노레포(Monorepo) 환경도 완벽히 지원합니다.
• 올인원 인프라 관리: 단순 앱 배포뿐만 아니라 Postgres, MySQL, MongoDB, Redis 등의 데이터베이스와 내장 메일 서버(SMTP), 스케줄링 백업 기능까지 플랫폼 내에서 관리할 수 있습니다.

2. 작동 방식 (파이프라인)

따로 복잡한 설정 파일(openship.json으로 커스텀도 가능)을 만들지 않아도 다음 과정을 거칩니다.

1. 감지(Detect): package.json이나 docker-compose.yml, 락(lock) 파일 등을 읽어 어떤 스택인지, 패키지 매니저는 무엇인지, 빌드/시작 명령어와 포트를 자동 유추합니다.
2. 빌드(Build): 타겟 서버나 오케스트레이터 로컬에서 Docker 이미지 또는 베어(bare) 릴리스로 빌드하고 이 상태를 스냅샷으로 고정하여 롤백을 용이하게 합니다.
3. 실행(Run): 외부로 직접 노출되지 않는 루프백 포트로 컨테이너나 호스트 프로세스를 실행합니다.
4. 라우팅 및 보안(Route + Secure): OpenResty(Nginx) 기반의 엣지 서버가 도메인에 리버스 프록시를 설정하고 Let’s Encrypt를 통해 인증서를 자동 발급받습니다.

3. 설치 및 운영 모드

사용자의 환경에 맞춰 다양한 실행 방식을 지원합니다.

• 데스크톱 앱 (Solo): 가장 독특한 특징 중 하나로, 로컬 PC에 앱을 깔고 SSH로 원격 서버에 접속해 배포를 명령합니다. 서버 자체에 무거운 관리용 데몬(Control Plane)을 띄울 필요가 없어 개인 개발자에게 적합합니다.
• 자체 호스팅 서버 (Team/CI-CD): openship up 명령어 하나로 서버에 Docker 기반의 전체 스택(Postgres, Redis, API, 대시보드, OpenResty 엣지)을 띄웁니다. 팀 단위로 사용하거나 GitHub Webhook을 통한 자동 배포(CI/CD)가 필요할 때 사용합니다.
• Docker Compose (Raw): CLI 마법사 없이 docker-compose.yml을 이용해 인프라를 직접 구성하고 제어할 수도 있습니다.

4. 기술 스택 (아키텍처 구성)

• 라우팅 / 프록시: OpenResty (Nginx 환경에 Lua 스크립트를 더해 동적 라우팅 처리)
• 데이터베이스 & 캐시: PostgreSQL (메인 DB), Redis (캐싱 및 작업 큐)
• 인프라: Docker 기반 컨테이너 오케스트레이션 (호스트의 Docker Socket을 마운트하여 앱들을 컨테이너로 빌드 및 실행)
• 개발 환경: 로컬 개발 및 빌드 툴로 Bun을 사용하고 있는 것이 눈에 띕니다.

[출처] Openship - 내장 CI/CD를 갖춘 셀프 호스팅 배포 플랫폼 | GeekNews