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

# Kolekcja Migrations

`migrations` zapisuje, które migracje bazy danych zostały uruchomione. Jeden dokument to jedna migracja z `tools/migrations/`. Zapisuje go adapter narzędzia migracji [east](https://github.com/okv/east), `tools/migrations/lib/adapter.mjs`, a nie działająca usługa.

#### Pola

| Pole | Typ | Znaczenie | Źródło |
| - | - | - | - |
| `_id` | ObjectId | Id dokumentu. | `adapter.mjs:103` |
| `name` | String | Nazwa pliku migracji bez rozszerzenia, na przykład `20190912145029_create_tags_indexes`. | `adapter.mjs:104` |
| `migratedAt` | Date | Kiedy migracja się zakończyła. | `adapter.mjs:105` |

#### Kto zapisuje

| Kod | Co robi |
| - | - |
| `adapter.mjs:101-107` (`markExecuted`) | Wstawia dokument po uruchomieniu migracji. |
| `adapter.mjs:109-114` (`unmarkExecuted`) | Ponownie go usuwa, gdy migracja zostaje wycofana. |

CE uruchamia `yarn run migrations migrate -t server-ce` przy każdym starcie kontenera (`server-ce/init_scripts/900_run_web_migrations.sh:4-12`; `-t server-pro`, gdy `OVERLEAF_IS_SERVER_PRO=true`). Uruchamiane są tylko migracje, których `tags` obejmują to środowisko, więc tylko one dostają tu dokument.

#### Kto odczytuje

| Kod | Co robi |
| - | - |
| `adapter.mjs:72-99` (`getExecutedMigrationNames`) | east pomija każdą migrację, której nazwa już tu jest. |
| `tools/migrations/lib/helpers.mjs:67-75` (`assertDependency`) | Migracja wymagająca wcześniejszego uruchomienia innej zgłasza błąd, gdy brakuje tej nazwy. |

#### Indeksy

| Nazwa | Klucze | Opcje | Migracja |
| - | - | - | - |
| `name_1` | `{ name: 1 }` | unique | `tools/migrations/20190720165251_create_migrations.mjs` |

#### Uwagi

* Usunięcie dokumentu sprawia, że migracja uruchomi się ponownie przy następnym starcie kontenera, jeśli jej tagi pasują.
* Przy pomocniczym klastrze Mongo (`mongo.auxUrl`) migracje oznaczone tagiem `auxiliary` są zamiast tego zapisywane w kolekcji `migrations` tego klastra (`adapter.mjs:8-15`, `:64-70`). `mongo.auxUrl` pochodzi z `MONGO_AUX_CONNECTION_STRING` (`tools/migrations/config/settings.defaults.js:19`), które domyślnie nie jest ustawione.


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