버전 및 업데이트
Xisom 박스에는 두 종류의 버전이 있습니다. 릴리스 버전은 설치한 릴리스 번들입니다. 빌드 버전은 각 구성 요소에 컴파일된 버전입니다. 업데이트 후 또는 무언가가 예기치 않게 동작할 때는 릴리스 버전을 먼저 확인하세요.
정보 패널
섹션 제목: “정보 패널”설정 → 정보를 엽니다. 다음 항목이 표시됩니다:
| 행 | 의미 |
|---|---|
| 릴리스 버전 | 이 박스에 설치된 릴리스 번들(예: v1.58.4). 박스의 버전입니다. |
| 프론트엔드 버전 | 브라우저에 로드된 대시보드의 빌드 버전. |
| 프론트엔드 커밋 | 그 대시보드 빌드의 소스 커밋. |
| 백엔드 버전 | 실행 중인 백엔드의 빌드 버전과 커밋. |
| 빌드 날짜 | 대시보드가 빌드된 시점. |
| 환경 | 대시보드의 빌드 모드. 출하된 박스에서는 production. |
사이드바와 로그인 화면에도 같은 릴리스 버전이 표시됩니다.
설치 프로그램은 박스를 설치하거나 업데이트할 때 릴리스 버전을 기록합니다. 이 버전은 이미지가 아니라 번들에서 읽습니다. 릴리스 보고 기능 이전에 설치된 박스라면 릴리스 버전 행에 빌드 버전이 대신 표시되고, 옆의 힌트가 이를 알려 줍니다. 다음 업데이트에서 채워집니다.
상태 엔드포인트에서 두 버전을 모두 읽을 수도 있습니다:
curl -s http://<box-ip>/api/system/health# → { "version": "...", "commit": "...", "buildTime": "...", "releaseVersion": "v1.58.4", ... }releaseVersion은 릴리스이고, version은 백엔드 빌드 버전입니다.
릴리스 버전과 빌드 버전
섹션 제목: “릴리스 버전과 빌드 버전”릴리스는 변경된 구성 요소만 다시 빌드합니다. 변경되지 않은 구성 요소는 그대로 새 릴리스에 포함되며, 마지막으로 변경된 릴리스의 빌드 버전을 유지합니다. 따라서 업데이트 후에는:
- 릴리스 버전은 설치한 릴리스를 표시합니다.
- 프론트엔드 버전과 백엔드 버전은 릴리스보다 오래된 버전일 수 있습니다.
- 두 버전이 서로 다를 수도 있습니다.
이는 업데이트가 실패했다는 뜻이 아닙니다. 박스가 무엇을 실행 중인지 알려 주는 것은 릴리스 버전입니다.
버전 불일치 경고
섹션 제목: “버전 불일치 경고”프론트엔드와 백엔드의 빌드 버전이 다르면 백엔드 버전 행이 강조 표시되고, 페이지를 새로고침하거나 재배포하라는 힌트가 나타납니다.
운영 관점에서:
- 오래된 브라우저 탭 — 대시보드를 강력 새로고침(hard-refresh)하거나 닫았다가 다시 엽니다.
- 새로고침 후에도 경고가 남음 — 릴리스 버전 행을 확인합니다. 설치한 릴리스가 표시되면 이 차이는 예상된 것입니다.
- 릴리스 버전 행이 설치한 릴리스가 아님 — 업데이트가 완료되지 않았습니다. 업데이트를 다시 실행합니다. 오프라인 번들 설치 → 업데이트를 참조하세요.
업데이트 후
섹션 제목: “업데이트 후”- 설정 → 정보를 다시 엽니다.
- 릴리스 버전 행이 설치한 버전인지 확인합니다.
- 불일치 경고가 표시되면 강력 새로고침을 합니다. 릴리스가 틀리면 업데이트를 다시 실행합니다.
문제가 발생하면
섹션 제목: “문제가 발생하면”- 새로고침 및 재업데이트 후에도 버전 불일치가 지속되는 경우 — 문제 해결 런북을 참조하세요.