Skip to content

quick-start.mdx

Latest commit

 

History

History
111 lines (80 loc) · 2.11 KB

quick-start.mdx

File metadata and controls

111 lines (80 loc) · 2.11 KB
title 빠른 시작
description Docker Compose를 사용하여 5분 만에 Bingsan 실행하기

빠른 시작

Docker Compose를 사용하여 5분 만에 Bingsan을 실행해보세요.

사전 요구사항

  • Docker Engine 20.10+
  • Docker Compose v2.0+

Step 1: 저장소 클론

git clone https://github.com/teamPaprika/bingsan.git
cd bingsan

Step 2: 설정

예제 설정 파일을 복사합니다:

cp config.example.yaml config.yaml

기본 설정은 로컬 개발 환경에서 바로 사용할 수 있습니다. 프로덕션 환경의 경우 설정 가이드를 참조하세요.

Step 3: Docker Compose로 시작

docker compose -f deployments/docker/docker-compose.yml up -d

다음 서비스가 시작됩니다:

  • Bingsan - 포트 8181의 REST catalog 서버
  • PostgreSQL - 포트 5432의 메타데이터 데이터베이스
  • MinIO - 포트 9000 (API) 및 9001 (콘솔)의 S3 호환 오브젝트 스토리지

Step 4: 설치 확인

헬스 엔드포인트를 확인합니다:

curl http://localhost:8181/health

예상 응답:

{"status": "healthy"}

준비 상태 확인 (데이터베이스 연결 포함):

curl http://localhost:8181/ready

예상 응답:

{"status": "ready", "checks": {"database": "healthy"}}

Step 5: 첫 번째 네임스페이스 생성

curl -X POST http://localhost:8181/v1/namespaces \
  -H "Content-Type: application/json" \
  -d '{
    "namespace": ["analytics"],
    "properties": {
      "owner": "data-team"
    }
  }'

Step 6: 네임스페이스 목록 조회

curl http://localhost:8181/v1/namespaces

응답:

{
  "namespaces": [
    ["analytics"]
  ]
}

다음 단계

서비스 중지

docker compose -f deployments/docker/docker-compose.yml down

데이터 볼륨도 함께 삭제하려면:

docker compose -f deployments/docker/docker-compose.yml down -v