Add devref for alembic milestone tagging

Related-Bug: #1499033

Change-Id: Iff58622c56be2c64cfb5659d20c4eae2f45a318c
This commit is contained in:
Henry Gessau 2015-09-29 12:15:06 -04:00
parent 52236764a3
commit 10b4e0964a
1 changed files with 17 additions and 0 deletions

View File

@ -317,3 +317,20 @@ and then applying all available rules::
It will apply all the rules from both the expand and the contract branches, in
proper order.
Tagging milestone revisions
~~~~~~~~~~~~~~~~~~~~~~~~~~~
When named release (liberty, mitaka, etc.) is done for neutron or a
sub-project, the alembic revision scripts at the head of each branch for that
release must be tagged. This is referred to as a milestone revision tag.
For example, `here <https://review.openstack.org/228272>`_ is a patch that tags
the liberty milestone revisions for the neutron-fwaas sub-project. Note that
each branch (expand and contract) is tagged.
Tagging milestones allows neutron-db-manage to upgrade the schema to a
milestone release, e.g.::
neutron-db-manage upgrade liberty