Commit fd2bac0b authored by Andreas Brandl's avatar Andreas Brandl

Note about backports and versioned migrations

parent 56753c80
...@@ -240,10 +240,16 @@ class TestMigration < Gitlab::Database::Migration[1.0] ...@@ -240,10 +240,16 @@ class TestMigration < Gitlab::Database::Migration[1.0]
end end
``` ```
Note that it is discouraged to include `Gitlab::Database::MigrationHelpers` directly into a NOTE:
It is discouraged to include `Gitlab::Database::MigrationHelpers` directly into a
migration. Instead, the latest version of `Gitlab::Database::Migration` will expose the latest migration. Instead, the latest version of `Gitlab::Database::Migration` will expose the latest
version of migration helpers automatically. version of migration helpers automatically.
NOTE:
Migration helpers and versioning are available starting from [14.3](https://gitlab.com/gitlab-org/gitlab/-/merge_requests/68986).
For merge requests targeting previous stable branches, the old format needs to be used and we continue
to inherit from `ActiveRecord::Migration[6.1]` instead of `Gitlab::Database::Migration[1.0]` for those.
## Retry mechanism when acquiring database locks ## Retry mechanism when acquiring database locks
When changing the database schema, we use helper methods to invoke DDL (Data Definition When changing the database schema, we use helper methods to invoke DDL (Data Definition
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment