배포 복잡도가 높으면 경계 수를 줄이는 방향으로 재설계하라

프런트엔드와 백엔드를 굳이 분리된 컨테이너, 도메인, 프록시 규칙으로 운영하면 CORS, 디버깅, 배포 순서 같은 주변 복잡도가 빠르게 커진다. 상위 프레임워크가 공식적으로 제공하는 통합 경로가 생겼다면, 분리 아키텍처를 유지하기보다 경계를 접어 운영 표면적을 줄이는 쪽이 대개 더 안전하다.

Summary#

Problem#

기존 분리 배포 구조가 트래픽 분기, 빌드 파이프라인, 환경변수 설정, private repo 워크플로까지 여러 층에 중복 복잡성을 만들고 장애 분석을 어렵게 한다.

Solution#

가능하면 백엔드가 프런트엔드 정적 자산을 직접 서빙하도록 통합하고, 환경변수나 인프라 설정도 upstream이 권장하는 최신 방식으로 정리한다. 변경 후에는 라우팅, 정적 파일 서빙, 인증, private-repo CI 경로를 함께 검증한다.

Failure Modes#

기존 프록시/컨테이너 분리를 관성적으로 유지해 CORS와 디버깅 비용이 계속 남음
통합은 했지만 정적 자산 경로나 SPA fallback을 빠뜨려 배포 후 화면이 깨짐
인프라 단순화 과정에서 private repo 권한이나 CI 비밀값 흐름이 깨짐

Sources#

https://github.com/Comfy-Org/ComfyUI/pull/15167
https://github.com/Comfy-Org/ComfyUI/pull/15165
https://github.com/Comfy-Org/ComfyUI/pull/15154
https://github.com/Comfy-Org/ComfyUI/pull/15155
https://github.com/Comfy-Org/ComfyUI/pull/15161
https://github.com/Comfy-Org/ComfyUI/pull/14681
https://github.com/Comfy-Org/ComfyUI/pull/15149
https://github.com/GitHubDaily/GitHubDaily/pull/267
https://github.com/GitHubDaily/GitHubDaily/pull/52
https://github.com/fastapi/full-stack-fastapi-template/pull/2394
https://github.com/fastapi/full-stack-fastapi-template/pull/2393
https://github.com/fastapi/full-stack-fastapi-template/pull/2392
https://github.com/fastapi/full-stack-fastapi-template/pull/2389
https://github.com/fastapi/full-stack-fastapi-template/pull/2386
https://github.com/fastapi/full-stack-fastapi-template/pull/2382
https://github.com/fastapi/full-stack-fastapi-template/pull/2380
https://github.com/fastapi/full-stack-fastapi-template/pull/2373
https://github.com/fastapi/full-stack-fastapi-template/pull/2379
https://github.com/react/react/pull/37152
https://github.com/react/react/pull/37151
https://github.com/react/react/pull/37155
https://github.com/react/react/pull/37143
https://github.com/react/react/pull/37144
https://github.com/react/react/pull/37125
https://github.com/react/react/pull/37135
https://github.com/react/react/pull/36986
https://github.com/thedaviddias/Front-End-Checklist/pull/664
https://github.com/thedaviddias/Front-End-Checklist/pull/680
mined_at: 2026-07-31T03:25:15Z

Sagwan Revalidation 2026-07-31T04:05:20Z#

verdict: ok
note: 일반 원칙 중심이라 최신 practice와 충돌하지 않고 재사용 가능함