차트를 생성하고 로컬에서 실행하기 (Windows/macOS/Linux)
차트를 생성하고 로컬에서 실행하기 (Windows/macOS/Linux)
DEMO 빌더에서 ZIP 프로젝트를 생성하고 Docker로 로컬 실행하는 방법을 안내합니다.
- 홈에서 DEMO 빌더를 열고 차트 유형을 선택하세요.
- 차트 수정를 클릭합니다.
- 시리즈와 값를 입력하고, 필요한 경우 축과 옵션을 조정합니다.
- ZIP 생성을 클릭합니다. 확인 창에서 활성 구독과 ZIP 카운터 > 0을 확인하세요.
- 다운로드한 압축을 해제합니다.
- docker.com에서 Docker Desktop을 설치하고 실행하세요.
- 압축 해제 폴더에서 중앙 스크립트를 실행합니다:
- Windows:
run-docker-windows.bat더블클릭 - macOS/Linux:
chmod +x ./run-docker-unix.sh ./run-docker-unix.sh
스크립트는 먼저 리빌드 없이 컨테이너 기동을 시도합니다. 이미지가 없으면base-images.tar를 자동으로 로드하고, 필요한 경우에만 1회 빌드합니다. - Windows:
- 브라우저에서 열기:
Frontend: http://localhost:8081/Backend: http://localhost:8080/
팁: 요금제에 오프라인 라이선스가 포함된 경우,설정에서 다운로드하여 frontend/public/license.cwclic에 배치하세요.
고급 (오프라인, 리빌드, 중지)
오프라인 준비(온라인 환경에서 1회)
인터넷 연결된 머신에서 실행:
- Windows:
preload-base-images-windows.bat - macOS/Linux:
./preload-base-images-unix.sh
기본 Docker 이미지를 내려받아 base-images.tar로 묶습니다. 파일을 오프라인 머신의 프로젝트 폴더 옆에 복사하세요.
오프라인에서 이미지 로드
오프라인 머신(docker-compose.yml 옆)에서:
- Windows:
load-base-images-windows.bat - macOS/Linux:
./load-base-images-unix.sh
또는 중앙 스크립트를 실행하면 base-images.tar을 자동 로드하려고 시도합니다.
강제 리빌드
- Windows:
run-docker-windows.bat rebuild - macOS/Linux:
./run-docker-unix.sh rebuild - 환경 변수:
CWC_REBUILD=1
중지 / 정리
- 컨테이너 중지:
stop-docker-windows.bat또는./stop-docker-unix.sh - 완전 정리(볼륨 삭제 포함) 수동 실행:
docker compose down -v
문제 해결
- Docker 실행 안 됨: Docker Desktop 실행 후 재시도.
- 포트 충돌:
docker-compose.yml의 포트를 수정 후 재시작. - 권한(mac/linux):
chmod +x ./run-docker-unix.sh실행. - 인터넷 없음 / auth.docker.io 오류: 오프라인 플로우 사용 —
base-images.tar준비,load-base-images-*로 로드 후 중앙 스크립트 재실행.