diff options
author | Stephen Finucane <stephenfin@redhat.com> | 2023-02-01 16:42:53 +0000 |
---|---|---|
committer | Stephen Finucane <stephenfin@redhat.com> | 2023-02-01 17:00:03 +0000 |
commit | fd39e4b4be9ddb18b96d5f8086955b91232f25e9 (patch) | |
tree | 9a6acba53ed307b1dcfa4f3cd219c4b2d892c662 /doc/source/reference/database-migrations.rst | |
parent | f01a90ccb85ab254236f84009cd432d03ce12ebb (diff) | |
download | nova-fd39e4b4be9ddb18b96d5f8086955b91232f25e9.tar.gz |
db: Remove legacy migrations
sqlalchemy-migrate does not (and will not) support sqlalchemy 2.0. We
need to drop these migrations to ensure we can upgrade our sqlalchemy
version.
Change-Id: I7756e393b78296fb8dbf3ca69c759d75b816376d
Signed-off-by: Stephen Finucane <stephenfin@redhat.com>
Diffstat (limited to 'doc/source/reference/database-migrations.rst')
-rw-r--r-- | doc/source/reference/database-migrations.rst | 12 |
1 files changed, 8 insertions, 4 deletions
diff --git a/doc/source/reference/database-migrations.rst b/doc/source/reference/database-migrations.rst index add7597e93..ea2b9050d9 100644 --- a/doc/source/reference/database-migrations.rst +++ b/doc/source/reference/database-migrations.rst @@ -24,6 +24,10 @@ Schema migrations The database migration engine was changed from ``sqlalchemy-migrate`` to ``alembic``. +.. versionchanged:: 27.0.0 (Antelope) + + The legacy ``sqlalchemy-migrate``-based database migrations were removed. + The `alembic`__ database migration tool is used to manage schema migrations in nova. The migration files and related metadata can be found in ``nova/db/api/migrations`` (for the API database) and @@ -36,10 +40,10 @@ respectively. .. note:: - There are also legacy migrations provided in the ``legacy_migrations`` - subdirectory for both the API and main databases. These are provided to - facilitate upgrades from pre-Xena (24.0.0) deployments and will be removed - in a future release. They should not be modified or extended. + There were also legacy migrations provided in the ``legacy_migrations`` + subdirectory for both the API and main databases. These were provided to + facilitate upgrades from pre-Xena (24.0.0) deployments. They were removed + in the 27.0.0 (Antelope) release. The best reference for alembic is the `alembic documentation`__, but a small example is provided here. You can create the migration either manually or |