# 배포 파이프라인 참조

**작성일**: 2025-12-06
**목적**: 배포 프로세스 빠른 참조

---

## 자동 배포 (Gitea Actions)

### 배포 대상 서비스
- rb8001
- robeing-monitor
- skill_email
- skill_news
- skill-rag-file
- skill-publish
- skill-slack
- fluent-bit
- frontend-customer
- frontend-ir-valuation

**참고**: `AGENTS.md:28-29`

### 배포 플로우
1. 로컬에서 코드 수정
2. `git push origin main`
3. Gitea Actions 자동 실행 (51123 서버)
4. SSH로 51124 서버 접속
5. `git pull origin main`
6. `docker compose down && docker compose up -d --build`
7. 헬스체크 확인

**참고**: `AGENTS.md:83-85`

### 워크플로우 파일 위치
- 경로: `.gitea/workflows/*.yml`
- 예시: `rb8001/.gitea/workflows/cicd.yml`

---

## 수동 배포

### 배포 대상 서비스
- skill-embedding
- skill-calendar

**참고**: `AGENTS.md:29`

### 배포 절차
```bash
cd /home/admin/ivada_project/[서비스명]
git pull origin main
docker compose down && docker compose up -d --build
docker ps  # 재시작 확인
```

---

## 배포 검증

### 필수 확인 사항
- [ ] `docker ps`로 컨테이너 실행 확인
- [ ] 헬스체크 엔드포인트 응답 확인
- [ ] 로그 확인 (`docker logs [컨테이너명] --tail 50`)

**주의**: Actions 성공 메시지만 믿지 말고 실제 컨테이너 상태 확인

**참고**: `AGENTS.md:30-31`

---

## SSH Secrets

| Secret 이름 | 설명 | 사용 위치 |
|------------|------|-----------|
| `SSH_PRIVATE_KEY_51124` | 51124 서버 SSH 키 | Gitea Actions |
| `SSH_HOST_51124` | 192.168.219.52 | Gitea Actions |
| `SSH_USER_51124` | admin | Gitea Actions |

**참고**: `DOCS/journey/plans/251206_skill_calendar_자동배포_구성.md`

---

## 트러블슈팅

### Actions 캐시 문제
- 증상: 워크플로우 수정이 반영되지 않음
- 해결: `/root/.cache/act/` 삭제
- 참고: `DOCS/journey/troubleshooting/250929_actions_cache_problem.md`

### SSH 인증 실패
- 증상: "Permission denied (publickey)"
- 해결: Gitea Secrets의 SSH 키 확인
- 참고: `DOCS/journey/troubleshooting/250728_happybell80_nginx프록시및CI배포문제해결.md`

---

**업데이트**: 배포 프로세스 변경 시 즉시 반영