bkyungee
154 lines
6.2 KiB
Markdown
154 lines
6.2 KiB
Markdown
# exdev 서버 배포 — exAichatbot Agent 2.0
|
|
|
|
`chatbot.exdev.co.kr` Mac Studio 서버에 Agent 2.0 스택(RAG + WAS + Skill + chatbotApp)을 배포합니다.
|
|
|
|
## GitHub upstream (submodule)
|
|
|
|
4개 서비스 소스는 GitHub `KoreaExpressWayCorp` 저장소를 **git submodule**로 연결합니다.
|
|
|
|
| monorepo 경로 | GitHub | 브랜치 |
|
|
|---------------|--------|--------|
|
|
| `chatbotApp-chatbot2.0-agent` | https://github.com/KoreaExpressWayCorp/chatbotApp.git | `chatbot2.0-agent` |
|
|
| `chatbotApi-chatbot2.0-agent` | https://github.com/KoreaExpressWayCorp/chatbotApi.git | `chatbot2.0-agent` |
|
|
| `exAiChatBot-chatbot2.0-agent` | https://github.com/KoreaExpressWayCorp/exAiChatBot.git | `chatbot2.0-agent` |
|
|
| `kakaoChatbotSkill-chatbot2.0-agent` | https://github.com/KoreaExpressWayCorp/kakaoChatbotSkill.git | `chatbot2.0-agent` |
|
|
|
|
최초 clone:
|
|
|
|
```bash
|
|
git clone --recurse-submodules ssh://aidev@github.exdev.co.kr:2222/aidev/exAichatbot_agent.git
|
|
```
|
|
|
|
GitHub 최신 반영:
|
|
|
|
```bash
|
|
./git_fetch_all.sh # GitHub → 로컬 submodule fast-forward
|
|
./git_fetch_all.sh --dry-run # 변경 예상만 확인
|
|
./git_fetch_all.sh --init # submodule 최초 clone 포함
|
|
```
|
|
|
|
RAG Docker compose(`docker-compose.server.yml`)는 submodule 밖 **`server-dev/docker-compose.rag.server.yml`** 에 두고, 기동 시 `exAiChatBot-chatbot2.0-agent/`로 복사합니다.
|
|
|
|
## 디렉터리
|
|
|
|
| 경로 (서버) | 용도 |
|
|
|-------------|------|
|
|
| `/Users/aidev/dev/exAichatbot_agent` | Git work tree (배포 소스) |
|
|
| `/Volumes/ADATA/git/exAichatbot_agent.git` | Gitea bare repo |
|
|
| `/Volumes/ADATA/git/deploy-exAichatbot_agent.sh` | push → 배포 스크립트 |
|
|
|
|
## 1회 설정 (서버)
|
|
|
|
```bash
|
|
ssh aidev@chatbot.exdev.co.kr
|
|
bash /Users/aidev/dev/exAichatbot_agent/server-dev/setup-gitea.sh
|
|
```
|
|
|
|
Gitea(`https://github.exdev.co.kr`)에서 **`exAichatbot_agent`** 저장소 생성 (Initialize unchecked).
|
|
|
|
## 로컬 Mac → Gitea push → 서버 배포
|
|
|
|
개발 Mac에서 **한 번에** Gitea 최신 반영 · 로컬 변경 commit/push · 서버 빌드·배포:
|
|
|
|
```bash
|
|
./start-all-server.sh
|
|
# = (push-to-gitea) Gitea fetch/merge → 로컬 commit → Gitea push → 원격 배포
|
|
# 공식 GitHub push 없음
|
|
|
|
./git_fetch_all.sh
|
|
# = 공식 GitHub(KoreaExpressWayCorp) submodule sync/commit/push 전용
|
|
```
|
|
|
|
`push-to-gitea.sh` 는 `git_fetch_all.sh` 와 같이 **원격(Gitea) 변경을 먼저 merge** 한 뒤 로컬을 올립니다.
|
|
충돌 시 스크립트가 멈추므로 수동 해결 후 재실행하세요.
|
|
(서버 work tree에만 있고 Gitea에 없는 수정은 포함되지 않습니다 — 배포는 Gitea 기준입니다.)
|
|
|
|
| 옵션 | 설명 |
|
|
|------|------|
|
|
| `--local` | 예전처럼 `local-dev/start-all.sh` 로컬 개발 모드 |
|
|
| `--no-push` | Gitea push·원격 배포 생략 |
|
|
| `--no-pull` | GitHub submodule fetch 생략 |
|
|
| `--no-build` | Docker/Next 빌드 생략 (서버에서만 해당) |
|
|
|
|
수동 push만:
|
|
|
|
```bash
|
|
./server-dev/push-to-gitea.sh
|
|
./server-dev/push-to-gitea.sh --dry-run
|
|
```
|
|
|
|
**main push 시 자동:** `post-receive` → `deploy-exAichatbot_agent.sh` → Gitea checkout → `start-all-server.sh --no-pull --no-push`
|
|
(공식 GitHub `git_fetch_all` 은 deploy 경로에서 호출하지 않음)
|
|
|
|
서버에서 GitHub clone 이 안 되면 **로컬 `./start-all-server.sh`** 가 submodule rsync + chatbotApp 로컬 빌드 후 배포합니다.
|
|
|
|
배포 로그: `/Volumes/ADATA/logs/deploy/exAichatbot_agent.log`
|
|
|
|
## 로컬 → Gitea push (수동)
|
|
|
|
```bash
|
|
cd exChatbot_agent
|
|
|
|
# Gitea (이 서버는 git@ 가 아닌 aidev@ 사용)
|
|
git remote add origin ssh://aidev@github.exdev.co.kr:2222/aidev/exAichatbot_agent.git
|
|
git push -u origin main
|
|
|
|
# 잘못된 예 (Permission denied):
|
|
# git@github.exdev.co.kr:aidev/exAichatbot_agent.git
|
|
```
|
|
|
|
## 수동 기동 / 중지 (서버)
|
|
|
|
```bash
|
|
cd /Users/aidev/dev/exAichatbot_agent
|
|
|
|
./server-dev/stop-all-server.sh
|
|
./server-dev/start-all-server.sh # Gitea checkout → GitHub submodule → 빌드 → 기동
|
|
./server-dev/start-all-server.sh --no-build
|
|
./server-dev/start-all-server.sh --no-pull # git 동기화 생략
|
|
./server-dev/start-all-server.sh --no-push # Gitea push 생략 (서버 전용)
|
|
```
|
|
|
|
## 스택 구성
|
|
|
|
| 서비스 | 포트 | URL |
|
|
|--------|------|-----|
|
|
| HTTPS UI (Caddy) | 443 | https://chatbot.exdev.co.kr/chatbot/app/ |
|
|
| chatbotApp nginx | 8092 | 내부 |
|
|
| kakaoChatbotSkill | 8083 | /web/ask, /kakao/skill (카카오 웹훅) |
|
|
| chatbotApi WAS | 8086 | /api |
|
|
| RAG API | 28012 | /agent/chat |
|
|
| Vector Admin | 28013 | /chatbot/admin |
|
|
| Qdrant | 6333 | REST |
|
|
| Oracle TROAD | 1521 | `localhost:1521/orcl2` (OPR_MAIN / test) |
|
|
| 호스트 AI | 16000~16002 | MLX LLM/Embed/Rerank |
|
|
|
|
## Oracle TROAD (교통정보)
|
|
|
|
- Docker Compose: `server-dev/docker-compose.oracle.yml` (`gvenzl/oracle-free:23-slim`, arm64 지원)
|
|
- 상세: [`server-dev/oracle/README.md`](oracle/README.md)
|
|
- `start-all-server.sh` 기동 시 Oracle 컨테이너 자동 시작 + WAS에
|
|
`SPRING_DATASOURCE_TROAD_URL/USERNAME/PASSWORD` 를 **localhost** 로 ENV 주입
|
|
(`application.yml` 운영 172.16.163.76 값은 파일에 그대로 둠 — `git_fetch_all.sh` push 시 복원·검증)
|
|
- `stop-all-server.sh` 중지 시 자동 중지(데이터 볼륨 유지)
|
|
- 업무 객체는 `server-dev/oracle/sql/*.sql` — 기동 후 비어 있으면 `oracle/apply-sql.sh` 가 자동 적용
|
|
- `OPR_MAIN.V_INCIDENT_FTMS` (돌발/정체 교통정보, 샘플 124건)
|
|
- `TROAD_APP.V_ROUTE_NEW_NM` / `V_ROUTE_TRFC_VER001` / `TLISDEV.T_TRMB_CD_INFO01M1` (노선별 혼잡 — **기존 chatbotApi 조회 SQL 그대로**)
|
|
- 옵션: `--skip-oracle`, `--keep-oracle`, `--purge-oracle`
|
|
|
|
## Qdrant 데이터
|
|
|
|
- 최초 기동 시 `vector_count=0` 이면 레거시 `exAIChatbot2.0/exAiChatBot-chatbot2.0/qdrant_data` 를 자동 복사
|
|
- 이후 `qdrant_data/` 볼륨 영속 유지 (git 제외)
|
|
|
|
## 환경변수
|
|
|
|
```bash
|
|
cp server-dev/env.exdev-server.template exAiChatBot-chatbot2.0-agent/.env
|
|
```
|
|
|
|
## 레거시 스택
|
|
|
|
`start-all-server.sh`는 포트 충돌 방지를 위해 `exAIChatbot2.0/remote-stop-chatbot.sh` 로 레거시 스택을 중지합니다.
|
|
유지하려면 `--skip-legacy-stop` 옵션을 사용하세요.
|