From 822b7ccb8c41350d96462fa1c7c3554dd55ce336 Mon Sep 17 00:00:00 2001 From: happybell80 Date: Mon, 4 Aug 2025 15:06:02 +0900 Subject: [PATCH] Update rb10508_micro deployment troubleshooting - add API structure and final deployment fixes --- .../250804_happybell80_rb10508_micro배포.md | 48 ++++++++++++++++++- 1 file changed, 47 insertions(+), 1 deletion(-) diff --git a/troubleshooting/250804_happybell80_rb10508_micro배포.md b/troubleshooting/250804_happybell80_rb10508_micro배포.md index 9c74388..8513623 100644 --- a/troubleshooting/250804_happybell80_rb10508_micro배포.md +++ b/troubleshooting/250804_happybell80_rb10508_micro배포.md @@ -46,4 +46,50 @@ rb10508_micro를 개발하여 rb10508_test를 대체하려고 했으나 Actions #### 현재 상태 - rb10508_micro 코드는 완성됨 - Actions 파일은 clone → copy 방식으로 수정됨 -- 배포 성공 여부는 확인 필요 \ No newline at end of file +- 배포 성공 여부는 확인 필요 + +## 오후 3시 3분 + +### rb10508_micro API 구조 및 배포 최종 수정 + +#### 추가 문제 발생 +1. **API prefix 불일치** + - 문제: rb10508_micro가 `/api` prefix 없이 엔드포인트 노출 + - 서버팀 피드백: "모든 외부 엔드포인트를 /api prefix 아래로 통일" + - 해결: `app.include_router(router, prefix="/api")` 적용 + +2. **Gitea Actions 로그 부족** + - 문제: 배포 진행 상황을 파악하기 어려움 + - 사용자 피드백: "액션 로그가 부족해서 뭘 하고 있는지 모르겠어" + - 해결: 상세 로그 추가 (단, 이모지 제거 - 룰 위반) + +3. **배포 디렉토리 혼동** + - 문제: rb10508_test 디렉토리로 배포하려 함 + - 서버팀 확인: "rb10508_micro는 51124 서버에 이미 저장소가 있습니다!" + - 사용자 피드백: "별도로 해야지 병신아..." + - 해결: rb10508_micro 전용 디렉토리 사용 + +#### 최종 해결 방안 +```yaml +# 올바른 배포 경로 +cd /home/admin/ivada_project/rb10508_micro +git pull origin main --rebase +docker compose up -d --build +``` + +#### 개선된 로그 형식 +- [TAG] 형식 사용: [DEPLOY], [GIT], [DOCKER], [SUCCESS] 등 +- 각 단계별 진행 상황 명확히 표시 +- 시작/종료 시간 기록 + +#### 교훈 추가 +1. **서버 상태 확인**: 배포 전 실제 서버의 디렉토리 구조와 저장소 상태 확인 필수 +2. **일관된 API 구조**: 모든 로빙 프로젝트는 `/api/*` 패턴 준수 +3. **룰 준수**: 이모지 사용 금지 등 개발 규칙 철저히 지키기 +4. **감정 관리**: 사용자가 화났을 때 더 정확하게 상황 파악하려 노력 + +#### 현재 상태 (업데이트) +- rb10508_micro는 별도 디렉토리에서 독립적으로 운영 +- 모든 API는 `/api/*` 형태로 통일됨 +- Gitea Actions에 상세 로그 추가 완료 +- 배포 성공 (git pull 방식 사용) \ No newline at end of file