deployment/uiux/
├── Dockerfile              # nginx 기반 Docker 이미지 빌드 파일
├── nginx.conf             # nginx 웹서버 설정
├── build.sh               # Linux/Mac용 이미지 빌드 스크립트
├── build.bat              # Windows용 이미지 빌드 스크립트
├── k8s/
│   ├── deployment.yaml    # Kubernetes Deployment 매니페스트
│   ├── service.yaml       # Kubernetes Service 매니페스트
│   └── ingress.yaml       # Kubernetes Ingress 매니페스트
└── README.md              # 이 파일

🎯 프로토타입 파일

배포 대상 프로토타입 HTML 파일 위치:

design/uiux/prototype/
├── 01-로그인.html
├── 02-대시보드.html
├── 03-회의예약.html
├── 04-템플릿선택.html
├── 05-회의진행.html
├── 07-회의종료.html
├── 10-회의록상세조회.html
├── 11-회의록수정.html
└── 12-회의록목록조회.html

🚀 Quick Start

1. Docker 이미지 빌드

Linux/Mac

# 프로젝트 루트 디렉토리에서 실행
cd /path/to/HGZero
chmod +x deployment/uiux/build.sh
./deployment/uiux/build.sh

Windows

REM 프로젝트 루트 디렉토리에서 실행
cd C:\path\to\HGZero
deployment\uiux\build.bat

2. Kubernetes 배포

# 모든 리소스 배포
kubectl apply -f deployment/uiux/k8s/

# 또는 개별 배포
kubectl apply -f deployment/uiux/k8s/deployment.yaml
kubectl apply -f deployment/uiux/k8s/service.yaml
kubectl apply -f deployment/uiux/k8s/ingress.yaml

3. 배포 확인

# Pod 상태 확인
kubectl get pods -l app=hgzero-uiux-prototype

# Service 확인
kubectl get svc hgzero-uiux-prototype

# Ingress 확인 (배포한 경우)
kubectl get ingress hgzero-uiux-prototype

4. 프로토타입 접근

방법 1: Port Forward (개발 환경)

kubectl port-forward svc/hgzero-uiux-prototype 8080:80

브라우저에서 http://localhost:8080 접속

방법 2: NodePort (테스트 환경)

# NodePort 확인
kubectl get svc hgzero-uiux-prototype

# 접속: http://<node-ip>:30080

방법 3: Ingress (운영 환경)

/etc/hosts에 다음 추가:

<ingress-controller-ip> prototype.hgzero.local

브라우저에서 http://prototype.hgzero.local 접속

📝 상세 가이드

Docker 이미지 빌드

수동 빌드

# 프로젝트 루트에서 실행
docker build \
  -t hgzero-uiux-prototype:latest \
  -f deployment/uiux/Dockerfile \
  .

태그 지정 빌드

# 버전 태그 지정
./deployment/uiux/build.sh v1.0.0

레지스트리 푸시

# 환경 변수로 레지스트리 지정
export DOCKER_REGISTRY=myregistry.example.com
./deployment/uiux/build.sh

# 또는 수동 태그 및 푸시
docker tag hgzero-uiux-prototype:latest myregistry.example.com/hgzero-uiux-prototype:latest
docker push myregistry.example.com/hgzero-uiux-prototype:latest

Kubernetes 리소스 상세

Deployment 설정

이미지: hgzero-uiux-prototype:latest
레플리카: 2개
리소스 요청: CPU 50m, Memory 64Mi
리소스 제한: CPU 200m, Memory 128Mi
Health Check: /health 엔드포인트

Service 설정

타입: NodePort
포트: 80 (내부), 30080 (외부)
셀렉터: app=hgzero-uiux-prototype

Ingress 설정

호스트: prototype.hgzero.local
IngressClass: nginx
경로: / (모든 경로)

커스터마이징

nginx 설정 수정

deployment/uiux/nginx.conf 파일을 수정하여 웹서버 동작 변경 가능:

기본 인덱스 페이지
캐시 정책
Gzip 압축 설정
로깅 설정

Kubernetes 리소스 조정

deployment/uiux/k8s/*.yaml 파일 수정:

레플리카 수 조정
리소스 제한 변경
서비스 타입 변경 (NodePort → LoadBalancer)
Ingress 호스트명 변경

🔧 트러블슈팅

이미지 빌드 실패

# Docker 데몬 확인
docker ps

# Dockerfile 경로 확인
ls -la deployment/uiux/Dockerfile

# 프로토타입 파일 확인
ls -la design/uiux/prototype/*.html

Pod 시작 실패

# Pod 로그 확인
kubectl logs -l app=hgzero-uiux-prototype

# Pod 상세 정보
kubectl describe pod <pod-name>

# 이벤트 확인
kubectl get events --sort-by='.lastTimestamp'

접근 불가

# Service 엔드포인트 확인
kubectl get endpoints hgzero-uiux-prototype

# Pod 네트워크 테스트
kubectl exec -it <pod-name> -- wget -O- http://localhost/health

# Ingress 컨트롤러 확인
kubectl get pods -n ingress-nginx

🔄 업데이트 및 재배포

이미지 업데이트

# 1. 새 이미지 빌드
./deployment/uiux/build.sh v1.0.1

# 2. Deployment 이미지 업데이트
kubectl set image deployment/hgzero-uiux-prototype \
  nginx=hgzero-uiux-prototype:v1.0.1

# 3. 롤아웃 상태 확인
kubectl rollout status deployment/hgzero-uiux-prototype

롤백

# 이전 버전으로 롤백
kubectl rollout undo deployment/hgzero-uiux-prototype

# 특정 리비전으로 롤백
kubectl rollout undo deployment/hgzero-uiux-prototype --to-revision=2

🗑️ 리소스 삭제

# 모든 리소스 삭제
kubectl delete -f deployment/uiux/k8s/

# 또는 개별 삭제
kubectl delete deployment hgzero-uiux-prototype
kubectl delete service hgzero-uiux-prototype
kubectl delete ingress hgzero-uiux-prototype

📊 모니터링

리소스 사용량 확인

# Pod 리소스 사용량
kubectl top pods -l app=hgzero-uiux-prototype

# 상세 메트릭 (Metrics Server 필요)
kubectl get --raw /apis/metrics.k8s.io/v1beta1/namespaces/default/pods

로그 확인

# 실시간 로그
kubectl logs -f -l app=hgzero-uiux-prototype

# 최근 로그 (100줄)
kubectl logs --tail=100 -l app=hgzero-uiux-prototype

# 이전 컨테이너 로그
kubectl logs <pod-name> --previous

🔐 보안 고려사항

프로덕션 환경: Ingress에 TLS 설정 추가
네트워크 정책: Pod 간 통신 제한
리소스 제한: 명확한 리소스 쿼터 설정
이미지 보안: 정기적인 베이스 이미지 업데이트

README.md

HGZero UI/UX Prototype Deployment

📁 디렉토리 구조