Designate Manage CLI

本章节记录了 designate-manage

要获取特定 designate 命令的帮助，请输入

$ designate-manage COMMAND --help

designate-manage

designate-manage 用法

usage: designate-manage [-h] [--config-dir DIR] [--config-file PATH] [--debug]
                        [--log-config-append PATH] [--log-date-format DATE_FORMAT]
                        [--log-dir LOG_DIR] [--log-file PATH] [--nodebug]
                        [--nouse-syslog] [--nouse-syslog-rfc-format] [--noverbose]
                        [--nowatch-log-file]
                        [--syslog-log-facility SYSLOG_LOG_FACILITY] [--use-syslog]
                        [--use-syslog-rfc-format] [--verbose] [--version]
                        [--watch-log-file]

designate 可选参数

--config-dir DIR

从目录中读取 *.conf 文件的路径。此文件集按排序方式处理，以便在单独选项被覆盖时提供可预测的解析顺序。该集在通过之前的 –config-file 参数指定的文件之后进行解析，因此目录中的覆盖选项优先。

--config-file PATH

要使用的配置文件路径。 可以指定多个配置文件，后面的文件的值优先。 默认值为 None。

--debug, -d

如果设置为 true，日志级别将被设置为 DEBUG，而不是默认的 INFO 级别。

--log-config-append PATH, --log_config PATH

日志配置文件的名称。此文件将附加到任何现有的日志配置文件的末尾。有关日志配置文件的详细信息，请参阅 Python logging 模块文档。请注意，在使用日志配置文件时，所有日志配置都设置在配置文件中，并且其他日志配置选项将被忽略（例如，logging_context_format_string）。

--log-date-format DATE_FORMAT

定义日志记录中 %(asctime)s 的格式字符串。默认值：None。如果设置了 log_config_append，则忽略此选项。

--log-dir LOG_DIR, --logdir LOG_DIR

(可选) 用于相对 log_file 路径的基本目录。如果设置了 log_config_append，则此选项将被忽略。

--log-file PATH, --logfile PATH

(可选) 将日志输出发送到的日志文件名。如果没有设置默认值，日志将输出到 stderr，如 use_stderr 中定义的那样。如果设置了 log_config_append，则此选项将被忽略。

--nodebug

--debug 的反向选项

--nouse-syslog

--use-syslog 的反向选项

--nouse-syslog-rfc-format

--use-syslog-rfc-format 的反向选项

--noverbose

--verbose 的反向选项

--nowatch-log-file

--watch-log-file 的反向选项

--syslog-log-facility SYSLOG_LOG_FACILITY

接收日志行的 syslog facility。如果设置了 log_config_append，则此选项将被忽略。

--use-syslog

使用 syslog 进行日志记录。现有的 syslog 格式已弃用，以后将更改为符合 RFC5424。如果设置了 log_config_append，则此选项将被忽略。

--use-syslog-rfc-format

启用或禁用日志记录的 syslog rfc5424 格式。如果启用，则在 syslog 消息的 MSG 部分前加上 APP-NAME（RFC5424）。如果设置了 log_config_append，则此选项将被忽略。

--verbose, -v

如果设置为 false，则日志级别将被设置为 WARNING 而不是默认的 INFO 级别。

--watch-log-file

使用设计为监视文件系统的日志记录处理程序。当日志文件被移动或删除时，此处理程序将立即使用指定的路径打开新的日志文件。只有在指定了 log_file 选项并且使用 Linux 平台时才有意义。如果设置了 log_config_append，则此选项将被忽略。

designate-manage pool

usage: designate pool [-h] {generate_file,show_config,update} ...

positional arguments:
  {generate_file,show_config,update}

designate-manage pool generate_file

usage: designate-manage pool generate_file [-h] [--file FILE]

导出当前运行的池配置的 YAML 副本

可选参数

-h, --help

显示此帮助消息并退出

--file FILE

YAML 输出应该写入的文件路径（默认为 /etc/designate/pools.yaml）

designate-manage pool update

usage: designate-manage pool update [-h] [--file FILE] [--delete]
                                    [--dry-run]

从 YAML 文件更新正在运行的池配置

可选参数

-h, --help

显示此帮助消息并退出

--file FILE

应该用于更新池配置的文件路径（默认为 /etc/designate/pools.yaml）

--delete

配置中未列出的任何池将被删除。.. 警告:: 这将删除此池中剩余的任何区域

--dry-run

这将模拟运行此命令时会发生什么

designate-manage pool show

usage: designate-manage pool show_config [-h] [--pool_id POOL_ID]
                                         [--all_pools]

显示已部署的池配置

可选参数

-h, --help

显示此帮助消息并退出

--pool_id POOL_ID

要检查的池的 ID

--all_pools

显示所有池的配置

designate-manage database

designate-manage database sync

usage: designate-manage database sync [-h] [--revision REVISION]

更新 designate 数据库模式

可选参数

-h, --help

显示此帮助消息并退出

--revision REVISION

指定 designate 数据库应该同步到的版本。（默认为最新版本）

designate-manage database version

usage: designate-manage database version [-h]

显示当前数据库模式的版本

可选参数

-h, --help

显示此帮助消息并退出