v1.12.28 배포 문서를 상황별 복사 실행 명령어로 정리

This commit is contained in:
2026-10-21 17:46:06 +09:00
parent 2d4431e698
commit 184a971863
8 changed files with 705 additions and 594 deletions

View File

@@ -1,3 +1,7 @@
## 2026-10-21 v1.12.28 — 일상 배포 문서는 복사할 명령만 제공한다
운영자가 긴 배포 설명에서 필요한 절차를 골라야 했으므로 `docs/deploy.md`를 상황별 명령어 안내로 줄인다. 각 상황은 NAS 경로 이동부터 마지막 상태 확인까지 한 블록으로 복사하며, 실패한 단계 뒤에는 다음 명령이 실행되지 않도록 연결한다. 기존 설치·고급 설정·장애 설명은 `docs/deploy-reference.md`로 옮겨 필요할 때만 참조한다. 실행 스크립트와 Compose 동작은 변경하지 않는다.
## 2026-10-21 v1.12.27 — NAS 앱 재배포와 이미지 빌드를 분리한다
제공된 재배포 로그에는 소스 빌드가 없고 원격 `sori-studio` pull 오류와 컨테이너 재생성만 있어, Compose의 `pull_policy: build`를 지정하면 앱이 로컬 소스를 빌드할 것이라는 이전 전제를 폐기한다. 앱 재배포를 유지하려는 사용자 선호에 맞춰 명시적인 이미지 빌드 스크립트와 로컬 이미지 전용 GUI 구성을 나눈다. 사용자가 확인한 앱 기준 파일명 `docker-compose.yaml`을 실행용으로 관리하고 기존 정의는 `docker-compose.build.yml`로 옮긴다. 운영 마이그레이션·백필도 실행용 파일을 선택한다. 처음 갱신할 때 NAS의 비추적 yaml이 Git과 충돌하지 않도록 기존 파일 백업 절차를 둔다. GUI 구성은 원격 앱 pull을 금지하고, 실제 GUI가 이를 덮어쓰는지는 NAS 옵션·로그로 확인해야 한다. 기존 DB·네트워크·업로드 설정은 동일하게 유지한다.