문서번호 : 11-3516642
Document Information
SingleStore Dev Image를 활용하여 개발 및 테스트 환경을 신속하게 구축할 수 있습니다.
SingleStore의 개발 및 테스트 목적에 최적화된 Docker Image로 간편한 환경 설정과 빠른 실행을 지원합니다.
SingleStore Dev Image를 사용하면 라이선스 없이 최대 32 vCPU와 최대 128GB RAM이 있는 호스트에서 실행할 수 있습니다.
SingleStore Dev Imag 구조도
운영 체제별 설치 방법
Linux
docker run \
-d --name singlestoredb-dev \
-e ROOT_PASSWORD="{YOUR SINGLESTORE ROOT PASSWORD}" \
-p 3306:3306 -p 8080:8080 -p 9000:9000 \
ghcr.io/singlestore-labs/singlestoredb-dev:latest
Bash
복사
특정 라이선스 구성
docker run \
-d --name singlestoredb-dev \
-e ROOT_PASSWORD="{YOUR SINGLESTORE ROOT PASSWORD}" \
-e SINGLESTORE_LICENSE="{YOUR SINGLESTORE LICENSE}" \
-p 3306:3306 -p 8080:8080 -p 9000:9000 \
ghcr.io/singlestore-labs/singlestoredb-dev:latest
Bash
복사
특정 버전 구성
컨테이너가 초기 생성될 때 지정한 버전을 다운로드 및 설치하는 과정을 거치기 때문에, 초기 실행 시 약 1분 정도의 시간이 추가로 소요됩니다.
사용자 지정 버전 이미지를 생성하여 컨테이너를 생성할 수도 있습니다.
참고: 사용자 지정 버전 이미지 생성
docker run \
-d --name singlestoredb-dev \
-e ROOT_PASSWORD="YOUR ROOT PASSWORD" \
-e SINGLESTORE_VERSION="8.9" \
-p 3306:3306 -p 8080:8080 -p 9000:9000 \
ghcr.io/singlestore-labs/singlestoredb-dev
Bash
복사
Kai (API for MongoDB) 사용
ENABLE_KAI=1로 설정하고 27017 port를 개방해야 합니다.
docker run \
-d --name singlestoredb-dev \
-e ROOT_PASSWORD="YOUR SINGLESTORE ROOT PASSWORD" \
-e ENABLE_KAI=1 \
-p 3306:3306 -p 8080:8080 -p 9000:9000 -p 27017:27017 \
ghcr.io/singlestore-labs/singlestoredb-dev:latest
Bash
복사
Windows
Apple Silicon (M1/M2 chips)
사용 방법
SQL shell 사용 방법
docker exec -it singlestoredb-dev singlestore -p
# 또는
docker exec -it singlestoredb-dev singlestore -pYOUR_ROOT_PASSWORD
Bash
복사
SingleStore Studio 액세스 방법
SingleStore Studio는 브라우저 기반 UI를 통해 SingleStore를 관리하고 쿼리를 실행할 수 있습니다.
http://localhost:8080
Bash
복사
Localhost 클릭 후 접속 정보 입력
기본 유저는 root
Password는 docker run 에서 설정한 Password 입력
특정 로컬 스토리지를 Docker 볼륨으로 사용 하는 방법
docker run \
-d --name singlestoredb-dev \
-e ROOT_PASSWORD="YOUR ROOT PASSWORD" \
-p 3306:3306 -p 8080:8080 -p 9000:9000 \
-v {my_cool_volume}:/data \
ghcr.io/singlestore-labs/singlestoredb-dev
Bash
복사
Docker Image의 볼륨 마운트 지점
mount path | description |
/data | SingleStore 클러스터에 대한 모든 데이터, Config, 캐시 저장 |
/logs | 클러스터를 Debug하거나 현재 상태을 관찰하는 데 도움이 될 수 있는 정보가 포함된 모든 tracelog 파일입니다. |
/server | 서버 바이너리 및 기타 설치 상태를 포함하는 설치 디렉토리입니다 |
MySQL 호환 클라이언트 연결 방법
Data API 액세스 방법
사용자 지정 버전 이미지 생성
References
•
SingleStore Github - https://github.com/singlestore-labs/singlestoredb-dev-image
History
일자 | 작성자 | 비고 |
2025.06.11 | jwy | |
2025.06.23 | jwy | 특정 버전 구성 내용 수정 - 노종수 상무님 Review |