Ir al contenido
JelinaJelina DocumentationDocumentación técnica
Volver al sitio oficial

Almacenamiento y partición de datos

El almacenamiento de JelinaOS se basa en la seguridad del sistema y el control de los datos: la partición del sistema funciona en modo de solo lectura y todos los datos de usuario se almacenan en una partición independiente.

┌───────────────────────────────────────────────────────────┐
│ Partición del sistema: solo lectura │ Sistema; no escribible durante la ejecución
├───────────────────────────────────────────────────────────┤
│ Aplicaciones (/app, capas de solo lectura y escribibles) │ Aplicaciones y componentes separados del sistema
├───────────────────────────────────────────────────────────┤
│ Partición de datos (/mnt/overlay/rw) │ Todos los datos y escrituras del usuario
│ ├─ Capa escribible del sistema (root upper) │
│ ├─ Capa escribible de aplicaciones (app upper) │
│ ├─ Archivos de configuración / registros de ejecución │
│ └─ Archivos del usuario │
└───────────────────────────────────────────────────────────┘
  • La partición del sistema funciona en modo de solo lectura y no puede alterarse;
  • El área de aplicaciones, /app, se monta de forma independiente; las actualizaciones de aplicaciones y componentes no ocupan la partición del sistema;
  • La partición de datos recibe todas las escrituras del usuario y está aislada de las aplicaciones y del sistema.
Tipo de datos Ubicación Descripción
Datos de aplicaciones Directorio de la aplicación en la partición de datos Volúmenes de contenedores y datos de ejecución
Archivos de configuración Directorio de configuración en la partición de datos Configuración persistente que se conserva tras actualizar
Registros Registros del sistema y partición de datos Retención configurable según las necesidades
Datos temporales Memoria o directorios temporales del sistema Se eliminan al reiniciar y no ocupan almacenamiento persistente
Terminal window
df -h

Presta especial atención al espacio libre de la partición de datos, que constituye la mayor parte del almacenamiento disponible.

Agotamiento del espacio y recuperación con raíz temporal

Sección titulada «Agotamiento del espacio y recuperación con raíz temporal»

La supervisión de espacio integrada protege continuamente la partición raíz. Cuando el espacio está próximo a agotarse, el dispositivo puede entrar en modo de recuperación con raíz temporal (temporary root):

  • El sistema arranca con una raíz temporal que utiliza la memoria como capa de escritura, permitiendo liberar el espacio ocupado sin afectar al contenido de la partición de datos;
  • La raíz temporal es un modo de recuperación: todas sus escrituras se pierden al reiniciar y solo debe utilizarse para acceder al sistema y limpiar espacio;
  • Se activa al alcanzar el umbral de uso, 90 % de forma predeterminada, y permite configurar solo alerta, solicitud de reinicio o reinicio forzado;
  • Consulta su estado con los comandos del dispositivo:
Terminal window
jelina-enter-tmpfs-root --status # Consultar el estado de raíz temporal
jelina-info --get tmp_root --json # Detalles de raíz temporal
  • Después de limpiar espacio en la partición de datos desde este modo, reinicia para volver al funcionamiento normal.

Si se agota el espacio, limpia primero registros de aplicaciones, imágenes de contenedor y archivos temporales. Evita borrar el estado del sistema o los indicadores de actualización. No realices operaciones de negocio ni cambios de configuración desde la raíz temporal.

Recomendaciones de administración del espacio

Sección titulada «Recomendaciones de administración del espacio»
  • Limpieza periódica: los registros antiguos pueden consumir mucho espacio; limita su tamaño:
    Terminal window
    journalctl --vacuum-size=200M # Limitar el espacio ocupado por los registros
  • Supervisión y alertas: en JelinaCloud puedes configurar un umbral de almacenamiento, 80 % de forma predeterminada, para recibir notificaciones automáticas;
  • Reserva de espacio: las actualizaciones necesitan espacio temporal; conserva preferiblemente más del 20 % libre en la partición de datos.

La partición de datos es la única ubicación persistente de los datos de usuario. Realiza copias periódicas:

  • Copia los datos críticos a almacenamiento externo o a la nube;
  • Antes de actualizar o realizar tareas importantes de mantenimiento, copia los directorios críticos;
  • Guarda las copias fuera de la partición de datos, en un disco externo o almacenamiento de red, para evitar un único punto de fallo.
  • El restablecimiento de fábrica devuelve el sistema y las escrituras del usuario al estado de fábrica;
  • Copia los datos importantes antes de realizarlo.