로컬 데이터베이스를 가장 쉽게 설정하는 방법

Source: Dev.to

소개

저는 스스로 큰 고통을 해결했으며, 업무에 너무 큰 도움이 되어서 다른 사람들과 공유하고 싶었습니다: 로컬 개발 데이터베이스.

기존 솔루션이 부족한 이유

• Docker – 느리고, 부피가 크며, 답답하고, 종종 과도합니다.
• Windows의 XAMPP – 2000년대로 살아가는 느낌입니다.
• Postgres.app / DBngin – macOS에서 단일 데이터베이스를 다루기에 좋지만, 여러 엔진을 다루기엔 유연하지 않습니다.
• Neon / Supabase / PlanetScale – 지속적인 인터넷 연결이 필요하고 마이그레이션을 대신 처리해 주지 않습니다.

MySQL, Postgres, SQLite 혹은 이들의 조합을 사용해야 할 때—때로는 오프라인, 때로는 다른 OS에서—위 도구들은 번거로워집니다. 가장 큰 골칫거리는 PM이 스테이징에서 버그를 지적했을 때, 로컬 데이터베이스가 더 이상 스테이징 환경을 그대로 반영하지 않을 때입니다. 디버깅이 악몽이 됩니다.

spindb 소개

spindb는 프로덕션 데이터베이스를 로컬 컨테이너로 복제하고 데이터베이스 엔진을 다운로드 받아 가벼운 의사‑컨테이너에서 실행할 수 있게 해 주는 CLI 도구입니다—Docker보다 빠르고 쉽습니다.

설치

# 한 번만 실행 (설치 없음)
npx spindb

# 권장: pnpm으로 실행
pnpx spindb

# 반복 사용을 위한 전역 설치
pnpm i -g spindb

기능

• 다중 엔진 지원: Postgres, MySQL, SQLite (곧 Redis, MongoDB 추가).
• 크로스‑플랫폼: Windows, macOS, Linux에서 동작.
• 버전별 인스턴스: 여러 버전을 나란히 실행 가능, 예시)
  • Postgres 14 – 포트 5432
  • Postgres 17 – 포트 5433
  • MySQL 5.7 – 포트 3306
  • MySQL 8 – 포트 3307
• 스크립트화 가능: CI 파이프라인이나 테스트 스위트에서 프로그래밍적으로 데이터베이스를 띄울 수 있음.
• 쉬운 관리: 명령줄에서 데이터베이스 인스턴스를 빠르게 생성, 시작, 중지, 삭제 가능.

전체 문서는 저장소 README에서 확인할 수 있습니다:

https://github.com/robertjbass/spindb

향후 계획

• Redis와 MongoDB 지원 추가.
• Windows 호환성 및 전반적인 안정성 지속 개선.

이 프로젝트는 사랑으로 만든 작업물입니다. 피드백을 환영합니다—레포에 ⭐를 달거나 의견을 공유해 주세요.