ivada-infra/DOCS
3
0
Fork 0
Code Issues 1 Pull Requests 5 Actions Packages Projects Releases Wiki Activity
DOCS/book/300_architecture/reference/deployment_pipelines.md
Claude-51124 46baeaff91 docs: 개발 참조 문서 추가 (reference/) 
- API 엔드포인트 정리 (api_endpoints.md)
- 인프라 정보 정리 (infrastructure.md)
- 환경변수 정리 (environment_variables.md)
- 배포 파이프라인 정리 (deployment_pipelines.md)
- 상수/설정값 정리 (constants.md)
- 네이밍 컨벤션 정리 (naming_conventions.md)
- 로깅 규칙 정리 (logging_rules.md)

목적: 개발 시 중복/오류 방지, 빠른 참조
모든 문서 100줄 이하 유지, 파일:줄번호 참조 사용
2025-12-06 13:28:46 +09:00

2.2 KiB
Raw Blame History

배포 파이프라인 참조

작성일: 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

배포 절차

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

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