Volúmenes
Un volumen es un disco persistente del laboratorio. Vive aparte de los notebooks: lo que guardas en él sigue ahí cuando detienes, reinicias o eliminas el notebook que lo usaba. Todo lo demás (el disco del contenedor, la memoria) se pierde en cada reinicio.
Los volúmenes se administran en Volumes, en el menú del panel del laboratorio.
Antes de empezar
- Acceso al laboratorio como propietario o colaborador (Compartir).
- Disco libre en el presupuesto del laboratorio: cada volumen descuenta su tamaño completo desde que se crea, lo llenes o no (Tallas y cuota).
Los dos tipos de volumen
Un notebook monta volúmenes de dos maneras. El disco es el mismo; cambia para qué se usa y dónde aparece.
| Workspace Volume | Data Volume | |
|---|---|---|
| Para qué | Tu carpeta personal: notebooks, código, entornos virtuales. | Datos del proyecto: datasets, modelos entrenados, resultados. |
| Cuántos por notebook | Uno. | Los que necesites. |
| Dónde aparece | /home/jovyan | La ruta que elijas al montarlo. |
| Cómo se crea | Solo, al crear el notebook (<nombre>-workspace). | Con New Volume, o con Add new volume en el formulario del notebook. |
| Uso típico | Un notebook, una persona. | Varios notebooks leen y escriben los mismos datos. |
Separa los datos del código: un dataset en un Data Volume se monta en el notebook de cada integrante sin copiarlo, y sobrevive aunque alguien elimine su notebook con todo y Workspace Volume.
La lista de volúmenes
Cada fila de Volumes es un volumen:
| Columna | Qué dice |
|---|---|
| Status | Verde cuando el disco está listo para montarse. |
| Name | Nombre del volumen. Abre su detalle. |
| Created at | Cuándo se creó. |
| Size | Tamaño reservado, en Gi. |
| Access Mode | Cuántos notebooks pueden montarlo a la vez (ver Modos de acceso). |
| Storage Class | Tipo de almacenamiento de la instalación donde vive el disco. |
| Used by | Notebook que lo tiene montado, aunque esté detenido. |
Al final de la fila hay tres acciones: la carpeta abre el explorador de archivos (Subir y descargar archivos), la X lo cierra y el bote elimina el volumen. Filter busca por cualquier columna, por ejemplo el nombre de un notebook para ver sus discos.
Crear un volumen
- En Volumes, pulsa New Volume.
- Name: un nombre que diga qué contiene (
dataset-imagenes,modelos-entrenados). Minúsculas, números y guiones. - Volume size in Gi: el tamaño. El formulario propone
10. - Storage Class: elige la misma clase que muestran los volúmenes que ya existen en tu laboratorio (columna Storage Class). En la instalación de referencia es
saptiva-file. - Access Mode: elige ReadWriteMany.
- Pulsa CREATE.
El formulario abre con otra clase de almacenamiento y con ReadWriteOnce. El laboratorio solo acepta volúmenes de la clase de sus discos de trabajo, que es la que cuenta contra tu presupuesto: con cualquier otra, el volumen no se crea. Ajusta Storage Class y Access Mode antes de pulsar CREATE.
El volumen aparece en la lista sin nada en Used by. Está vacío hasta que lo montes en un notebook o le subas archivos con el explorador.
Modos de acceso
El formulario ofrece tres:
| Modo | Quién puede montarlo | Cuándo usarlo |
|---|---|---|
| ReadWriteMany | Varios notebooks a la vez, todos leen y escriben. | El que usan los volúmenes del laboratorio. Sirve para compartir datos entre notebooks. |
| ReadWriteOnce | Un solo equipo de cómputo a la vez. | No aplica a los discos de trabajo del laboratorio. |
| ReadOnlyMany | Varios notebooks a la vez, solo lectura. | Datos de referencia que nadie debe modificar, si tu instalación lo admite. |
El modo se elige al crear el volumen y no se cambia después.
Montar un volumen en un notebook
Un volumen se monta al crear el notebook, en la sección Data Volumes del formulario (Notebooks):
- Attach existing volume monta uno que ya existe. Elige el volumen y la ruta donde aparecerá, por ejemplo
/home/jovyan/datos. - Add new volume crea uno nuevo en ese momento.
Para compartir datos entre dos notebooks, monta el mismo volumen en ambos: lo que uno escribe, el otro lo ve en la misma ruta, sin copiar nada. Funciona aunque uno de los notebooks esté detenido.
Dos personas que escriben el mismo archivo a la vez se pisan. Reparte carpetas por persona o por experimento dentro del volumen.
Ver el detalle de un volumen
Pulsa el nombre del volumen. Volume details tiene tres pestañas:
- OVERVIEW: Access modes, Size, Storage class, Volume mode, Volume name (el identificador del disco en el almacenamiento) y Pods Mounted, que lista lo que lo tiene montado en este momento. Con el notebook detenido dice "No pods are using this PVC.".
- EVENTS: lo que le ha pasado al volumen. Si se quedó sin crear, aquí está el motivo.
- YAML: la definición completa, útil para pasársela a tu administrador cuando pidas ayuda.
DELETE, arriba a la derecha, elimina el volumen.
Tamaño y presupuesto
- Un volumen reserva su tamaño completo en el disco del laboratorio. Los chips del laboratorio en Studio muestran la suma (uso / tope).
- Si el volumen nuevo no cabe en lo que queda, no se crea. Elimina volúmenes que ya no uses o pide más disco (Redimensionar un laboratorio).
- El panel no ofrece cambiar el tamaño de un volumen ya creado. Si se quedó chico, crea uno mayor, monta ambos en un notebook, copia el contenido y elimina el anterior.
- El explorador de archivos de cada volumen ocupa memoria mientras está abierto. Ciérralo con la X al terminar (Subir y descargar archivos).
Eliminar un volumen
- Comprueba que Used by esté vacío. Mientras un notebook lo use, aunque esté detenido, el bote no se activa: elimina antes ese notebook, sin marcar el volumen.
- Descarga lo que quieras conservar (Subir y descargar archivos).
- Pulsa el bote de la fila, o DELETE en el detalle, y confirma.
Eliminar un volumen borra su contenido y no se puede recuperar. Eliminar el laboratorio elimina todos sus volúmenes.
Al eliminar un notebook, el diálogo pregunta si también se eliminan sus volúmenes. Desmárcalos para conservar los datos y volver a montarlos en otro notebook.
Recomendaciones
- Un Data Volume por conjunto de datos o por proyecto, no uno por persona.
- Nombres que digan qué hay dentro: nadie recuerda qué tenía
volumen-2. - Guarda el código en un repositorio; el volumen es para datos y resultados.
- Antes de eliminar un laboratorio, descarga lo que necesites: sus volúmenes se van con él.
- Revisa Volumes de vez en cuando: un volumen sin Used by sigue ocupando presupuesto.