🐳 Blog Docker Development Environment

Laravel (Backend) + Next.js (Frontend) + MariaDB + Nginx 개발/운영 환경을 분리하고, .env 파일을 암호화하여 관리하는 안전한 로컬 개발 환경입니다.

---

📂 디렉토리 구조

blog/
├── blog.backend/       # Laravel 백엔드
├── blog.frontend/      # Next.js 프론트엔드
└── blog.docker/        # Docker 설정 및 관리 (현재 디렉토리)

---

⚙️ 환경별 구성

환경	설명
local	로컬 개발용 (Docker + hot reload)
development	개발 서버 배포용
production	실서비스용

---

🚀 주요 명령어 (Makefile)

🧱 컨테이너 제어

명령어	설명
make up local	local 환경으로 컨테이너 실행
make up development	development 환경 실행
make up production	production 환경 실행
make down	모든 컨테이너 중지 및 정리
make build	이미지 캐시 없이 재빌드
make status	컨테이너, 환경, env 상태 요약 표시

---

🔐 환경 파일 관리 (.env)

명령어	설명
make env-encrypt local	.env → .env.local.enc 암호화
make env-encrypt development	.env → .env.development.enc 암호화
make env-encrypt production	.env → .env.production.enc 암호화
make decrypt-backend local	backend .env.local.enc → .env 복호화
make decrypt-frontend local	frontend .env.local.enc → .env 복호화
make backup-env local	암호화된 env 파일을 iCloud에 백업

🔑 암호화 키는 macOS ~/.zshrc 에 설정:

export BLOG_ENV_SECRET="EKckuME1QJavOkoLE3ZlMOeqz8Kxzi4Jje7vyvms1s8="

---

⚙️ Laravel 명령어

명령어	설명
make migrate	DB 마이그레이션 실행
make seed	DB 시더 실행
make sh-php	PHP 컨테이너 접속
make sh-node	Node 컨테이너 접속

---

📜 Laravel 로그 관리

명령어	설명
make laravel-log	Laravel 로그 마지막 50줄 출력
make laravel-log tail=100	마지막 100줄 출력
make laravel-log follow=true	실시간 로그 보기 (Ctrl+C 종료)
make laravel-log-clear	Laravel 로그 파일 초기화
make laravel-log-error	ERROR만 필터링 출력

예시:

make laravel-log tail=100 follow=true

---

☁️ iCloud 백업 경로

~/Library/Mobile Documents/com~apple~CloudDocs/blog_envs/

이 디렉토리에 .env.*.enc 파일이 자동 백업됩니다.

---

🧩 상태 확인 (Status 예시)

make status

출력 예시:

🟢 Docker Containers:
  - blog-php       running
  - blog-nginx     running
  - blog-node      running
  - blog-mariadb   running

⚙️ Environment Summary:
Backend .env → ../blog.backend/.env (updated: 2025-10-10)
Frontend .env → ../blog.frontend/.env (updated: 2025-10-10)

🧩 PHP APP_ENV: local
🧩 Node NODE_ENV: development

---

🧰 개발 환경 요구사항

• macOS (zsh 환경)
• Docker Desktop
• Make (macOS 기본 내장)
• OpenSSL (brew install openssl)

---

✅ 초기 세팅 순서

1. .env.local.enc, .env.development.enc, .env.production.enc 준비
2. ~/.zshrc 에 BLOG_ENV_SECRET 추가 후 source ~/.zshrc
3. cd blog.docker
4. make up local
5. 브라우저에서 http://localhost:3000 (frontend), http://localhost:4000 (backend) 확인

---

📦 관련 디렉토리

디렉토리	설명
blog.backend	Laravel 11.x
blog.frontend	Next.js 14
blog.docker	Docker Compose 환경
scripts/	초기화 및 유틸 스크립트
Makefile	전반적 제어 중심

---

🧡 Created with love by ChatGPT + sm