summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--oslo_db/sqlalchemy/migration_cli/manager.py7
-rw-r--r--releasenotes/notes/deprecate-sqlalchemy-migrate-6f899935615d6984.yaml6
2 files changed, 13 insertions, 0 deletions
diff --git a/oslo_db/sqlalchemy/migration_cli/manager.py b/oslo_db/sqlalchemy/migration_cli/manager.py
index 4268331..812d4bc 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 bcb8252..c1c7fa7 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.