> ## Documentation Index
> Fetch the complete documentation index at: https://ayakaleaf-pro.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Migrations-kokoelma

`migrations` kirjaa, mitkä tietokantamigraatiot on ajettu. Yksi dokumentti on yksi migraatio hakemistosta `tools/migrations/`. Sen kirjoittaa migraatiotyökalu [east](https://github.com/okv/east):n sovitin `tools/migrations/lib/adapter.mjs`, ei käynnissä oleva palvelu.

#### Kentät

| Kenttä | Tyyppi | Merkitys | Lähde |
| - | - | - | - |
| `_id` | ObjectId | Dokumentin id. | `adapter.mjs:103` |
| `name` | String | Migraation tiedostonimi ilman päätettä, esimerkiksi `20190912145029_create_tags_indexes`. | `adapter.mjs:104` |
| `migratedAt` | Date | Milloin migraatio valmistui. | `adapter.mjs:105` |

#### Kuka kirjoittaa

| Koodi | Mitä se tekee |
| - | - |
| `adapter.mjs:101-107` (`markExecuted`) | Lisää dokumentin, kun migraatio on ajettu. |
| `adapter.mjs:109-114` (`unmarkExecuted`) | Poistaa sen taas, kun migraatio perutaan. |

CE ajaa komennon `yarn run migrations migrate -t server-ce` jokaisessa säilön käynnistyksessä (`server-ce/init_scripts/900_run_web_migrations.sh:4-12`; `-t server-pro`, kun `OVERLEAF_IS_SERVER_PRO=true`). Vain migraatiot, joiden `tags` sisältää kyseisen ympäristön, ajetaan, joten vain ne saavat tänne dokumentin.

#### Kuka lukee

| Koodi | Mitä se tekee |
| - | - |
| `adapter.mjs:72-99` (`getExecutedMigrationNames`) | east ohittaa jokaisen migraation, jonka nimi on jo täällä. |
| `tools/migrations/lib/helpers.mjs:67-75` (`assertDependency`) | Migraatio, joka edellyttää toisen ajamista ensin, heittää virheen, kun kyseinen nimi puuttuu. |

#### Indeksit

| Nimi | Avaimet | Asetukset | Migraatio |
| - | - | - | - |
| `name_1` | `{ name: 1 }` | unique | `tools/migrations/20190720165251_create_migrations.mjs` |

#### Huomioita

* Dokumentin poistaminen saa kyseisen migraation ajautumaan uudelleen seuraavassa säilön käynnistyksessä, jos sen tunnisteet täsmäävät.
* Kun käytössä on apu-Mongoklusteri (`mongo.auxUrl`), tunnisteella `auxiliary` merkityt migraatiot kirjataan sen sijaan kyseisen klusterin `migrations`-kokoelmaan (`adapter.mjs:8-15`, `:64-70`). `mongo.auxUrl` tulee muuttujasta `MONGO_AUX_CONNECTION_STRING` (`tools/migrations/config/settings.defaults.js:19`), jota ei ole oletuksena asetettu.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.