저장 공간 및 데이터 파티션

JelinaOS의 저장 공간 설계는 “시스템 보안과 데이터 통제”를 원칙으로 합니다. 시스템 파티션은 읽기 전용으로 실행되며, 모든 사용자 데이터는 별도의 데이터 파티션에 통합 저장됩니다.

저장 공간 구성

┌──────────────────────────────────┐
│ 시스템 파티션(읽기 전용)              │ 시스템 본체, 실행 중 쓰기 불가
├──────────────────────────────────┤
│ 애플리케이션 영역(/app, 읽기 전용 + 쓰기 가능 계층) │ 시스템과 독립적인 앱 및 구성 요소 콘텐츠
├──────────────────────────────────┤
│ 데이터 파티션(/mnt/overlay/rw)         │ 모든 사용자 데이터와 쓰기
│   ├─ 시스템 쓰기 가능 계층(root upper) │
│   ├─ 앱 영역 쓰기 가능 계층(app upper) │
│   ├─ 설정 파일/실행 로그              │
│   └─ 사용자 파일                     │
└──────────────────────────────────┘

• 시스템 파티션은 읽기 전용으로 실행되며 변조할 수 없습니다.
• 애플리케이션 영역(/app)은 별도로 마운트되므로 애플리케이션 및 구성 요소 업데이트가 시스템 파티션의 공간을 차지하지 않습니다.
• 데이터 파티션은 모든 사용자 쓰기 작업을 수용하며 애플리케이션 및 시스템과 격리됩니다.

데이터 저장 위치

데이터 유형	저장 위치	설명
애플리케이션 데이터	데이터 파티션의 애플리케이션 디렉터리	컨테이너 볼륨, 프로그램 실행 데이터
설정 파일	데이터 파티션의 설정 디렉터리	업데이트 후에도 유지되는 영구 설정
로그	시스템 로그 + 데이터 파티션	필요에 따라 보존 정책 설정 가능
임시 데이터	시스템 메모리/임시 디렉터리	다시 시작 시 삭제되며 영구 저장 공간을 차지하지 않음

저장 공간 확인

df -h

장치에서 사용할 수 있는 저장 공간의 대부분을 차지하는 데이터 파티션의 여유 공간을 중점적으로 확인하세요.

공간 부족 및 임시 루트 복구

시스템에 내장된 디스크 공간 모니터링 기능이 루트 파티션의 공간을 지속적으로 보호합니다. 공간이 거의 소진되면 장치는 임시 루트(temporary root) 복구 모드로 진입할 수 있습니다.

• 시스템은 임시 루트로 부팅하며(메모리를 쓰기 가능한 계층으로 사용), 데이터 파티션의 내용에 영향을 주지 않고 사용 중인 공간을 확보합니다.
• 임시 루트는 복구 모드입니다. 이 모드에서 기록한 모든 내용은 다시 시작 후 사라지며, 공간 정리를 위해 시스템에 진입하는 용도로만 사용합니다.
• 공간 사용률이 임계값에 도달하면 트리거됩니다(기본값 90%, 알람만 발생, 다시 시작 안내 또는 강제 다시 시작으로 설정 가능).
• 장치 명령으로 임시 루트 상태를 확인합니다.

jelina-enter-tmpfs-root --status   # 임시 루트 상태 확인
jelina-info --get tmp_root --json  # 임시 루트 세부 정보

• 임시 루트 모드에서 데이터 파티션 공간을 정리한 후 다시 시작하면 정상 모드로 복귀합니다.

공간이 소진되면 애플리케이션 로그, 컨테이너 이미지 및 임시 파일을 우선 정리하고 시스템 상태와 업데이트 마커는 삭제하지 마세요. 임시 루트 모드에서는 업무 작업이나 설정 변경을 수행하지 마세요.

공간 관리 권장 사항

• 정기 정리: 오래된 로그는 많은 공간을 차지하므로 로그 사용량을 제한할 수 있습니다.

  journalctl --vacuum-size=200M   # 로그 저장 공간 사용량 제한

• 모니터링 알람: JelinaCloud에 연결한 후 저장 공간 사용률의 알람 임계값을 설정할 수 있으며(기본값 80%), 초과 시 자동으로 알립니다.
• 여유 공간 확보: 시스템 업데이트에는 임시 공간이 필요하므로 데이터 파티션의 여유 공간을 20% 이상 유지하는 것이 좋습니다.

데이터 백업

데이터 파티션은 사용자 데이터가 영구적으로 저장되는 유일한 위치이므로 정기적으로 백업하는 것이 좋습니다.

• 중요 데이터를 외부 저장 장치 또는 클라우드에 백업합니다.
• 업데이트나 유지보수 등 주요 작업 전에 데이터 파티션의 중요 디렉터리를 백업합니다.
• 단일 장애 지점의 위험을 방지하려면 백업 데이터를 데이터 파티션 외부(외장 디스크/네트워크 저장 장치)에 보관하는 것이 좋습니다.

공장 초기화와 데이터

• 공장 초기화를 수행하면 시스템과 사용자가 기록한 내용이 출하 상태로 복원됩니다.
• 중요한 데이터는 미리 백업한 후 복구 작업을 수행하세요.

관련 문서

• 시스템 아키텍처 — 파티션 구성 및 데이터 격리 원리
• Recovery 및 공장 초기화 — 복구 작업 상세 설명