docs: Docker 환경 필수 인지 규칙 추가
- 로컬 개발 환경이 Docker 기반임을 명시 - Docker 컨테이너 구조 설명 - php artisan, composer 등 명령어는 docker exec로 실행 - 체크리스트 추가 Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
46
CLAUDE.md
46
CLAUDE.md
@@ -53,3 +53,49 @@
|
||||
| `/home/aweso/sam/api` | API 서버 (Laravel) | 독립 저장소 |
|
||||
|
||||
**각 폴더는 독립적인 Git 저장소입니다. 해당 폴더에서 git 명령을 실행해야 합니다.**
|
||||
|
||||
---
|
||||
|
||||
## Docker 환경 (필수 인지)
|
||||
|
||||
> **중요: 로컬 개발 환경은 Docker 기반입니다!**
|
||||
|
||||
### 왜 Docker를 통해 실행하나?
|
||||
|
||||
PHP, Laravel, Node.js 등이 **Docker 컨테이너 안에** 설치되어 있습니다.
|
||||
로컬 PC(WSL)에는 이런 도구들이 없으므로, 반드시 Docker 컨테이너를 통해 실행해야 합니다.
|
||||
|
||||
```
|
||||
로컬 PC (WSL)
|
||||
└── Docker
|
||||
├── sam-mng-1 ← PHP + Laravel (MNG 앱)
|
||||
├── sam-api-1 ← PHP + Laravel (API 앱)
|
||||
├── sam-mysql-1 ← MySQL DB
|
||||
└── sam-nginx-1 ← Nginx 웹서버
|
||||
```
|
||||
|
||||
### Docker 명령어 패턴
|
||||
|
||||
```bash
|
||||
# MNG 앱에서 artisan 명령 실행
|
||||
docker exec sam-mng-1 php artisan <명령어>
|
||||
|
||||
# API 앱에서 artisan 명령 실행
|
||||
docker exec sam-api-1 php artisan <명령어>
|
||||
|
||||
# 예시: 시더 실행
|
||||
docker exec sam-mng-1 php artisan db:seed --class=MngMenuSeeder
|
||||
|
||||
# 예시: 마이그레이션 실행
|
||||
docker exec sam-mng-1 php artisan migrate
|
||||
|
||||
# 예시: 캐시 클리어
|
||||
docker exec sam-mng-1 php artisan cache:clear
|
||||
```
|
||||
|
||||
### 체크리스트 (명령 실행 시)
|
||||
|
||||
- [ ] `php artisan` 명령 → `docker exec sam-mng-1 php artisan` 사용
|
||||
- [ ] `composer` 명령 → `docker exec sam-mng-1 composer` 사용
|
||||
- [ ] DB 시더 실행 필요 시 → Docker를 통해 실행
|
||||
- [ ] 마이그레이션 필요 시 → Docker를 통해 실행
|
||||
|
||||
Reference in New Issue
Block a user