프론트엔드 / 백엔드 버전 불일치
설정 → 정보에서 백엔드 버전 행이 황색으로 표시되고, 프론트엔드와 백엔드 버전이 다르다는 안내가 나타납니다.
각 행의 의미
섹션 제목: “각 행의 의미”정보 패널은 세 가지 버전을 보여 줍니다.
- 릴리스 버전 — 박스에 설치된 릴리스이며, 설치 프로그램이 번들에서 기록합니다. “이 박스의 버전은 무엇인가”에 대한 답입니다.
- 프론트엔드 버전 — 지금 보고 있는 프론트엔드 번들에 컴파일된 버전입니다.
- 백엔드 버전 — 백엔드 이미지에 컴파일된 버전입니다.
릴리스는 변경되지 않은 서비스에 대해 이전 이미지를 그대로 재사용합니다. 따라서 올바르게 업데이트된 박스에서도 프론트엔드와 백엔드의 빌드 버전은 다를 수 있습니다. 황색 강조는 이 두 빌드 버전만 비교하므로, 그 자체로는 문제를 뜻하지 않습니다.
박스가 실행 중인 릴리스와 백엔드 빌드를 확인합니다.
curl -s http://localhost:5000/api/system/health | jq '{releaseVersion, version, commit}'releaseVersion이 설치한 번들과 같음 → 업데이트가 완료되었습니다. 황색 행은 변경 없이 유지된 서비스를 반영할 뿐입니다.releaseVersion이 설치한 번들보다 오래되었거나null임 → 업데이트가 끝나지 않았거나, 릴리스 보고 기능 이전의 릴리스로 설치된 박스입니다.
-
오래된 브라우저 탭인지 확인합니다. 프론트엔드 버전은 페이지를 불러올 때 고정됩니다. 브라우저를 강력 새로고침(캐시 무시)한 뒤 설정 → 정보을 다시 확인합니다.
-
릴리스 버전 행이 설치한 릴리스가 아니면 업데이트를 다시 실행합니다. 해당 릴리스의 번들 디렉터리에서 실행합니다.
Terminal window sudo ./update.sh업데이트는 번들의 이미지로 프론트엔드, 백엔드, 추론 서비스를 함께 올립니다.
-
확인합니다. 설정 → 정보을 다시 불러옵니다. 릴리스 버전 행에 설치한 릴리스가 표시되어야 합니다.
- 컨테이너 단위가 아니라 릴리스 번들로 업데이트합니다.
update.sh가 세 서비스를 릴리스에 맞춰 함께 유지합니다. - 업데이트할 때마다 릴리스 버전 행을 확인합니다. 이것이 업데이트 후 점검이며, 빌드 버전 행은 지원용입니다.