46baeaff91
- API 엔드포인트 정리 (api_endpoints.md) - 인프라 정보 정리 (infrastructure.md) - 환경변수 정리 (environment_variables.md) - 배포 파이프라인 정리 (deployment_pipelines.md) - 상수/설정값 정리 (constants.md) - 네이밍 컨벤션 정리 (naming_conventions.md) - 로깅 규칙 정리 (logging_rules.md) 목적: 개발 시 중복/오류 방지, 빠른 참조 모든 문서 100줄 이하 유지, 파일:줄번호 참조 사용
100 lines
2.2 KiB
Markdown
100 lines
2.2 KiB
Markdown
# 배포 파이프라인 참조
|
|
|
|
**작성일**: 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`
|
|
|
|
---
|
|
|
|
**업데이트**: 배포 프로세스 변경 시 즉시 반영
|
|
|