Jelinvisor 장치 에이전트

Jelinvisor는 모든 JelinaOS 장치에서 실행되는 관리 구성 요소이며 장치와 JelinaCloud 사이의 연결 고리입니다. “등록 즉시 클라우드 연결, 업데이트 중 연결 유지, 원격 운영”을 실제로 수행하는 주체가 Jelinvisor입니다.

주요 역할

역할	설명
장치 연결	첫 부팅 후 클라우드에 자동 등록하고 온라인 상태 유지
상태 보고	시스템 버전, 네트워크 주소, 리소스 사용량, 동작 온도와 애플리케이션 상태 등을 지속 보고
업데이트 실행	클라우드의 시스템·커널·애플리케이션·증분 업데이트를 수신·실행하고 확인과 복귀 처리
애플리케이션 관리	컨테이너와 비컨테이너 애플리케이션(ProgramSet)의 시작·중지·재시작·업그레이드 전체 수명 주기 관리
로컬 인터페이스	현장에서 상태 조회, 서비스 조작과 장치 제어를 위한 로컬 관리 인터페이스 제공
원격 채널	클라우드에서 장치에 직접 연결할 수 없으면 보안 채널로 관리 요청을 중계하여 원격 접근 보장

네 가지 실행 모드

Jelinvisor는 다양한 네트워크·관리 조건에 맞춰 배포 환경별 실행 모드를 제공합니다.

모드	적합한 시나리오	동작
클라우드 관리 모드	JelinaCloud에 연결하는 표준 환경	등록, 보고와 클라우드 명령 수신 모두 수행
로컬 관리 모드	클라우드가 없는 내부망/격리 환경	로컬 인터페이스로 애플리케이션 배포·관리
오프라인 모드	일시적으로 네트워크가 끊긴 현장	클라우드 구성을 보존하고 네트워크 작업을 중단하며 복구 후 자동 재연결
독립 모드	클라우드를 전혀 사용하지 않는 배포	클라우드 구성 요소에 의존하지 않고 장치가 로컬에서 자체 관리

어떤 모드에서도 애플리케이션 실행, 시스템 관리와 워치독 등 모든 로컬 기능을 사용할 수 있습니다.

클라우드와의 협력 방식

┌────────────────┐        ① 등록/상태 보고          ┌────────────────┐
│  엣지 장치     │ ──────────────────────────────▶ │                │
│ ┌────────────┐ │                                  │  JelinaCloud   │
│ │ Jelinvisor │ │ ◀────────────────────────────── │ 클라우드 플랫폼│
│ └────────────┘ │    ② 업데이트/설정/명령 전송     │                │
│  JelinaOS      │                                  │                │
└────────────────┘       ③ 원격 운영 보안 채널      └────────────────┘

상향: 장치 상태, 로그와 알람을 지속 보고하여 클라우드에서 실시간 확인합니다.
하향: 시스템 업데이트, 애플리케이션 Release와 실행 정책을 통합 구성하여 전달합니다.
양방향: 원격 SSH, 원격 데스크톱과 서비스 작업이 보안 채널을 통해 장치에 직접 도달합니다.

현장 보안을 위한 설계

로컬 업데이트 확인: 중요한 업데이트는 “장치 도착 후 현장 확인 대기”로 설정할 수 있습니다. 확인 후에만 설치되므로 현장 담당자가 최종 결정권을 갖습니다.
접근 권한 검증: 장치 로컬 인터페이스는 키 기반 권한 검증을 사용하여 미승인 요청을 거부하며, 필요에 따라 키를 다시 생성할 수 있습니다.
운영 모드: 클라우드 접근만 허용하고 로컬 네트워크에서도 직접 연결을 막아 공격 표면을 최소화합니다.
연결 자동 복구: 네트워크가 복구되면 수동 개입 없이 자동으로 다시 연결합니다.

로컬 인터페이스

장치 에이전트는 현장 운영과 스크립트 연동에 사용할 로컬 관리 인터페이스를 제공합니다.

로컬 주소: localhost:48484. 포트는 구성으로 조정할 수 있습니다.
주요 인터페이스: 프로세스 준비 상태 검사, 버전 조회, 업데이트 상태 조회, 대상 상태 사전 검사와 업데이트 확인 등.
일상 작업에는 구성과 민감한 정보를 자동 처리하는 장치 명령(jelina-local-ota)을 우선 사용하세요. 인터페이스를 직접 호출해야 한다면 로컬 루프백 주소를 사용하세요.

상태 검사

jelina-info --get jelinvisor --json        # 장치 에이전트 상태 및 버전
systemctl status jelina-jelinvisor          # 서비스 상태
journalctl -u jelina-jelinvisor -n 100      # 에이전트 로그

에이전트와 시스템 모두 업데이트

Jelinvisor 자체도 온라인 업데이트를 지원하며, 시스템·커널·애플리케이션 업데이트와 함께 클라우드에서 통합 조율합니다. 장치 에이전트를 최신 버전으로 유지하는 것은 보안과 기능 발전의 기본입니다.

기술 기반

Jelinvisor는 업계에서 검증된 장치 관리 아키텍처와 대규모 장치 클러스터 관리의 오랜 실무 경험을 결합하여, 대규모 산업 배포에 검증된 신뢰성 기반을 제공합니다.