コンテンツにスキップ
JelinaJelina Documentation技術ドキュメント
公式サイトに戻る

ストレージとデータパーティション

JelinaOS のストレージ設計は、システムの安全性とデータの制御を重視します。システムは読み取り専用で動作し、ユーザーデータは独立したデータパーティションに集約します。

┌──────────────────────────────────┐
│ システム領域(読み取り専用) │ システム本体、実行中は書き込み不可
├──────────────────────────────────┤
│ アプリ領域(/app、読み取り専用層 + 書き込み層) │ アプリとコンポーネント、システムから独立
├──────────────────────────────────┤
│ データ領域(/mnt/overlay/rw) │ 全ユーザーデータと書き込み
│ ├─ システム書き込み層(root upper) │
│ ├─ アプリ書き込み層(app upper) │
│ ├─ 設定ファイル/実行ログ │
│ └─ ユーザーファイル │
└──────────────────────────────────┘
  • システムパーティションは読み取り専用で、改変できません。
  • アプリケーション領域 /app は独立してマウントされ、アプリケーションやコンポーネントの更新はシステムパーティションを消費しません。
  • すべてのユーザー書き込みをデータパーティションに保存し、アプリケーションやシステムから分離します。
データの種類 保存先 説明
アプリケーションデータ データパーティション内のアプリケーションディレクトリ コンテナボリューム、プログラムの実行データ
設定ファイル データパーティション内の設定ディレクトリ 永続設定。更新後も保持
ログ システムログ + データパーティション 必要に応じて保持ポリシーを設定
一時データ メモリー/一時ディレクトリ 再起動時に消去し、永続ストレージを消費しない
Terminal window
df -h

デバイスで使用可能なストレージの主要部分である、データパーティションの空き容量に注目してください。

容量不足と一時ルートによる復旧

Section titled “容量不足と一時ルートによる復旧”

内蔵のディスク容量監視でルートパーティションを保護します。容量が不足すると、一時ルート(temporary root)復旧モードに移行できます。

  • メモリーを書き込み可能レイヤーとして一時ルートで起動し、データパーティションの内容に影響を与えず、使用済み容量を解放します。
  • 一時ルートは復旧用モードです。このモードでの書き込みはすべて再起動後に失われます。システムへ入り、容量を確保するためだけに使用します。
  • 使用率がしきい値に達すると動作します。デフォルトは 90% で、警告のみ、再起動の通知、強制再起動を設定できます。
  • デバイスコマンドで一時ルート状態を確認します。
Terminal window
jelina-enter-tmpfs-root --status # 一時ルート状態を確認
jelina-info --get tmp_root --json # 一時ルートの詳細
  • 一時ルートでデータパーティションの空きを確保し、再起動すると通常モードに戻ります。

容量不足時は、まずアプリケーションログ、コンテナイメージ、一時ファイルを整理してください。システム状態や更新マーカーを削除しないでください。一時ルートでは業務操作や設定変更を行わないでください。

  • 定期的な整理:古いログは大きな容量を使うため、ログ使用量を制限できます。
    Terminal window
    journalctl --vacuum-size=200M # ログ使用容量を制限
  • 監視と通知:JelinaCloud ではストレージ使用率のしきい値(デフォルト 80%)を設定し、超過時に自動通知できます。
  • 空き容量の確保:更新には一時領域が必要です。データパーティションの 20% 以上を空けておくことを推奨します。

データパーティションはユーザーデータの唯一の永続保存先です。定期バックアップを推奨します。

  • 重要データを外部ストレージやクラウドへ保存します。
  • 更新や保守などの重要操作前に、主要ディレクトリをバックアップします。
  • 単一障害点を避けるため、バックアップは外部ディスクやネットワークストレージなど、データパーティションの外へ保存します。

工場出荷状態への復元とデータ

Section titled “工場出荷状態への復元とデータ”
  • 工場出荷状態への復元では、システムとユーザーの書き込み内容を初期状態に戻します。
  • 重要データを事前にバックアップしてから復元してください。