01 서비스 개요

2025.04.16 - 2025.05.14

한성대학교 2025 대동제 축제 웹사이트

02 시연 영상 및 홍보 게시글

시연영상

시연영상

홍보게시글 1

홍보게시글2

03 주요 기여

• BE
  • openAI를 사용한 대동제 정보를 아는 AI 챗봇 구현
  • 공지사항 관련 API
• FE
  • 프론트 간단한 CSS 수정 및 애니메이션 추가
• Data

  • 축제 관련 데이터 가공

  • Google Analytics 사용

    

04 트러블 슈팅

• GitHub Actions에서 Docker 용량 부족 이슈 트러블슈팅

  ---

  문제 상황

  실제 서비스 운영 중, GitHub Actions CI 파이프라인에서 다음과 같은 에러가 발생:

  failed to register layer: write /usr/java/openjdk-17/lib/server/classes.jsa: no space left on device

  이는 GitHub Actions에서 사용하는 runner의 디스크 용량(약 14GB 제한)을 초과한 경우 발생하는 오류로, Docker 이미지가 누적되면서 빌드가 더 이상 진행되지 않는 상황

  ---

  원인 분석

  • Docker 캐시 이미지 및 중간 빌드 레이어가 지속적으로 누적됨
  • 매번 docker build를 수행하지만, 오래된 이미지 정리가 없었음
  • GitHub Actions의 ephemeral runner 환경에서는 주기적인 정리가 필요함

  ---

  해결 방안

  CI 배포 스크립트 내 Deploy to dev 단계에 다음 명령을 삽입하여 문제 해결:

  sudo docker image prune -a -f
  

  • 사용되지 않는 모든 Docker 이미지를 강제로 삭제, CI 환경에서 불필요한 디스크 점유를 방지하는 명령어

  ---

  배운 점

  • 배포되어있는 실시간 서비스에서는 빌드 실패가 곧 서비스 운영 중단으로 이어질 수 있음
  • GitHub Actions처럼 상태가 초기화되는 환경에서도 자원 누수 문제는 발생할 수 있으며, 이를 사전에 정리하는 전략이 필요
  • 단순히 코드만 잘 짠다고 끝나는 것이 아니라, 배포/CI/CD 환경의 자원 관리까지 포함한 인프라 운영 능력이 중요

  ---

  실무 활용

  • GitHub Actions를 사용하는 모든 팀에서 docker image prune 같은 클린업 명령은 필수적으로 고려해야 함
  • 앞으로는 Docker multi-stage build + 이미지 최소화 전략도 알아볼 계획