Un fitxer de llavors és una exportació d'instàncies (JSON) que Yellow aplica als entorns automàticament. Les llavors són la manera de donar a cada entorn nou les seves dades de base — taules de referència, categories per defecte, contingut de demostració — sense haver-les d'importar a mà cada vegada.

La sembra sempre és prudent: només crea les instàncies que encara no existeixen. Les files existents no es toquen mai, així que aplicar les mateixes llavors dues vegades és inofensiu.

Dos tipus de llavors

Tipus Viu a S'aplica a
Compartides la carpeta seeds/ compartida, gestionada des de l'àrea d'administració tots els entorns
D'entorn una carpeta seeds/ dins dels Fitxers d'un entorn concret només aquell entorn

Les llavors compartides són per a dades que tots els entorns han de tenir. Les d'entorn són per a dades que pertanyen a un sol client o entorn.

Compte amb les llavors compartides. Una llavor compartida arriba a tots els entorns — també als que ara mateix no tens al cap. Si les dades són específiques d'un entorn, fes-ne una llavor d'entorn.

Quan s'apliquen les llavors

  • Automàticament, cada vegada que el servidor de Yellow arrenca. Primer les compartides, després les pròpies de cada entorn.
  • Sota demanda, des de l'àrea d'administració: obre el menú del teu perfil → Organitzacions → Llavors i fes clic a Aplica les llavors ara. Això aplica els dos tipus a l'entorn on treballes i mostra un informe — per fitxer: quantes instàncies s'han creat i quantes s'han omès perquè ja existien.

Cada fitxer s'aplica com una unitat: si alguna cosa dins d'un fitxer falla, aquell fitxer es reverteix completament i s'informa, i la resta de fitxers s'apliquen igualment.

Gestionar les llavors compartides

La secció Llavors de l'àrea d'administració llista els fitxers de llavors compartits.

  • Puja una llavor… — tria una exportació JSON. Yellow comprova que tingui la forma correcta abans d'acceptar-la.
  • La icona de paperera elimina un fitxer de llavors. Això no elimina les instàncies que ja hagi creat — només atura la sembra futura.
  • Aplica les llavors ara — executa la sembra immediatament i llegeix l'informe.

Gestionar les llavors d'entorn

Les llavors d'entorn són fitxers normals: obre l'àrea de Fitxers de l'entorn, crea una carpeta anomenada seeds i puja-hi les teves exportacions JSON. S'aplicaran a aquell entorn a la propera arrencada del servidor, o quan algú faci clic a Aplica les llavors ara mentre treballa en aquell entorn.

Produir un fitxer de llavors

Qualsevol exportació JSON serveix com a llavor:

  1. Obre la llista d'instàncies del model i dona forma a la cerca (o selecciona les files) que vols incloure.
  2. Exporta → Exporta els resultats (JSON).
  3. Puja el fitxer com a llavor compartida o d'entorn.

Un fitxer cobreix un model. Quan les instàncies d'una llavor fan referència a instàncies sembrades per un altre fitxer, anomena els fitxers de manera que el que conté les destinacions s'ordeni primer — un prefix numèric funciona bé: 01_categories.json, 02_productes.json. Dins d'un mateix fitxer, l'ordre no importa.

Com que les instàncies conserven els identificadors, la mateixa fila sembrada té la mateixa identitat a tots els entorns — que és justament el que permet que les llavors es refereixin entre elles de manera fiable.

Llavors o sincronització d'entorns?

  • Fes servir les llavors per a una base permanent: dades amb què tots els entorns (o un) han de començar sempre, mantingudes al dia substituint el fitxer.
  • Fes servir Copiar dades entre entorns per a una còpia puntual de dades vives d'un entorn a un altre.

Relacionat