fix: docker-compose 빌드 오류 해결 가이드 및 자동화 스크립트 추가

- WSL2 Ubuntu에서 'image already exists' 오류 해결 문서 추가
- Linux/macOS용 build.sh 스크립트 추가 (BuildKit 비활성화)
- Windows PowerShell용 build.ps1 스크립트 추가
- 빌드 오류 트러블슈팅 가이드 추가
- docker-compose.yml에 빌드 오류 관련 주석 추가
- MODULES.md에 Docker 빌드 오류 해결 섹션 추가
This commit is contained in:
2025-12-31 11:48:29 +09:00
parent 53326703ab
commit f41599eef6
6 changed files with 591 additions and 0 deletions

View File

@ -230,6 +230,31 @@ $env:DB_USER
$env:DB_NAME
```
### Docker 빌드 오류 ("image already exists")
```powershell
# WSL2 Ubuntu 환경에서 발생하는 오류 해결:
# 방법 1: BuildKit 비활성화 (권장)
$env:DOCKER_BUILDKIT=0
docker compose build
# 방법 2: 캐시 무시하고 빌드
docker compose build --no-cache
# 방법 3: 이전 이미지 삭제
docker rmi reg.firstgarden.co.kr/fgtools:latest
docker compose build
# 방법 4: BuildKit 캐시 정리
docker buildx prune -a
# 방법 5: 완전 초기화 후 빌드
docker compose down
docker rmi reg.firstgarden.co.kr/fgtools:latest
docker buildx prune -a
docker compose build
```
## 추가 정보
- [전체 프로젝트 구조](README.md)