2023년 “레거시 앱 마이그레이션” 게시물은 CasaOS 0.4.4 전환에 관한 내용이며, 현재 모든 환경에 적용되는 범용 마이그레이션 절차가 아닙니다. IceWhale은 0.4.4 사용자는 레거시 앱을 수동으로 다시 빌드하고, 이전 빌드 사용자는 먼저 0.4.4-1로 업데이트하라고 안내했습니다.
그 이후 CasaOS/ZimaOS 앱 패키징이 크게 변경되었으므로, 앱을 마이그레이션하려는 목적으로 과거의 업데이트 명령을 최신 시스템에 그대로 복사해 실행해서는 안 됩니다.
이전 마이그레이션 기능의 역할
이 UI는 이전 애플리케이션 정의와 새로운 Compose 기반 모델을 분리하고 Rebuild 및 Compose로 내보내기와 같은 작업을 제공했습니다. 목적은 애플리케이션 설정을 유지하면서 앱 정의를 변환하는 것이었습니다.
이전 0.4.4-1 업데이트 명령은 과거의 명령입니다
원본 게시물에는 CasaOS 0.4.3 이하 사용자를 위한 일회성 curl ... | sudo bash 업데이트 경로가 포함되어 있었습니다. 이는 2023년에 사용된 특정 버전용 연결 절차였으며, 언제든 안전하게 사용할 수 있는 명령이 아닙니다.
2024년 답변에서도 이미 문제가 드러났습니다. 이후 버전의 CasaOS를 사용하던 한 사용자는 동일한 버튼이 더 이상 표시되지 않는다고 했습니다.
최신 앱 스토어는 새로운 메타데이터 계약을 사용합니다
현재의 앱 스토어 v1에서 v2로의 마이그레이션 가이드에는 store.json, index.json, store-config.json 및 필수 앱 ID를 사용하는 새로운 스토어 프로토콜이 설명되어 있습니다.
이 페이지는 앱 스토어 유지 관리자를 위한 것이지만, 과거의 “레거시 앱” UI를 역사적인 마이그레이션 계층으로 간주해야 하는 이유를 보여 줍니다.
사용자 마이그레이션에서는 먼저 앱 데이터를 보호하세요
이전 앱 정의를 교체하기 전에 이미지, 포트, 환경 변수 및 호스트 볼륨 경로를 기록하세요. 영구 구성 및 데이터를 백업한 다음, 현재 스토어 패키지나 검토가 완료된 Compose 파일을 사용해 앱을 다시 만드세요.
Docker 앱 마이그레이션 기초에서는 실제로 유지해야 하는 컨테이너 구성 요소를 설명합니다.
결론
이전의 Rebuild 버튼은 CasaOS 0.4.4 시대의 호환성 도구였습니다. 해당 메뉴를 되살리기 위해 버전을 낮추거나 과거의 업데이트 스크립트를 실행하지 마세요. 앱 데이터를 보존하고 Compose 설정을 내보내거나 다시 구성한 다음, 현재 앱 모델로 마이그레이션하세요.
