본문으로 건너뛰기
버전: docs v24.09

Setup Edge App

Edge App을 서비스 환경에 설치하고 AI Solution의 모델을 배포하여, Inference를 통해 서비스를 제공합니다.

Edge App은 다양한 환경에 설치할 수 있지만, Try Mellerikat에서는 사용자의 Windows PC에 설치하여 서비스 운영을 체험할 수 있도록 제공합니다.

Edge App 다운로드

for Cloud Edge Conductor

Download Link: Edge App Installer

  • WSL Base Image: v3.0.0
  • Edge App : v3.3.0

for On-Premise Edge Conductor

Download Link: Edge App Installer

  • WSL Base Image: v3.0.0
  • Edge App : v3.3.0


Edge App 설치를 위한 WSL 활성화

Windows OS에서 Edge App을 설치하기 위해 WSL이 준비되어야 합니다.

WSL 환경 설정

WSL이 안정적으로 동작하기위해 Windows 설정에서 다음의 사항을 변경합니다.

  • WSL 활성화

    1. Windows 설정에서 "Windows 기능 켜기/끄기"를 검색하여 실행합니다.
    2. Hyper-V, Windows Subsystem for Linux, Windows Hypervisor Platform를 활성화하고 확인 버튼을 클릭합니다.
    3. PC 재부팅 합니다.
  • vmcompute 흐름 제어 보호 비활성화

    1. Windows설정에서 "Windows 보안"을 검색하여 실행합니다.
    2. 앱 및 브라우저 컨트롤을 클릭합니다.
    3. Exploit Protection 설정을 클릭합니다.
    4. 프로그램 설정을 클릭하고 + 버튼을 클릭하여 프로그램을 추가해 사용자 지정으로 정확한 파일 경로 선택을 클릭합니다.
    5. C:\Windows\System32\vmcompute.exe를 선택합니다.
    6. 리스트에서 흐름 제어 보호 (CFG)를 찾아 비활성화하고 적용을 클릭합니다.
    7. PC 재부팅 합니다.

WSL 설치 및 동작 확인

WSL (Linux용 Windows 하위 시스템)은 Windows에서 Linux 기능에 엑세스 할 수 있는 환경을 제공합니다.

WSL은 Windows 10 버전 2004 이상(빌드 19041 이상) 또는 Windows 11 부터 지원합니다.

Power Shell을 관리자 권한으로 실행하고 다음의 명령어가 동작하는지 확인합니다.

wsl --install

명령어가 동작하지 않으면 다음의 링크를 참고하여 WSL을 설치하세요. https://learn.microsoft.com/ko-kr/windows/wsl/install

status 명령어를 입력하여 WSL Kernerl이 설치되어 버전이 표시 되는지 확인합니다.

wsl --status
----------------------------------------------------------
Default Version: 2

Kernel Version: 5.10.102.1

WSL Default Version이 1인 경우 다음 링크에서 update 파일을 다운 받아서 설치합니다. https://wslstorestorage.blob.core.windows.net/wslblob/wsl_update_x64.msi

Edge App 설치

다운로드한 파일을 압축 해제하고 관리자 권한으로 edgeapp_installer.exe를 실행합니다.

실행 후 "다음"을 클릭하고 다음과 같은 적절한 정보를 입력합니다:

  • Edge Conductor 설정

    1. Edge Conductor IP : 사용하려는 Edge Conductor의 IP 주소를 입력합니다.
    2. Edge Conductor PORT : 사용하려는 Edge Conductor의 포트를 입력합니다.
    3. Http, Https settings : Edge Conductor와의 통신에 사용할 프로토콜을 선택합니다.
  • Edge App Configuration

    1. DataInputPath : 추론할 데이터가 생성되는 경로를 입력합니다. (DOS 경로, 예: C:\TEST)
    2. DataOutputPath : 추론 결과 압축 파일이 저장될 경로를 입력합니다. (None을 입력하면 로컬에 저장되지 않습니다.)

정보를 입력한 후 "다음"을 클릭하고 다음과 같은 적절한 정보를 입력합니다:

  • AWS Configuration
    1. aws access key : 사용하려는 AWS access key를 입력합니다.
    2. aws secret key : 사용하려는 AWS secret key를 입력합니다.
    3. aws region : 사용하려는 AWS의 리전을 입력합니다.

정보를 입력한 후 "다음"을 클릭하여 설치를 진행합니다. "끝"을 클릭하여 edgeapp_installer.exe를 닫고, 설치 후 나타나는 PowerShell 창이 닫힐 때까지 기다립니다. 창이 닫힌 후 바탕화면에 Edge Start, Edge Stop, Viewer에 대한 바로 가기가 생성되었는지 확인합니다.



Edge App 실행

바탕화면에서 Edge Start를 클릭하여 EdgeApp을 실행할 수 있습니다.
추론 결과를 확인하려면 바탕화면에서 Viewer를 실행하거나 Tiny Viewer를 실행하여 확인합니다.
사용을 중지하려면 바탕화면에서 Edge Stop을 실행하여 애플리케이션을 종료하십시오.



Edge Conductor에 Edge App 등록

Edge App이 정상적으로 실행 되면 Edge Conductor에 등록할 수 있습니다.

Edge Conductor의 Edges페이지에서 + New Edge 버튼을 클릭하여 새로운 Edge App 등록 메뉴로 이동합니다.

새롭게 추가된 Edge App을 체크하고 상세 정보를 입력하여 등록합니다.

Edge App Register

Edge App 등록에 대한 자세한 설명은 Manage Edges Manual을 참고하시기 바랍니다.