EVA Deployer는 다양한 네트워크 및 인프라 환경에 맞춰 EVA를 설치하고 배포하기 위한 Ansible 기반 도구입니다. Ubuntu 24.04 환경에서 EVA App, Agent, Vision과 k3s, GPU/MIG, Harbor, NFS CSI, n8n 등의 구성 요소를 자동으로 설치·구성합니다.

EVA Deployer Github

https://github.com/SpectraBrain/eva-deployer

Repository 운영 방식

설치 환경에 따라 세 가지 모드를 지원합니다.

• cloud_repository: 대상 서버가 인터넷, ECR, S3에 직접 접근
• remote_repository: 대상 서버는 인터넷이 없지만 외부 Main Harbor에 접근 가능
• local_repository: 완전한 Airgap 환경으로, 파일과 이미지를 USB 등으로 전달한 뒤 서버 내부 Harbor 사용

remote_repository와 local_repository는 Harbor 주소와 프로젝트를 추가로 지정해야 합니다.

repository_registry=<Harbor 주소:포트>
repository_project=eva

버전 관리

EVA App, Agent, Vision, Helm Chart, n8n 이미지 버전은 모두 versions.json에서 통합 관리합니다. 이 파일을 수정하면 Ansible 배포와 오프라인 다운로드 스크립트에 자동 반영됩니다.

설치 준비 방식

• Cloud 환경은 대상 서버에서 Ansible과 AWS 인증을 설정한 뒤 직접 설치합니다.
• Remote 환경은 인터넷이 가능한 Main 서버에 Harbor를 설치하고 이미지를 push한 후, Main 서버에서 대상 서버로 Ansible을 실행합니다.
• Local Airgap 환경은 인터넷 서버에서 패키지, 모델, 이미지, Harbor installer를 준비하여 repository-images.tar와 프로젝트 전체를 Airgap 서버로 전달합니다. 이후 Airgap 서버에 Docker와 Local Harbor를 설치하고 이미지를 push합니다.

Airgap 설치를 위해 Docker, Ansible, apt 의존성 패키지를 미리 내려받으며, 준비 서버와 설치 서버는 같은 Ubuntu 릴리스와 아키텍처를 사용하는 것이 원칙입니다.

전체 설치 순서

1. inventory.ini 작성
2. 서버 사전 점검