Saltar al contenido principal

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 VolumeData Volume
Para quéTu carpeta personal: notebooks, código, entornos virtuales.Datos del proyecto: datasets, modelos entrenados, resultados.
Cuántos por notebookUno.Los que necesites.
Dónde aparece/home/jovyanLa ruta que elijas al montarlo.
Cómo se creaSolo, al crear el notebook (<nombre>-workspace).Con New Volume, o con Add new volume en el formulario del notebook.
Uso típicoUn 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:

ColumnaQué dice
StatusVerde cuando el disco está listo para montarse.
NameNombre del volumen. Abre su detalle.
Created atCuándo se creó.
SizeTamaño reservado, en Gi.
Access ModeCuántos notebooks pueden montarlo a la vez (ver Modos de acceso).
Storage ClassTipo de almacenamiento de la instalación donde vive el disco.
Used byNotebook 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​

  1. En Volumes, pulsa New Volume.
  2. Name: un nombre que diga qué contiene (dataset-imagenes, modelos-entrenados). Minúsculas, números y guiones.
  3. Volume size in Gi: el tamaño. El formulario propone 10.
  4. 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.
  5. Access Mode: elige ReadWriteMany.
  6. Pulsa CREATE.
Cambia los dos valores que propone el formulario

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:

ModoQuién puede montarloCuándo usarlo
ReadWriteManyVarios notebooks a la vez, todos leen y escriben.El que usan los volúmenes del laboratorio. Sirve para compartir datos entre notebooks.
ReadWriteOnceUn solo equipo de cómputo a la vez.No aplica a los discos de trabajo del laboratorio.
ReadOnlyManyVarios 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​

  1. 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.
  2. Descarga lo que quieras conservar (Subir y descargar archivos).
  3. Pulsa el bote de la fila, o DELETE en el detalle, y confirma.
No hay papelera

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.

Siguiente paso​