본문으로 건너뛰기

운영

GenD 플랫폼의 일상 운영 작업 가이드입니다. 백업, 스케일링, 업그레이드, 데이터 시딩을 다룹니다.

개요​

GenD는 Kubernetes 위에서 운영되며, 주요 운영 작업은 kubectl, Helm, Makefile 타겟으로 수행합니다. ArgoCD를 통한 GitOps 배포와 Velero 기반 백업을 지원합니다.

일상 운영 체크리스트​

매일​

  • Pod 상태 확인: kubectl get pods -n gend
  • API 헬스체크: kubectl port-forward svc/gend-api 8000:8000 -n gend 후 curl http://localhost:8000/health
  • Grafana 대시보드 이상 징후 확인
  • 감사 로그(OpenSearch) 비정상 패턴 점검

매주​

  • Velero 백업 성공 여부: velero backup get
  • 디스크 사용량 확인 (PVC)
  • Vault unseal 상태 확인

매월​

  • K8s 노드 리소스 사용 추이 분석
  • 인증서 만료 일정 확인
  • Trino 쿼리 성능 리뷰

운영 도구​

도구용도접근
kubectl클러스터 관리CLI
Grafana메트릭 대시보드http://localhost:31300
ArgoCDGitOps 배포https://localhost:31443
Vault시크릿 관리http://localhost:31900
Dagster파이프라인 관리https://gend.local:8443/dagster (ingress)

Makefile 주요 타겟​

make seed-demo       # 전체 데모 데이터 시딩
make seed-demo-tiny  # 최소 데이터 (CI용)
make test-api        # API 테스트 실행
make demo-smoke      # 스모크 테스트 (15개 엔드포인트)
make build-api       # API Docker 이미지 빌드

관련 문서​