feat: GitHub Deployment 공식 연동 및 배포 리포트 자동화

[hyunwoo0081]

🚀 작업 개요

배포 프로세스의 투명성을 높이고, 개발자와 협업자들이 배포 상태를 GitHub 상에서 쉽고 직관적으로 확인할 수 있도록 CI/CD 워크플로우를 개선했습니다.

---

🧐 기존의 문제점 (Why?)

• 배포 상태 확인의 어려움: 배포가 성공했는지, 현재 서버에 어떤 버전이 올라가 있는지 확인하려면 직접 GitHub Actions 로그를 뒤져보거나 서버에 접속해야 했습니다.
• 가시성 부족: 인프라 구조를 잘 모르는 팀원들은 현재 운영/개발 서버의 최신 URL이 무엇인지, 배포가 진행 중인지 알기 어려웠습니다.
• 이력 관리 부재: 과거에 언제, 어떤 코드가 배포되었는지에 대한 공식적인 기록(History)이 GitHub 환경 탭에 남지 않았습니다.

🛠 해결 방법 (How?)

1. GitHub 공식 Deployment 연동:
   • environment 설정을 통해 GitHub이 제공하는 공식 배포 관리 기능을 활성화했습니다.
   • 이제 GitHub 레포지토리 메인 우측의 Environments 섹션에서 실시간 배포 상태를 볼 수 있습니다.
2. 배포 리포트 자동 생성 (Job Summary):
   • 배포가 완료되면 Actions 실행 결과 페이지에 Client와 Admin 서비스의 배포 결과와 접속 URL을 표 형식으로 정리하여 보여줍니다.
3. 불필요한 복잡도 제거:
   • PR Preview(미리보기)의 경우, 너무 많은 배포 기록이 남으면 오히려 혼란을 줄 수 있어 기존의 편리한 'PR 댓글 안내' 방식만 유지하고 공식 기록은 운영/개발 서버에만 남기도록 최적화했습니다.

✨ 변경 후 달라지는 점 (Result!)

• 한눈에 보는 배포 상태: 이제 레포지토리 첫 화면에서 'production', 'development' 서버가 정상 작동 중인지 바로 확인할 수 있습니다.
• 빠른 서비스 접속: 배포가 끝나면 일일이 주소를 입력할 필요 없이, GitHub Actions 결과창에서 제공되는 링크를 클릭해 즉시 확인이 가능합니다.
• 투명한 이력 관리: 누가, 언제, 어떤 기능을 배포했는지에 대한 타임라인이 GitHub에 영구적으로 기록되어 장애 복구나 버전 관리가 훨씬 수월해집니다.

---

📝 주요 변경 파일

• .github/workflows/build-deploy.yml: 운영 환경 배포 리포트 및 Deployment 연동
• .github/workflows/dev-build-deploy.yml: 개발 환경 배포 리포트 및 Deployment 연동
• .github/workflows/pr-ci.yml: PR 미리보기 워크플로우 최적화

[github-actions]

🚀 Preview Deployment

• Client: https://dev.allcll.kr/pr-352/
• Admin: https://dev-admin.allcll.kr/pr-352/

This preview is automatically updated on each push.

[sonarqubecloud]

Quality Gate failed

Failed conditions
C Security Rating on New Code (required ≥ A)

See analysis details on SonarQube Cloud

Catch issues before they fail your Quality Gate with our IDE extension SonarQube for IDE

[hyunwoo0081]

위험

버그, 런타임 에러, 빌드 실패 가능성이 있는 항목. 반드시 이번 PR에서 수정.

• [.github/workflows/build-deploy.yml:111, 190] Deployment Report 스크립트 내 오타
  • 이유: \statuss, \status}\ 와 같이 변수명이나 중괄호 오타가 있습니다.
  • 수정 방향: \\ 로 올바르게 수정이 필요합니다.

중간

컨벤션 위반, 관심사 미분리, allcll-ui 미적용 등. 이번 PR에서 수정 권장.

• [.github/workflows/dev-build-deploy.yml:155] Step 이름 불일치
  • 이유: Admin 프로젝트를 빌드하는 과정인데 \Build Client project\에서 \Build Admin project\로 수정되었습니다. (이미 수정된 것으로 보이나 확인차 언급합니다.)

낮음

네이밍 개선, 리팩토링 제안 등. 추후 작업으로 미뤄도 무방.

• [GitHub Deployment 환경 관리]
  • 이유: \production, \production-admin, \development, \development-admin\ 등 환경 이름이 명확하게 구분되어 설정되었습니다. 추후 GitHub 레포지토리 설정에서 해당 환경들에 대한 보호 규칙(Protection Rules)을 설정하면 더 안전한 배포가 가능할 것 같습니다.