openstack neutron数据库的版本化管理

By | 2022年4月26日
目录
[隐藏]

openstack使用neutron-db-manage这个工具来管理neutron的数据库。如果我们对neutron的数据库要做一些修改,比如简单的增加一张表,删除一张表等,就需要使用这个工具了。
下面简单介绍一下如何使用这个工具:

1.neutron-db-manager current

通过使用这个命令来查看当前neutron数据库的版本状况

# neutron-db-manage current
  Running current for neutron ...
INFO  [alembic.runtime.migration] Context impl MySQLImpl.
INFO  [alembic.runtime.migration] Will assume non-transactional DDL.
5b1229d495d7 (head)
644861cf5d9f (head)
  OK
  Running current for neutron-fwaas ...
INFO  [alembic.runtime.migration] Context impl MySQLImpl.
INFO  [alembic.runtime.migration] Will assume non-transactional DDL.
4b47ea298795 (head)
67c8e8d61d5 (head)
  OK

上述结果中显示了两个subproject的版本信息,分别是neutron和neutron-fwaas。
结果中每个subproject都有两条版本号信息,我们拿neutron这个subproject为例简单说明一下。

5b1229d495d7 (head)

这个是expand分支的版本信息,后面的(head)表明当前版本是最新版本。
expand这个分支代表的是所有对数据库进行的扩充操作。
比如你给数据库增加了一张表,那么这个操作引起的版本号变更就会体现在这个分支上。

644861cf5d9f (head)

这个是contract分支的版本信息,后面一样的,(head)表明当前版本是最新版本。
contract这个分支代表的是所有对数据库进行的缩减操作(例如删除表操作)。

2.neutron-db-manager revision

这个命令是为数据库变更创建一个修订文件,同时它也会生成一个新的版本和版本号,所以在应用该修订文件之前前,对应分支的版本号不再显示为head状态(有更新的版本未应用)。
它有几个参数

  1. -m
    为新版本设定一些备注信息,方便版本管理
  2. –autogenerate/–expand/–contract(三选一,无法同时存在)
    –autogenerate表示让工具自动创建修订文件,包括填充修订文件中对应的修改内容(会去自动比较当前数据库和neutron的数据库模板文件)。
    使用该参数后,工具会自动识别分支类型(expand/contract),但是如果扩充和缩减操作同时存在,那么使用该参数会报错,需要分别使用–expand和–contract。
    –expand,创建一个空修订文件,为expand分支生成新的版本和版本号,用户需要手动添加修改内容到修订文件中。
    –contract,创建一个空修订文件,为contract分支生成新的版本和版本号,用户需要手动添加修改内容到修订文件中。

3.neutron-db-manager upgrade

这条命令是应用修订文件,并更新版本号。
upgrade后面可以跟三个参数:heads/–expand/–contract

  1. heads
    例如:

    neutron-db-manager upgrade heads

    这会应用所有的修订文件,包括expand分支和contract分支,并更新到最新版本。

  2. –expand
    应用expand分支的修订文件,并更新到最新版本
  3. –contract
    应用contract分支的修订文件,并更新到最新版本

4.其他

如果有多个subproject的情况下,上述的命令都可以使用subproject参数来选择,例如:

neutron-db-manager --subproject neutron current
Category: 未分类 标签:

发表评论

您的电子邮箱地址不会被公开。