이 가이드는 Kubernetes 환경에서 EVA App을 빠르고 안정적으로 설치할 수 있도록 안내합니다.

🛠️ 사전 준비 사항

설치를 시작하기 전에 아래의 도구들이 준비되어 있는지 확인해 주세요.

aws configure
# 안내에 따라 AWS Access Key ID, Secret Access Key 등을 입력합니다.

🚀 EVA App 설치하기

1단계: Helm 저장소 등록

먼저 EVA App 배포를 위한 Helm 레포지토리를 추가합니다.

helm repo add eva-app <https://mellerikat.github.io/eva-app>
helm repo update

2단계: 설정 파일(values.yaml) 준비

설치 시 필요한 기본 설정 템플릿을 현재 폴더에 다운로드합니다.

helm show values eva-app/eva-app > values.yaml

3단계: 사용자 환경에 맞춰 설정 업데이트

다운로드한 values.yaml 파일을 열어 환경에 맞는 설정을 수정해야 합니다. **On-premise(자체 서버)**와 Cloud(AWS) 환경에 따라 주요 설정값이 다르니 아래 표 및 하단 예제를 참고해 주세요.

EVA-APP Application Values

Category Key Default Description
vision app.vision.ml - VM 서비스 엔드포인트 URL
agent app.agnet.llm - LLM 서비스 엔드포인트 URL
agent app.agent.vlm - VLM 서비스 엔드포인트 URL
agent app.agent.requestTimeoutSeconds 30 에이전트 요청 타임아웃 (초)
app app.backendHost - 백엔드 서버 호스트
app app.backendPort - 백엔드 서버 포트
app app.backendSecure - HTTPS 사용 여부
app app.browserTitleName EVA 브라우저 탭 제목
app app.infraProvider onprem 인프라 제공자 타입 (onprem / ncp / aws)
app app.jwtSecret Secret JWT 서명에 사용되는 비밀 키
lifeCycle app.lifeCycle.analysisRetentionDays None 알림 및 분석 데이터 보관 기간 (일)
license app.license.activation_mode online 라이선스 활성화 방식 (online 또는 offline)
license app.license.product_code eva 라이선스 제품 코드
license app.license.api_key ... 라이선스 API 키
license app.license.shared_key ... 라이선스 공유 키
pipeline app.pipeline.detector.workerNum 16 Detector 파이프라인 동시 처리 워커 수
pipeline app.pipeline.streamer.annotationColorMode GRAY 어노테이션 색상 모드
pipeline app.pipeline.streamer.dispatcherFaceAnonymizerEnabled True 디스패처에서 얼굴 비식별화 사용 여부
pipeline app.pipeline.ingester.ingesterStreamFPSForGrab 30.0 스트림 프레임 캡처 기준 FPS
pipeline app.pipeline.perceptor.queueSize 100 Perceptor 작업 큐 크기
pipeline app.pipeline.perceptor.workerNum 2 Perceptor 워커 개수
session app.accessTokenExpireMinutes 1440 액세스 토큰 만료 시간 (분)
session app.uiSessionTimeoutMinutes 60 UI 세션 만료 시간 (분, 0이면 제한 없음)