커뮤니티 솔루션

Compose로 ZimaOS에 사용자 지정 Docker 앱 설치

A user wanted to install KiCad on ZimaOS and was unsure whether a third-party App Store repository was required.

현재 답변: 직접 Docker Compose를 가져오세요—타사 스토어를 반드시 추가해야 한다고 가정하지 마세요

해당 스레드에서는 LinuxServer 저장소를 추가하고 KiCad를 검색하라고 제안했습니다. 호환되는 카탈로그에 이미 앱이 패키징되어 있다면 이 방법이 작동할 수 있지만, 최신 ZimaOS 문서에서는 직접 Docker Compose를 가져오는 방법도 지원합니다. 일회성 앱이라면 타사 저장소 전체를 종속 항목으로 만드는 것보다 이 방법이 더 명확한 경우가 많습니다.

먼저 신뢰할 수 있는 업스트림 컨테이너 정의를 찾으세요

KiCad의 경우 LinuxServer에서 영구 /config, 웹 데스크톱 및 문서화된 아키텍처를 지원하는 컨테이너를 관리하고 있습니다. 임의의 Compose 파일을 복사하기 전에 LinuxServer KiCad 문서를 읽어 보세요.

ZimaOS 앱 패키징은 표준 Compose와 x-casaos 메타데이터를 함께 사용합니다

최신 Docker Compose 및 x-casaos 참조 문서에서는 일반적인 Docker 런타임 설정과 ZimaOS 스토어 메타데이터를 구분합니다. 업스트림 Docker Compose 참조 문서는 서비스, 볼륨, 포트 및 환경 변수에 관한 기준 문서입니다.

영구 앱 데이터는 컨테이너 외부에 보관하세요

KiCad 설정과 프로젝트를 영구 스토리지에 매핑하고, 설치 전에 호스트 경로를 확인하세요. ZimaOS 앱 경로 안내서에서는 컨테이너를 삭제해도 올바르게 매핑된 사용자 데이터가 삭제되지 않아야 하는 이유를 설명합니다.

반복 가능한 카탈로그 설치가 필요할 때만 스토어를 사용하세요

여러 사용자 지정 앱을 관리할 계획이라면 호환되는 스토어를 구축하거나 추가하는 것이 좋습니다. ZimaOS v2 저장소 모델은 Apps/<AppName>/docker-compose.yml과 생성된 메타데이터를 함께 사용합니다. 앱 하나만 설치한다면 Compose가 더 단순한 추상화입니다.

Portainer 하드웨어 안내서ZimaOS 앱 스토어 하드웨어 디렉터리는 사용자 지정 앱 스택이 확장될 때 유용합니다.

데스크톱 앱을 설치하기 위해 ZimaOS 기본 시스템을 수정하지 마세요

KiCad는 ZimaOS 호스트에 apt install로 설치하는 것이 아니라 컨테이너나 VM에서 실행해야 합니다. ZimaOS 패키지 관리자 안내서에서 이러한 경계를 설명합니다.