Update rb10508_micro deployment troubleshooting - add API structure and final deployment fixes

This commit is contained in:
happybell80 2025-08-04 15:06:02 +09:00
parent 5e29098cc7
commit 822b7ccb8c

View File

@ -47,3 +47,49 @@ rb10508_micro를 개발하여 rb10508_test를 대체하려고 했으나 Actions
- rb10508_micro 코드는 완성됨
- Actions 파일은 clone → copy 방식으로 수정됨
- 배포 성공 여부는 확인 필요
## 오후 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 방식 사용)