DOCS/troubleshooting/250919_skill_slack_deployment_plan.md
happybell80 c172c616b5 docs: skill-slack 배포 지침서 간소화 (349줄→95줄)
- 로빙 철학(스킬=도구, 판단 금지) 명확화
- thread_ts 버그 및 계정 이전 이슈 정리
- 핵심 배포 정보만 유지
2025-09-19 21:12:01 +09:00

96 lines
2.0 KiB
Markdown

# skill-slack 배포 지침서
## 문제
skill-slack의 역할을 로빙 철학(스킬=도구, 판단 금지)에 맞게 재정의하고 51124 서버에 배포
## 배포 정보
- **포트**: 8502
- **서버**: 51124 (192.168.219.52)
- **경로**: /home/admin/ivada_project/skill-slack
---
## 배포 전제조건
- [ ] thread_ts 버그 수정 [확인필요: messages.py]
- [ ] SERVICE_API_KEY 설정 [확인필요: 실제값]
- [ ] SLACK_BOT_TOKEN 설정 [확인필요: 실제값]
- [ ] heejae → admin 계정 이전
---
## 로빙 철학 적용
### 원칙
- **스킬 = 도구**: 판단 금지, 실행만
- **무상태**: 기억하지 않음
### API 변경
| 엔드포인트 | 상태 | 이유 |
|-----------|------|------|
| `/health` | 유지 | 헬스체크 |
| `/api/v1/send` | 유지 | 메시지 전송 |
| `/api/v1/update` | 유지 | 메시지 업데이트 |
| `/api/v1/summarize` | **삭제** | LLM 호출 (로빙 역할) |
| `/api/v1/digest` | **삭제** | 자체 처리 (로빙 역할) |
---
## 배포 절차
```bash
ssh admin@51124
cd /home/admin/ivada_project/skill-slack
git pull
docker compose down
docker compose up -d --build
docker logs skill-slack --tail=50
```
---
## 테스트
### 헬스체크
```bash
curl -f http://localhost:8502/health
```
### 스레드 응답 (핵심)
```bash
curl -X POST http://localhost:8502/api/v1/send \
-H "X-API-Key: [확인필요]" \
-H "Content-Type: application/json" \
-d '{"channel": "[확인필요]", "text": "테스트", "thread_ts": "[확인필요]"}'
```
---
## 주요 이슈
### 긴급
- **thread_ts 미작동**: 스레드 응답 불가
- **계정 이전**: heejae → admin 미완료
### 결정 필요
- 레이트리밋: Redis vs 파일
- 네트워크: host vs bridge
---
## 체크리스트
### 배포 전
- [ ] thread_ts 수정
- [ ] 토큰 설정
- [ ] 포트 확인
### 배포 후
- [ ] 헬스체크 200
- [ ] 스레드 응답 테스트
- [ ] summarize/digest 제거 확인
---
## 통합
- **rb8001**: 메시지 전송 요청
- **네이버웍스**: 슬랙 브릿지