> ## 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

`migrations` фіксує, які міграції бази даних уже виконано. Кожен документ описує одну міграцію з `tools/migrations/`. Його записує адаптер інструмента міграцій [east](https://github.com/okv/east), `tools/migrations/lib/adapter.mjs`, а не запущений сервіс.

#### Поля

| Поле | Тип | Значення | Джерело |
| - | - | - | - |
| `_id` | ObjectId | Id документа. | `adapter.mjs:103` |
| `name` | String | Назва файлу міграції без розширення, наприклад `20190912145029_create_tags_indexes`. | `adapter.mjs:104` |
| `migratedAt` | Date | Коли міграція завершилася. | `adapter.mjs:105` |

#### Хто записує

| Код | Що робить |
| - | - |
| `adapter.mjs:101-107` (`markExecuted`) | Вставляє документ після виконання міграції. |
| `adapter.mjs:109-114` (`unmarkExecuted`) | Знову видаляє його під час відкату міграції. |

CE виконує `yarn run migrations migrate -t server-ce` під час кожного запуску контейнера (`server-ce/init_scripts/900_run_web_migrations.sh:4-12`; `-t server-pro`, якщо `OVERLEAF_IS_SERVER_PRO=true`). Виконуються лише міграції, у `tags` яких є це середовище, тому лише вони отримують тут документ.

#### Хто читає

| Код | Що робить |
| - | - |
| `adapter.mjs:72-99` (`getExecutedMigrationNames`) | east пропускає кожну міграцію, назва якої вже є тут. |
| `tools/migrations/lib/helpers.mjs:67-75` (`assertDependency`) | Міграція, якій потрібно, щоб інша виконалася раніше, викидає помилку, якщо цієї назви немає. |

#### Індекси

| Назва | Ключі | Параметри | Міграція |
| - | - | - | - |
| `name_1` | `{ name: 1 }` | unique | `tools/migrations/20190720165251_create_migrations.mjs` |

#### Примітки

* Якщо видалити документ, ця міграція знову виконається під час наступного запуску контейнера, якщо її теги збігаються.
* З допоміжним кластером Mongo (`mongo.auxUrl`) міграції з тегом `auxiliary` натомість записуються в колекцію `migrations` того кластера (`adapter.mjs:8-15`, `:64-70`). `mongo.auxUrl` береться з `MONGO_AUX_CONNECTION_STRING` (`tools/migrations/config/settings.defaults.js:19`), який за замовчуванням не задано.


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