Hypermass CLI는 스트림에서 발행되는 라이브 데이터를 사용자의 로컬 컴퓨터 폴더로 실시간으로 전달합니다.
1. 설치하기
설치 지침을 참고하세요 (걱정 마세요, 완료하면 여기로 다시 연결됩니다).
만약 단순히 사용해 보려고 설치하지 않았다면, 아래 명령어에서 hypermass 대신 ./hypermass (또는 Windows의 경우 hypermass.exe)를 입력하는 것을 기억하세요.
솔라 이미지 라이브 스트림으로 사용해 보세요:
실행하면 sync가 어떤 작업을 하는지에 대한 메시지들이 나타날 것입니다 (언제든지 ctrl-C로 중단할 수 있습니다).
파일들은 발행되는 대로 <home folder>/hypermass/subscriptions/_254gGE43g에 도착하며, 페이로드(payload)당 하나의 파일이 생성됩니다. 위 예시에서는 SOHO 망원경(참고: EIT 284a 장비)이 포착한 태양의 가장 최근 이미지가 해당 폴더에서 보일 것입니다.
만약 hypermass sync를 하루 동안 실행해 두면, 다음 날 이미지들이 발행되는 대로 같은 폴더에 도착할 것입니다 (보통 GMT 기준 약 4:15).
3. 데이터 사용하기
이제 파일들이 로컬 폴더로 도착했으므로, 처리하고 완료되면 삭제할 수 있습니다. hypermass sync 프로세스는 해당 파일을 다시 수정하지 않으며, 처리가 완료된 후 이 파일들을 삭제하는 것은 어떤 파일들을 다루었는지 추적하는 좋은 방법입니다 (필요하다면 항상 스트림 메시지를 재실행할 수 있으니 걱정하지 마세요).
hypermass cli는 어떤 파일들이 가져와졌는지 기록하며, 파일들은 항상 발행된 순서대로 도착합니다. 각 파일은 페이로드 ID로 이름이 지정되며, 파일들을 이름으로 정렬하면 동일한 발행 순서를 유지하게 됩니다. 또한, hypermass는 페이로드가 발행된 시간으로 파일의 최종 수정 시간을 업데이트하지만, 파일을 열면 이 시간이 변경될 수 있어 신뢰도가 떨어질 수 있습니다. 신뢰할 수 있는 타임스탬프가 필요하다면, folder-with-metadata 구성을 사용하는 것을 고려해 보세요.
.hypermass 폴더: 각 스트림의 폴더에는 숨겨진 .hypermass 폴더가 들어있습니다.
폴더입니다. 이 폴더가 어떤 스트림에 속하는지, 그리고 마지막으로 수신된 페이로드(payload) — 즉 해당 스트림에서의 위치를 기록합니다. 데이터 파일만 삭제하고 .hypermass 폴더는 그대로 두세요: 이 폴더가 없으면 CLI는 더 이상 이 폴더를 스트림의 일부로 인식하지 못하며, 스트림 내에서 사용자의 위치 정보가 손실됩니다.
다음 단계 (Next steps)
다른 기능 확인하기: hypermass status 명령어로 모든 스트림의 진행 상황을 확인하고,
모든 지점부터 스트림을 재실행(replay)하거나, hypermass reload로 실행 중인 스트림을 즉시 변경할 수 있습니다.
- CLI 사용하기
자체 코드에 데이터 활용하기: 클라이언트 빌드
서버에서 실행하기: hypermass sync를 서비스로 설치하여 재부팅에도 계속 실행되도록 합니다. - 다운로드 및 설치
자체 데이터 발행하기: 자신만의 스트림을 발행합니다.
CLI는 누구를 위한 것인가?
Hypermass CLI가 Hypermass에서 데스크톱과 서버로 데이터를 자동으로 동기화하는 '일반적인' 방법이 될 것이라고 예상합니다. 만약 당신이 데이터 과학자, 개발자 또는 연구원이라면, 단 하나의 명령어로 필요한 데이터를 가져오고 발행할 수 있는 편리하고 반복 가능한 수단입니다.
프로그램 및 프로덕션 환경에서는 hypermass 데이터 스트림을 애플리케이션에 통합하는 깔끔하고 간단한 방법을 제공합니다.
이 접근 방식이 좋은 이유?
명령줄 도구(command line tool)는 자동화와 사용자 조작 모두를 가능하게 합니다. 다양한 플랫폼과 언어에서 작동합니다. CLI 제작 과정에 관심이 있다면, 상세 아티클인 'CLI Design Rationale'를 참고해 주세요.
"sync" 명령어
hypermass sync는 Hypermass 스트림의 데이터를 로컬 폴더로 가져와 원하는 방식으로 처리할 수 있게 하고, 설정 파일(config)에 publication-sources 아래 나열된 폴더에 작성하는 모든 파일을 업로드합니다.
sync가 실행되는 동안, 다른 터미널에서 hypermass status 명령어를 사용하여 현재 상태, 파일 큐(file queues) 및 기타 유용한 정보를 확인할 수 있습니다.
