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

# Collection Migrations

`migrations` ghi lại những migration cơ sở dữ liệu nào đã chạy. Mỗi tài liệu là một migration trong `tools/migrations/`. Tài liệu được ghi bởi bộ chuyển đổi của công cụ migration [east](https://github.com/okv/east), `tools/migrations/lib/adapter.mjs`, chứ không phải bởi một dịch vụ đang chạy.

#### Trường

| Trường | Kiểu | Ý nghĩa | Nguồn |
| - | - | - | - |
| `_id` | ObjectId | Id tài liệu. | `adapter.mjs:103` |
| `name` | String | Tên tệp của migration không có phần mở rộng, ví dụ `20190912145029_create_tags_indexes`. | `adapter.mjs:104` |
| `migratedAt` | Date | Thời điểm migration hoàn tất. | `adapter.mjs:105` |

#### Ai ghi

| Mã | Chức năng |
| - | - |
| `adapter.mjs:101-107` (`markExecuted`) | Chèn một tài liệu sau khi migration chạy xong. |
| `adapter.mjs:109-114` (`unmarkExecuted`) | Xóa nó lần nữa khi migration được hoàn tác. |

CE chạy `yarn run migrations migrate -t server-ce` mỗi lần container khởi động (`server-ce/init_scripts/900_run_web_migrations.sh:4-12`; `-t server-pro` khi `OVERLEAF_IS_SERVER_PRO=true`). Chỉ những migration có `tags` bao gồm môi trường đó mới chạy, nên chỉ chúng có tài liệu ở đây.

#### Ai đọc

| Mã | Chức năng |
| - | - |
| `adapter.mjs:72-99` (`getExecutedMigrationNames`) | east bỏ qua mọi migration có tên đã nằm ở đây. |
| `tools/migrations/lib/helpers.mjs:67-75` (`assertDependency`) | Một migration cần migration khác chạy trước sẽ báo lỗi khi tên đó không có. |

#### Chỉ mục

| Tên | Khóa | Tùy chọn | Migration |
| - | - | - | - |
| `name_1` | `{ name: 1 }` | unique | `tools/migrations/20190720165251_create_migrations.mjs` |

#### Ghi chú

* Xóa một tài liệu khiến migration đó chạy lại ở lần khởi động container tiếp theo, nếu các thẻ của nó khớp.
* Với một cụm Mongo phụ (`mongo.auxUrl`), các migration được gắn thẻ `auxiliary` sẽ được ghi vào collection `migrations` của cụm đó thay thế (`adapter.mjs:8-15`, `:64-70`). `mongo.auxUrl` lấy từ `MONGO_AUX_CONNECTION_STRING` (`tools/migrations/config/settings.defaults.js:19`), mặc định không được đặt.


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