From 94554662b799af421dcfe16d96bd26a5229f5536 Mon Sep 17 00:00:00 2001 From: happybell80 Date: Wed, 30 Jul 2025 00:23:07 +0900 Subject: [PATCH] =?UTF-8?q?docs:=20auth-server=20=EB=A1=9C=EA=B7=B8=20?= =?UTF-8?q?=EB=B6=84=EC=84=9D=20=EB=B0=8F=20Docker=20=EA=B2=A9=EB=A6=AC=20?= =?UTF-8?q?=EC=9B=90=EC=B9=99=20=EC=B6=94=EA=B0=80?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ...서버백업및로그관리체계구축.md | 66 ++++++++++++++++++- 1 file changed, 65 insertions(+), 1 deletion(-) diff --git a/troubleshooting/250729_서버백업및로그관리체계구축.md b/troubleshooting/250729_서버백업및로그관리체계구축.md index 73edf8c..451c417 100644 --- a/troubleshooting/250729_서버백업및로그관리체계구축.md +++ b/troubleshooting/250729_서버백업및로그관리체계구축.md @@ -143,5 +143,69 @@ sudo systemctl start nginx - 각 단계마다 검증 - 롤백 계획 준비 +## 자정 00분 + +### auth-server 로그 타임스탬프 이슈 + +**문제**: Docker 로그에 시간이 표시되지 않음 + +**원인 분석**: +- `docker logs` 기본 동작은 타임스탬프 미표시 +- uvicorn 자체도 타임스탬프를 로그에 포함하지 않음 + +**해결 방법**: +```bash +# 타임스탬프 포함해서 로그 확인 +docker logs auth-server --timestamps + +# Gmail 로그인 시도 발견 +2025-07-29T14:54:37 (23:54 KST): Gmail 로그인 시도 +2025-07-29T14:55:03 (23:55 KST): OAuth 콜백 완료 +``` + +**발견 사항**: +- IP: 172.21.0.1 (Docker 내부 네트워크) +- redirect_uri: http://localhost:5173 (개발 환경) +- 누군가 로컬 개발 환경에서 Gmail OAuth 테스트 수행 + +## 자정 10분 + +### uv 패키지 매니저 관련 오해 정리 + +**혼동 사항**: uvicorn(ASGI 서버)과 uv(패키지 매니저) 혼동 + +**명확한 차이**: +- **uvicorn**: FastAPI 앱을 실행하는 ASGI 서버 +- **uv**: pip 대체 패키지 매니저 (10-100배 빠름) + +**Docker와 호스트 격리 원칙**: +- 호스트에 설치된 소프트웨어는 컨테이너에서 사용 불가 +- Docker의 핵심은 "격리된 환경" +- 각 컨테이너마다 필요한 소프트웨어 별도 설치 필요 + +**uv 활용 방안**: +```dockerfile +# Dockerfile 개선 예시 +RUN pip install uv +RUN uv pip install -r requirements.txt # 훨씬 빠른 설치 +``` + +## 추가 교훈 + +6. **로그 확인 시 타임스탬프**: + - Docker 로그는 `--timestamps` 옵션 필수 + - 시간 기반 분석 시 중요 + - nginx 로그는 기본적으로 타임스탬프 포함 + +7. **Docker 격리 원칙 이해**: + - 컨테이너는 호스트와 완전히 격리 + - 호스트 설치 프로그램 ≠ 컨테이너에서 사용 가능 + - 이식성과 일관성을 위한 설계 + +8. **패키지 매니저 최적화**: + - uv는 빌드 시간 단축에 효과적 + - 운영 중인 서비스는 신중하게 적용 + - 새 프로젝트나 큰 업데이트 시 도입 검토 + --- -**작성 완료**: 2025-07-29 23:55 \ No newline at end of file +**작성 완료**: 2025-07-30 00:15 \ No newline at end of file