📌 Docker PostgreSQL과 로컬 Django 연동 문제 해결 과정 정리 1/2

🚦 1️⃣ 모든 컨테이너 & 볼륨 완전 정리 (optional, 강력 추천)

👉 이미 떠 있는 컨테이너/네트워크/볼륨이 꼬여 있다면 깨끗이 정리!

docker-compose down --volumes --remove-orphans
docker system prune -af

• 모든 컨테이너/네트워크/이미지/볼륨 다 정리됨
• 정말 데이터 다 날려도 되는지 확인 후 실행!

---

🚦 2️⃣ Docker 이미지 다시 빌드

docker-compose build --no-cache

• --no-cache: 도커 이미지를 새로 빌드(캐시 전혀 안 씀)

---

🚦 3️⃣ 필요한 서비스(my-db 등)만 up

docker-compose up -d my-db

• DB만 먼저 켜서 연결부터 테스트!

---

🚦 4️⃣ DB가 정상적으로 켜졌는지 로그/상태 확인

docker ps
docker-compose logs my-db

• **STATUS가 Up (healthy)**면 OK!

---

🚦 5️⃣ 로컬에서 DB 연결 테스트

a. psql 명령으로 직접 접속

psql -U postgres -d django-postgres -h localhost -p 5432

• 접속 성공 시 → 도커 my-db가 잘 열렸다는 뜻!

b. DB tool(TablePlus, DBeaver, PgAdmin 등)에서도 동일하게 테스트 가능

• host: localhost
• port: 5432
• user: postgres
• password: qwe123
• dbname: django-postgres

---

🚦 6️⃣ 로컬 Django에서 DB 연결 테스트 (migrate 실행)

(가상환경 활성화 → 프로젝트 폴더 이동 후)

python manage.py migrate --settings=config.settings.dev

• 정상적으로 테이블이 생성/마이그레이션 된다면 DB 완벽하게 연결된 것!

---

🚦 7️⃣ 이제 개발/운영 준비 완료!

• runserver/createsuperuser 등 모두 가능

---

✅ 이 흐름만 지키면 데이터 꼬임, 연결 문제, 캐시 꼬임 99% 해결!

---

⚡️ 정리 (명령어 순서)

docker-compose down --volumes --remove-orphans
docker system prune -af

docker-compose build --no-cache

docker-compose up -d my-db

docker ps
docker-compose logs my-db

psql -U postgres -d django-postgres -h localhost -p 5432

python manage.py migrate --settings=config.settings.dev