프로젝트 소개

EC-CUBE 4를 개발 환경과 운영 환경에서 동일한 구성으로 운용할 수 있는 Docker 환경입니다. git clone과 bin/init.sh로 개발 환경을 구축하고, bin/publish.sh로 운영 환경에 공개할 수 있습니다. VPS든 AWS든 동일한 절차로 도입이 가능합니다. 설계 방침으로서 EC-CUBE 본체는 Docker 이미지에 베이크하고(composer create-project로 취득), 리포지토리에는 포함하지 않습니다. 버전 전환은 이미지 재빌드를 통해 수행합니다. Git으로 관리하는 것은 독자적인 코드뿐이며, app/Customize, app/template, app/DoctrineMigrations, app/Plugin, html/user_data 등 필요한 디렉토리만 bind-mount로 겹치는 구조입니다. 업로드 이미지는 전용 볼륨(NFS/EFS로 대체 가능)에 저장합니다. compose.yaml을 기반으로 개발용 override, 운영용, 다중 호스트용 app 계층 전용 구성 등을 제공합니다. DB는 MariaDB/MySQL 또는 PostgreSQL 중에서 선택 가능합니다. PHP는 배포 이미지의 태그로 선택하며, 매주 패치가 적용됩니다. amd64/arm64 모두 대응합니다. 개발 환경에서는 Mailpit, phpMyAdmin을 이용할 수 있습니다. deploy, console, shell, plugin, test, backup, restore 등의 조작 스크립트를 bin/에 준비했습니다. 컨테이너 내 명령은 www-data 고정으로 실행하여, root 권한의 파일 생성으로 인한 500 에러를 방지하는 설계입니다. docs/ 하위에 도입, 커스터마이징, 버전 업그레이드, 배포, 백업, 스케일, 모니터링, 테스트, IDE 설정 등의 문서를 분할 배치했습니다. 라이선스는 Apache License 2.0(리포지토리 파일만 해당)입니다. EC-CUBE 본체는 별도의 라이선스(GPL/상용 듀얼 라이선스)가 적용됩니다.