API

upgradecheck 模块

class oslo_upgradecheck.upgradecheck.Code(value, names=<not given>, *values, module=None, qualname=None, type=None, start=1, boundary=None)

升级检查命令的状态码

class oslo_upgradecheck.upgradecheck.Result(code, details=None)

用于‘nova-status upgrade check’结果的类。

‘code’属性是一个 Code 枚举。‘details’属性是一个翻译后的消息,通常仅用于导致警告或失败代码的检查。详细信息应提供有关发现的问题的信息以及任何补救措施。

class oslo_upgradecheck.upgradecheck.UpgradeCommands

升级检查的基础类

此类应由每个项目中的一个类继承,该类提供实际的检查。这些检查应添加到 _upgrade_checks 类成员中,以便在调用 check 方法时运行它们。

这里的子命令不得依赖于服务对象模型,因为它们应该能够运行在 n-1 数据上。任何数据库查询都应通过 sqlalchemy 查询语言直接进行,就像数据库模式迁移一样。

check()

执行检查,以查看部署是否已准备好进行升级。

预计在重新启动使用新代码的服务之前运行这些检查。

返回值:

代码

oslo_upgradecheck.upgradecheck.main(conf, project, upgrade_command, argv=['-W', '--keep-going', '-b', 'html', 'doc/source', 'doc/build/html'], default_config_files=None)

升级检查的简单 main 实现

这可用于升级检查命令,以提供所需的最小参数处理和逻辑。

参数:
  • conf – 一个 oslo.confg ConfigOpts 实例,用于注册升级检查参数。

  • project – 项目的名称,用作 oslo_config.ConfigOpts 实例的参数,以查找配置文件。

  • upgrade_command – UpgradeCommands 实例。

  • argv – 要解析的命令行参数。默认为 sys.argv[1:]。

  • default_config_files – 要加载的配置文件。对于使用配置文件的非标准默认位置的项目,请使用此选项覆盖 oslo.config 中的搜索行为。

oslo_upgradecheck.upgradecheck.register_cli_options(conf, upgrade_command)

设置命令行选项。

添加一个子命令以支持命令行上的‘upgrade check’。

参数:
  • conf – 一个 oslo.confg ConfigOpts 实例,用于注册升级检查参数。

  • upgrade_command – UpgradeCommands 实例。

oslo_upgradecheck.upgradecheck.run(conf)

运行请求的命令。

参数:

conf – 一个 oslo.confg ConfigOpts 实例,升级命令先前已在该实例上注册。