EVA 는 EVA Deployer를 통해 설치합니다. Deployer는 대상 서버의 사전 점검부터 k3s·GPU 인프라 구성, EVA App·Vision·Agent 배포까지를 Ansible playbook으로 일관되게 처리합니다.

설치를 시작하기 전에 대상 서버의 자원, GPU, 네트워크와 이미지 저장소 접근 조건을 확인해야 합니다. 이 기준을 먼저 맞추면 배포 뒤 발생할 수 있는 서비스 연결, 성능, 권한 문제를 줄일 수 있습니다.

설치 순서

설치 전 준비

권장 서버 사양, GPU와 네트워크 조건, 제어 서버 또는 대상 서버의 접근 권한을 확인합니다.

EVA 설치 가이드

설치 흐름과 EVA App·Vision·Agent의 역할, 설치 후 확인할 항목을 확인합니다.

EVA Deployer

Repository 기반 배포 모드

EVA는 고객마다 네트워크와 보안 환경이 달라 하나의 설치 패키지를 모든 고객에게 동일한 방식으로 전달하기 어렵습니다. 특히 제조·공공·금융처럼 보안 수준이 높은 환경에서는 외부 인터넷이나 Cloud Repository 접근이 제한되거나 완전히 차단될 수 있습니다.

EVA Deployer는 이러한 차이를 별도 제품 개발이나 고객별 Helm Chart 수정으로 해결하지 않습니다. 대신 배포 시 사용할 Image Repository의 공급 경로만 변경하여, 동일한 EVA Release를 서로 다른 네트워크 환경에 일관되게 배포하도록 설계되었습니다.

고객 환경에 따라 cloud_repository, Main Harbor를 사용하는 remote_repository, 대상 환경의 Local Harbor를 사용하는 local_repository를 선택합니다. Repository 모드와 설치 자산을 준비한 뒤, 인프라 설치와 EVA 솔루션 배포를 순서대로 진행합니다.

Deployer 배포 흐름

  1. 대상 환경에 맞는 repository_mode를 선택하고 필요한 이미지·모델·설치 자산을 준비합니다.
  2. Inventory를 작성하고 site_precondition.yaml으로 네트워크, 디스크, GPU MIG 조건을 점검합니다.
  3. site_infra.yaml으로 k3s, NFS CSI, NVIDIA runtime/device plugin을 구성하고 필요한 경우 MIG를 설정합니다.
  4. site_eva_config.yaml으로 환경별 설정을 생성합니다. Remote/Local Repository에서는 site_eva.yaml으로 EVA App·Vision·Agent·Qdrant·vLLM을 배포하고, Cloud Repository에서는 TLS·EVA IAM·App·ECR/AWS Secret을 준비한 뒤 Vision·Agent를 배포합니다.
  5. Pod, Service, EVA App 접속과 서비스 간 연동 상태를 확인합니다.

환경별 명령, Harbor 준비, 라이선스 설정과 검증 방법은 EVA Deployer 하위의 인프라 설치, 솔루션 설치 페이지를 따릅니다.