diff --git a/oslo_db/sqlalchemy/migration_cli/manager.py b/oslo_db/sqlalchemy/migration_cli/manager.py index 42683310..812d4bcc 100644 --- a/oslo_db/sqlalchemy/migration_cli/manager.py +++ b/oslo_db/sqlalchemy/migration_cli/manager.py @@ -10,6 +10,7 @@ # License for the specific language governing permissions and limitations # under the License. +from debtcollector import removals import sqlalchemy from stevedore import enabled @@ -24,6 +25,12 @@ def check_plugin_enabled(ext): return ext.obj.enabled +@removals.remove( + message='Support for sqlalchemy-migrate and with it the migration manager ' + 'is deprecated for removal; consider migrating to and using alembic ' + 'directly', + version='8.3.0' +) class MigrationManager(object): def __init__(self, migration_config, engine=None): diff --git a/releasenotes/notes/deprecate-sqlalchemy-migrate-6f899935615d6984.yaml b/releasenotes/notes/deprecate-sqlalchemy-migrate-6f899935615d6984.yaml index bcb82525..c1c7fa7e 100644 --- a/releasenotes/notes/deprecate-sqlalchemy-migrate-6f899935615d6984.yaml +++ b/releasenotes/notes/deprecate-sqlalchemy-migrate-6f899935615d6984.yaml @@ -6,3 +6,9 @@ deprecations: development and has been effectively replaced by ``alembic``. Users of this module should consider switching to ``alembic`` or, if necessary, using ``sqlalchemy-migrate`` directly. + - | + The ``oslo_db.sqlalchemy.migration_cli`` module is deprecated for removal. + It was intended to provide an abstraction layer over different migration + backends - specifically ``sqlalchemy-migrate`` and ``alembic`` - however, + takeup has been limited and its expected that users will use ``alembic`` + directly nowadays.