Un archivo de semillas es una exportación de instancias (JSON) que Yellow aplica a los entornos automáticamente. Las semillas son la forma de dar a cada entorno nuevo sus datos de base — tablas de referencia, categorías por defecto, contenido de demostración — sin tener que importarlos a mano cada vez.

La siembra siempre es prudente: solo crea las instancias que aún no existen. Las filas existentes no se tocan nunca, así que aplicar las mismas semillas dos veces es inofensivo.

Dos tipos de semillas

Tipo Vive en Se aplica a
Compartidas la carpeta seeds/ compartida, gestionada desde el área de administración todos los entornos
De entorno una carpeta seeds/ dentro de los Archivos de un entorno concreto solo ese entorno

Las semillas compartidas son para datos que todos los entornos deben tener. Las de entorno son para datos que pertenecen a un solo cliente o entorno.

Cuidado con las semillas compartidas. Una semilla compartida llega a todos los entornos — también a los que ahora mismo no tienes en mente. Si los datos son específicos de un entorno, hazla semilla de entorno.

Cuándo se aplican las semillas

  • Automáticamente, cada vez que el servidor de Yellow arranca. Primero las compartidas, después las propias de cada entorno.
  • Bajo demanda, desde el área de administración: abre el menú de tu perfil → Organitzacions → Llavors y haz clic en Aplicar las semillas ahora. Esto aplica los dos tipos al entorno en el que trabajas y muestra un informe — por archivo: cuántas instancias se han creado y cuántas se han omitido porque ya existían.

Cada archivo se aplica como una unidad: si algo dentro de un archivo falla, ese archivo se revierte por completo y se informa, y el resto de archivos se aplican igualmente.

Gestionar las semillas compartidas

La sección Llavors del área de administración lista los archivos de semillas compartidos.

  • Subir una semilla… — elige una exportación JSON. Yellow comprueba que tenga la forma correcta antes de aceptarla.
  • El icono de papelera elimina un archivo de semillas. Esto no elimina las instancias que ya haya creado — solo detiene la siembra futura.
  • Aplicar las semillas ahora — ejecuta la siembra inmediatamente y lee el informe.

Gestionar las semillas de entorno

Las semillas de entorno son archivos normales: abre el área de Archivos del entorno, crea una carpeta llamada seeds y sube allí tus exportaciones JSON. Se aplicarán a ese entorno en el próximo arranque del servidor, o cuando alguien haga clic en Aplicar las semillas ahora mientras trabaja en ese entorno.

Producir un archivo de semillas

Cualquier exportación JSON sirve como semilla:

  1. Abre la lista de instancias del modelo y da forma a la búsqueda (o selecciona las filas) que quieres incluir.
  2. Exportar → Exportar los resultados (JSON).
  3. Sube el archivo como semilla compartida o de entorno.

Un archivo cubre un modelo. Cuando las instancias de una semilla hacen referencia a instancias sembradas por otro archivo, nombra los archivos de forma que el que contiene los destinos se ordene primero — un prefijo numérico funciona bien: 01_categorias.json, 02_productos.json. Dentro de un mismo archivo, el orden no importa.

Como las instancias conservan sus identificadores, la misma fila sembrada tiene la misma identidad en todos los entornos — que es justamente lo que permite que las semillas se refieran entre sí de forma fiable.

¿Semillas o sincronización de entornos?

  • Usa las semillas para una base permanente: datos con los que todos los entornos (o uno) deben empezar siempre, mantenidos al día sustituyendo el archivo.
  • Usa Copiar datos entre entornos para una copia puntual de datos vivos de un entorno a otro.

Relacionado