glance-manage

Glance 管理工具

作者:

OpenStack Glance 项目团队

联系方式:

glance@lists.launchpad.net

日期:

2025-04-02

版权:

OpenStack 基金会

版本:

30.0.0

手册章节:

1

手册组:

云计算

概要

glance-manage [options]

描述

glance-manage 是用于管理和配置 Glance 安装的工具。glance-manage 的一个重要用途是设置数据库。为此，请运行

glance-manage db_sync

注意：glance-manage 命令可以像这样运行

glance-manage db sync

或者将 db 命令连接在一起，像这样

glance-manage db_sync

命令

db

这是在以下命令中使用空格而不是下划线时的命令前缀。例如“db version”。

db_version

这将打印 Glance 数据库的当前迁移级别。

db_upgrade [VERSION]

这将获取现有的数据库并将其升级到指定的 VERSION。

db_version_control

将数据库置于迁移控制之下。

db_sync [VERSION]

将现有的数据库置于迁移控制之下并将其升级到指定的 VERSION。

db_expand

在滚动升级过程的第一个步骤中运行此命令以扩展数据库。

db_migrate

在滚动升级过程的第二个步骤中运行此命令以迁移数据库。

db_contract

在滚动升级过程的最后一个步骤中运行此命令以收缩数据库。

db_export_metadefs [PATH | PREFIX]

将元数据定义导出为 json 格式。默认情况下，定义导出到 /etc/glance/metadefs 目录。 注意： 此 命令 将 覆盖 提供的 或 默认 路径 中的 现有 文件。

db_load_metadefs [PATH]

将元数据定义加载到 Glance 数据库中。默认情况下，定义从 /etc/glance/metadefs 目录导入。

db_unload_metadefs

卸载元数据定义。清除所有 Glance 数据库表的内容，包括 metadef_namespace_resource_types、metadef_tags、metadef_objects、metadef_resource_types、metadef_namespaces 和 metadef_properties。

db_purge

从 Glance 数据库表中清除超过给定年龄的已删除行。

当调用时，此命令会解释以下选项

--max_rows

清除超过天数（如果未指定，则默认值为 100）的已删除行

--age_in_days

限制要删除的记录数（如果未指定，则默认值为 30 天）

警告：此函数主要在测试系统中很有用。除非您已查看 OpenStack 安全说明 OSSN-0075 并了解相关风险，否则我们不建议在生产系统中使用它。

db_purge_images_table

清除超过给定年龄的 images 数据库表中的已删除行。

当调用时，此命令会解释以下选项

--max_rows

清除超过天数（如果未指定，则默认值为 100）的已删除行

--age_in_days

限制要删除的记录数（如果未指定，则默认值为 30 天）

警告：此函数主要在测试系统中很有用。除非您已查看 OpenStack 安全说明 OSSN-0075 并了解相关风险，否则我们不建议在生产系统中使用它。

选项

常规选项

-h, --help

显示帮助信息并退出

--version

打印版本号并退出

-v, --verbose

打印更详细的输出

--noverbose

禁用详细输出

-d, --debug

打印调试输出（将日志级别设置为 DEBUG，而不是默认的 WARNING 级别）

--nodebug

禁用调试输出

--use-syslog

使用 syslog 进行日志记录

--nouse-syslog

禁用使用 syslog 进行日志记录

--syslog-log-facility SYSLOG_LOG_FACILITY

接收日志行的 syslog facility

--config-dir DIR

从中提取 *.conf 文件的配置目录路径。此文件集按排序方式排列，以便在单个选项被覆盖时提供可预测的解析顺序。该集在通过之前的 –config-file 参数指定的文件之后进行解析，因此目录中的覆盖选项优先。这意味着指定 config-dir 中的配置始终优先于通过 –config-file 指定的文件中的配置，无论参数顺序如何。

--config-file PATH

要使用的配置文件路径。可以通过多次使用此标志来指定多个配置文件，例如，–config-file <file1> –config-file <file2>。后面的文件中的值优先。

--log-config-append PATH --log-config PATH

日志配置文件的名称。它不会禁用现有的记录器，只是将指定的日志配置附加到任何其他现有的日志选项。有关日志配置文件的详细信息，请参阅 Python logging 模块文档。此选项的 log-config 名称已被弃用。

--log-format FORMAT

一个 logging.Formatter 日志消息格式字符串，可以使用任何可用的 logging.LogRecord 属性。默认值：None

--log-date-format DATE_FORMAT

日志记录中 %(asctime)s 的格式字符串。默认值：None

--log-file PATH, --logfile PATH

(可选) 输出到的日志文件名。如果未设置，日志将输出到 stdout。

--log-dir LOG_DIR, --logdir LOG_DIR

(可选) 存储日志文件的目录（将附加到 –log-file 前面）

请参阅

错误

  • Glance 错误在 Launchpad 中跟踪，因此您可以在 OpenStack Glance 上查看当前错误

配置

将按以下顺序搜索以下路径以查找 glance-manage.conf 文件

  • ~/.glance

  • ~/

  • /etc/glance

  • /etc

glance-manage.conf 中设置的所有选项都将覆盖 glance-api.conf 中设置的选项。