v1.12.32 로컬 개발 DB 복구 절차 정리

docs/deploy-reference.md

@@ -116,7 +116,7 @@ npm run dev
 colima start
 
 # 개발 DB 컨테이너 실행
-ENV_FILE=.env.development docker compose --env-file .env.development up -d sori-studio-db
+ENV_FILE=.env.development docker compose -p sori-studio -f docker-compose.yaml --env-file .env.development up -d sori-studio-db
 
 # 개발 DB 마이그레이션 실행
 npm run db:migrate:dev
@@ -128,7 +128,16 @@ docker exec sori-studio-db pg_isready -U sori_studio -d sori_studio
 docker exec sori-studio-db psql -U sori_studio -d sori_studio -c 'SELECT count(*) AS posts_count FROM posts;'
 ```
 
-> 지난 버전 마이그레이션을 아직 적용하지 않았다면 `062_site_settings_display_counts.sql`부터 `069_media_catalog.sql`까지 순차 적용되어야 한다. 앱 재기동 전에 운영 DB 마이그레이션을 먼저 완료한다. 일반 배포에서는 `npm run db:migrate:prod` 또는 NAS 컨테이너 내부 마이그레이션 명령이 이 순서를 자동 처리한다.
+### 로컬에서 `ECONNREFUSED 127.0.0.1:43081`이 발생할 때
+
+Docker Desktop을 실행한 뒤, 프로젝트 폴더의 터미널에서 아래 블록을 실행한다. 기존 DB 볼륨을 연결해 멈췄거나 사라진 DB 컨테이너를 다시 실행한다. 개발 서버가 이미 켜져 있다면 먼저 해당 터미널에서 `Ctrl+C`로 종료한다.
+
+```bash
+ENV_FILE=.env.development docker compose -p sori-studio -f docker-compose.yaml --env-file .env.development up -d sori-studio-db &&
+npm run dev
+```
+
+개발 코드에 새 SQL이 추가된 경우에는 `npm run db:migrate:dev`로 개발 DB의 미적용 파일을 적용한다. 단순 컨테이너 복구만으로는 마이그레이션을 다시 실행할 필요가 없다.
 
 ### 확인 주소