사전 요구 사항
시작하기 전에 시스템에 다음이 설치되어 있는지 확인하세요:
- Docker Engine (20.10.0 이상)
- Docker Compose (v2.0.0 이상)
- OpenSSL (SSL 인증서 생성용)
Docker 설치
macOS용:
- Docker Hub에서 Docker Desktop을 다운로드하고 설치
- 설치 마법사를 따르세요
- 설치 확인:
docker --version
docker-compose --version
Linux (Ubuntu/Debian)용:
sudo apt-get update
sudo apt-get install docker-ce docker-ce-cli containerd.io docker-compose-plugin
docker --version
docker-compose --version
Windows용:
- Docker Hub에서 Docker Desktop을 다운로드하고 설치
- 설치 마법사를 따르세요
- 설치 확인:
docker --version
docker-compose --version
로컬 배포
1단계: 저장소 복제
git clone https://github.com/casebender/casebender.git
cd casebender
2단계: 환경 설정
루트 디렉토리에 .env 파일 생성:
.env 파일을 편집하여 환경 변수 구성:
DB_HOST=postgres
DB_PORT=5432
DB_NAME=casebender
DB_USER=postgres
DB_PASSWORD=your_secure_password
REDIS_HOST=redis
REDIS_PORT=6379
JWT_SECRET=your_jwt_secret_key
3단계: 서비스 시작
이 명령은 필요한 모든 서비스를 시작합니다:
- API 백엔드 (Node.js)
- 프론트엔드 (React)
- 데이터베이스 (PostgreSQL)
- Redis (캐시 및 큐용)
4단계: 배포 확인
모든 컨테이너가 실행 중인지 확인:
모든 서비스가 “Up” 상태인지 확인하세요.
5단계: 애플리케이션 접근
기본 로그인 자격 증명
CaseBender를 배포한 후, 다음 기본 자격 증명으로 로그인할 수 있습니다:
사용자 이름: admin@casebender.app
비밀번호: secret1234
보안상의 이유로, 첫 로그인 후 즉시 이러한 기본 자격 증명을 변경하는 것을 강력히 권장합니다.
초기 설정
관리자 계정 생성
docker-compose exec api npm run create-admin
샘플 데이터 가져오기 (선택 사항)
docker-compose exec api npm run import-sample-data
문제 해결
로그 확인
문제가 발생하면 컨테이너 로그를 확인하세요:
docker-compose logs -f api
docker-compose logs -f frontend
docker-compose logs -f postgres
일반적인 문제
데이터베이스 연결 오류
.env 파일의 데이터베이스 자격 증명이 올바른지, PostgreSQL 컨테이너가 실행 중인지 확인하세요:
docker-compose ps postgres
권한 문제
Docker 볼륨에 접근할 때 권한 문제가 발생하는 경우:
sudo chown -R $(whoami):$(whoami) ./data
다음 단계
이제 CaseBender가 로컬에서 실행 중이므로 다음을 수행할 수 있습니다:
- 통합 구성
- 워크플로우 사용자 지정
- 알림 관리 탐색
- 케이스 관리 학습
