Fixed #22032 -- added documentation for settings.MIGRATION_MODULES
This commit is contained in:
parent
2798e63fa1
commit
ede99f0ec3
|
@ -1539,6 +1539,24 @@ Default::
|
||||||
|
|
||||||
A tuple of middleware classes to use. See :doc:`/topics/http/middleware`.
|
A tuple of middleware classes to use. See :doc:`/topics/http/middleware`.
|
||||||
|
|
||||||
|
.. setting:: MIGRATION_MODULES
|
||||||
|
|
||||||
|
MIGRATION_MODULES
|
||||||
|
-----------------
|
||||||
|
|
||||||
|
Default::
|
||||||
|
|
||||||
|
{} # empty dictionary
|
||||||
|
|
||||||
|
A dictionary specifying the package where migration modules can be found on a per-app basis. The default value
|
||||||
|
of this setting is an empty dictionary, but the default package name for migration modules is ``migrations``.
|
||||||
|
|
||||||
|
Example::
|
||||||
|
|
||||||
|
{'blog': 'blog.db_migrations'}
|
||||||
|
|
||||||
|
In this case, migrations pertaining to the ``blog`` app will be contained in the ``blog.db_migrations`` package.
|
||||||
|
|
||||||
.. setting:: MONTH_DAY_FORMAT
|
.. setting:: MONTH_DAY_FORMAT
|
||||||
|
|
||||||
MONTH_DAY_FORMAT
|
MONTH_DAY_FORMAT
|
||||||
|
|
|
@ -51,6 +51,10 @@ of, its codebase. You should be making them once on your development machine
|
||||||
and then running the same migrations on your colleagues' machines, your
|
and then running the same migrations on your colleagues' machines, your
|
||||||
staging machines, and eventually your production machines.
|
staging machines, and eventually your production machines.
|
||||||
|
|
||||||
|
.. note::
|
||||||
|
It is possible to override the name of the package which contains the
|
||||||
|
migrations on a per-app basis by modifying the :setting:`MIGRATION_MODULES` setting.
|
||||||
|
|
||||||
Migrations will run the same way every time and produce consistent results,
|
Migrations will run the same way every time and produce consistent results,
|
||||||
meaning that what you see in development and staging is exactly what will
|
meaning that what you see in development and staging is exactly what will
|
||||||
happen in production - no unexpected surprises.
|
happen in production - no unexpected surprises.
|
||||||
|
|
Loading…
Reference in New Issue