Reorganize troubleshooting directory structure
- Moved 20250715_github_migration_to_local.md to docs/troubleshooting/ - Added new file 20250715_rb8001_rb10508_integration.md with integration process documentation
This commit is contained in:
happybell80
parent
c2ab4e1cd6
commit
f1b7b0c1d5
138
docs/troubleshooting/20250715_rb8001_rb10508_integration.md
Normal file
138
docs/troubleshooting/20250715_rb8001_rb10508_integration.md
Normal file
@ -0,0 +1,138 @@
|
||||
# RB8001과 RB10508_test 통합 프로세스
|
||||
|
||||
**날짜**: 2025-07-15
|
||||
**작업자**: Claude & happybell
|
||||
|
||||
## 개요
|
||||
|
||||
로빙(RO-BEING) 프로젝트에서 rb8001과 rb10508_test 두 시스템을 통합하여 컨테이너 기반 존재 관리 시스템을 구축하는 과정에서 발생한 문제들과 해결 방법을 기록합니다.
|
||||
|
||||
## 문제 상황
|
||||
|
||||
### 초기 목표
|
||||
- rb8001과 rb10508_test는 같은 목적이지만 코드가 다름
|
||||
- rb10508_test의 기능을 rb8001로 통합하여 8001 포트로 운영
|
||||
- 컨테이너 기반으로 레벨에 따른 동적 리소스 관리
|
||||
- 스탯/스킬/아이템 데이터는 외부 DB로 분리
|
||||
|
||||
### 발생한 문제들
|
||||
|
||||
**문제 1: 잘못된 접근 방식**
|
||||
- Task Master PRD 파싱 결과 "새로운 환경 구축"으로 진행
|
||||
- 기존 리소스 확인 없이 새 파일 생성 시도
|
||||
- `/home/happybell/projects/ivada/docker-compose.yml` 등 불필요한 파일 생성
|
||||
|
||||
**문제 2: 기존 인프라 미파악**
|
||||
- 서버에 이미 PostgreSQL, ChromaDB, Neo4j 설치되어 있음
|
||||
- nginx-deploy에 이미 운영 중인 설정 존재
|
||||
- 각 프로젝트별로 이미 완성된 Docker 설정 존재
|
||||
|
||||
## 해결 과정
|
||||
|
||||
### 1단계: 상황 재평가
|
||||
|
||||
```bash
|
||||
# 기존 파일 확인
|
||||
find . -name "docker-compose.yml" -o -name ".env*" -o -name "nginx*"
|
||||
|
||||
# 결과:
|
||||
# - nginx-deploy/server-nginx-default (운영 중)
|
||||
# - rb8001/docker-compose.yml
|
||||
# - rb10508_test/docker-compose.yml
|
||||
# - 각종 .env 파일들
|
||||
```
|
||||
|
||||
**발견사항**:
|
||||
- nginx-deploy에서 이미 ro-being.com SSL 인증서 설정 완료
|
||||
- 현재 라우팅: `/` → 5173(frontend), `/api/` → 8000, `/rb10508/` → 10508
|
||||
- rb10508_test는 이미 완벽하게 작동하는 컨테이너와 Gitea Actions 보유
|
||||
|
||||
### 2단계: 접근 방식 변경
|
||||
|
||||
**기존 계획 (잘못됨)**:
|
||||
1. 새로운 Docker Compose 환경 구축
|
||||
2. 모든 DB를 컨테이너로 설치
|
||||
3. 새로운 프로젝트 구조 생성
|
||||
|
||||
**수정된 계획 (올바름)**:
|
||||
1. rb10508_test의 작동하는 코드를 rb8001로 복사
|
||||
2. 포트만 8001로 변경
|
||||
3. 서버의 기존 DB 활용 (컨테이너 X)
|
||||
4. 스킬 패키지 분리는 나중에 (작동 확인 후)
|
||||
|
||||
### 3단계: 실제 작업 수행
|
||||
|
||||
```bash
|
||||
# 1. requirements.txt 통합
|
||||
cp /home/happybell/projects/ivada/rb10508_test/requirements.txt \
|
||||
/home/happybell/projects/ivada/rb8001/requirements.txt
|
||||
|
||||
# 2. 확장된 디렉토리 구조 복사
|
||||
cp -r rb10508_test/app/skills rb8001/app/
|
||||
cp -r rb10508_test/app/stats rb8001/app/
|
||||
cp -r rb10508_test/app/utils rb8001/app/
|
||||
|
||||
# 3. 핵심 서비스 파일 복사
|
||||
cp rb10508_test/app/services/robing_brain.py rb8001/app/services/
|
||||
cp rb10508_test/app/services/chroma_service.py rb8001/app/services/
|
||||
cp rb10508_test/app/services/gemini_service.py rb8001/app/services/
|
||||
cp rb10508_test/app/services/slack_service.py rb8001/app/services/
|
||||
|
||||
# 4. Gitea Actions 설정 복사
|
||||
cp -r rb10508_test/.gitea rb8001/
|
||||
```
|
||||
|
||||
### 4단계: Docker Compose 수정
|
||||
|
||||
rb8001/docker-compose.yml 수정:
|
||||
- 컨테이너 이름: `robeing-8001`
|
||||
- 포트 매핑: `8001:8000`
|
||||
- `network_mode: host` (서버 DB 접근용)
|
||||
- 환경변수에 `ROBING_ID=8001` 추가
|
||||
- PostgreSQL 컨테이너 제거 (서버 DB 사용)
|
||||
|
||||
## 주요 교훈
|
||||
|
||||
### 1. 기존 리소스 먼저 확인
|
||||
- 새로 만들기 전에 반드시 기존 파일과 설정 확인
|
||||
- `ls`, `find`, `cat` 명령으로 현재 상태 파악
|
||||
|
||||
### 2. 단계적 접근의 중요성
|
||||
- "작동하는 시스템" 먼저 만들기
|
||||
- 그 다음에 리팩토링과 개선 진행
|
||||
- 스킬 패키지 분리 같은 큰 변경은 나중에
|
||||
|
||||
### 3. 서버 환경 이해
|
||||
- Docker는 애플리케이션만 (DB는 서버에 직접 설치)
|
||||
- `network_mode: host`로 서버 리소스 접근
|
||||
- 포트 충돌 주의 (8001은 ROBING_ID와 일치)
|
||||
|
||||
## 다음 단계
|
||||
|
||||
1. **Gitea Actions 포트 변경**: 10508 → 8001
|
||||
2. **nginx 설정 추가**: `/rb8001/` 라우팅 추가
|
||||
3. **컨테이너 빌드 및 배포 테스트**
|
||||
4. **정상 작동 확인 후 스킬 패키지 분리 작업**
|
||||
|
||||
## 참고 명령어
|
||||
|
||||
```bash
|
||||
# 컨테이너 빌드 및 실행
|
||||
cd rb8001
|
||||
docker compose up -d --build
|
||||
|
||||
# 헬스체크
|
||||
curl http://localhost:8001/health
|
||||
|
||||
# 로그 확인
|
||||
docker compose logs -f robeing-8001
|
||||
|
||||
# Gitea Actions 수동 실행
|
||||
# Gitea 웹 UI에서 Actions 탭 → Run workflow
|
||||
```
|
||||
|
||||
## 관련 파일
|
||||
- `/home/happybell/projects/ivada/rb8001/docker-compose.yml`
|
||||
- `/home/happybell/projects/ivada/rb8001/.gitea/workflows/cicd.yml`
|
||||
- `/home/happybell/projects/ivada/nginx-deploy/server-nginx-default`
|
||||
- Task Master 작업: `.taskmaster/tasks/tasks.json`
|
||||
@ -1,76 +0,0 @@
|
||||
# GitHub Migration to Local Project - 20250715
|
||||
|
||||
## 문제 상황
|
||||
- admin@robeing-brains:~/github-migration에 있는 프로젝트 폴더들을 happybell80 사용자의 로컬 프로젝트로 이전
|
||||
- 각 폴더의 git remote URL에 기존 ivada_Ro-being 사용자의 토큰이 설정되어 있음
|
||||
- 일부 저장소는 Gitea에서 다른 이름으로 리다이렉트되거나 존재하지 않음
|
||||
|
||||
## 해결 과정
|
||||
|
||||
### 1. 폴더 복사
|
||||
```bash
|
||||
# 각 폴더를 로컬로 복사
|
||||
cp -r /home/admin/github-migration/DOCS /home/happybell80/my_project/
|
||||
cp -r /home/admin/github-migration/admin_page /home/happybell80/my_project/
|
||||
cp -r /home/admin/github-migration/api-base /home/happybell80/my_project/
|
||||
cp -r /home/admin/github-migration/frontend-base /home/happybell80/my_project/
|
||||
cp -r /home/admin/github-migration/nginx-infra /home/happybell80/my_project/
|
||||
cp -r /home/admin/github-migration/test /home/happybell80/my_project/
|
||||
cp -r /home/admin/github-migration/test_front /home/happybell80/my_project/
|
||||
cp -r /home/admin/github-migration/test_meta-skill /home/happybell80/my_project/
|
||||
|
||||
# 추가 설정 파일들 복사
|
||||
cp /home/admin/BACKUP_TO_NAS_POLICY.md /home/happybell80/my_project/
|
||||
cp /home/admin/CLAUDE.md /home/happybell80/my_project/
|
||||
cp /home/admin/ROBING_ARCHITECTURE_PHILOSOPHY.md /home/happybell80/my_project/
|
||||
```
|
||||
|
||||
### 2. Git Remote 토큰 업데이트
|
||||
각 폴더에서 happybell80 사용자의 개인 액세스 토큰으로 변경:
|
||||
```bash
|
||||
# 예시: DOCS 폴더
|
||||
cd /home/happybell80/my_project/DOCS
|
||||
git remote set-url origin https://happybell80:8676690e3b33291abfed9294c8d06044ec48d7a0@git.ro-being.com/ivada_Ro-being/docs.git
|
||||
```
|
||||
|
||||
### 3. 저장소 상태 확인 및 정리
|
||||
|
||||
#### 성공한 저장소들:
|
||||
- **DOCS**: 정상 pull 완료
|
||||
- **frontend-base**: 정상 pull 완료 (업데이트 있음)
|
||||
- **nginx-infra**: 정상 pull 완료
|
||||
- **test_meta-skill**: 정상 pull 완료
|
||||
|
||||
#### 폴더명 변경 (리다이렉트):
|
||||
- **api-base → rb8001**: Gitea에서 rb8001로 리다이렉트됨
|
||||
- **test → rb10508_test**: Gitea에서 rb10508_test로 리다이렉트됨
|
||||
|
||||
#### 리모트 제거 (저장소 없음):
|
||||
- **admin_page**: 저장소가 존재하지 않아 remote 제거
|
||||
- **test_front**: 저장소가 존재하지 않아 remote 제거
|
||||
|
||||
### 4. 최종 명령어 예시
|
||||
```bash
|
||||
# 폴더명 변경
|
||||
mv api-base rb8001
|
||||
mv test rb10508_test
|
||||
|
||||
# 리모트 제거
|
||||
cd admin_page && git remote remove origin
|
||||
cd test_front && git remote remove origin
|
||||
|
||||
# 업데이트된 URL로 리모트 설정
|
||||
cd rb8001 && git remote set-url origin https://happybell80:TOKEN@git.ro-being.com/ivada_Ro-being/rb8001.git
|
||||
cd rb10508_test && git remote set-url origin https://happybell80:TOKEN@git.ro-being.com/ivada_Ro-being/rb10508_test.git
|
||||
```
|
||||
|
||||
## 결과
|
||||
- 총 8개 폴더 이전 완료
|
||||
- 6개 저장소 정상 연결 (4개 기존명, 2개 새명)
|
||||
- 2개 저장소 리모트 제거 (존재하지 않음)
|
||||
- 모든 저장소가 happybell80 사용자 토큰으로 업데이트됨
|
||||
|
||||
## 교훈
|
||||
1. 저장소 이전시 실제 Gitea 저장소명과 로컬 폴더명 일치 확인 필요
|
||||
2. 저장소 존재 여부 확인 후 리모트 설정 필요
|
||||
3. 개인 액세스 토큰 교체 시 모든 저장소 일괄 업데이트 필요
|
||||
Loading…
x
Reference in New Issue
Block a user