차트를 생성하고 로컬에서 실행하기 (Windows/macOS/Linux)

차트를 생성하고 로컬에서 실행하기 (Windows/macOS/Linux)

DEMO 빌더에서 ZIP 프로젝트를 생성하고 Docker로 로컬 실행하는 방법을 안내합니다.

  1. 에서 DEMO 빌더를 열고 차트 유형을 선택하세요.
  2. 차트 수정를 클릭합니다.
  3. 시리즈를 입력하고, 필요한 경우 축과 옵션을 조정합니다.
  4. ZIP 생성을 클릭합니다. 확인 창에서 활성 구독과 ZIP 카운터 > 0을 확인하세요.
  5. 다운로드한 압축을 해제합니다.
  6. docker.com에서 Docker Desktop을 설치하고 실행하세요.
  7. 압축 해제 폴더에서 중앙 스크립트를 실행합니다:
    • Windows: run-docker-windows.bat 더블클릭
    • macOS/Linux:
      chmod +x ./run-docker-unix.sh
      ./run-docker-unix.sh
    스크립트는 먼저 리빌드 없이 컨테이너 기동을 시도합니다. 이미지가 없으면 base-images.tar를 자동으로 로드하고, 필요한 경우에만 1회 빌드합니다.
  8. 브라우저에서 열기:
    • 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-*로 로드 후 중앙 스크립트 재실행.