11. awx-manage 工具

awx-manage 工具用于访问 AWX 的详细内部信息。 awx-manage 的命令应仅以 awx 用户身份运行。

警告

不建议或不支持通过剧本运行 awx-manage 命令。

11.1. 资产清单导入

awx-manage 是一种机制，AWX 管理员可以通过它将资产清单直接导入 AWX，适用于那些无法使用自定义资产清单脚本的人员。

要正确使用 awx-manage，您必须首先在 AWX 中创建一个资产清单，以用作导入的目标。

如需 awx-manage 的帮助，请运行以下命令：awx-manage inventory_import [--help]

inventory_import 命令将 AWX 资产清单对象与基于文本的资产清单文件、动态资产清单脚本或 Ansible 核心支持的一个或多个上述项的目录同步。

运行此命令时，请指定 --inventory-id 或 --inventory-name，以及 Ansible 资产清单源的路径 (--source)。

awx-manage inventory_import --source=/ansible/inventory/ --inventory-id=1

默认情况下，AWX 中已存储的资产清单数据会与来自外部源的数据混合。要仅使用外部数据，请指定 --overwrite。 要指定任何现有主机仅从 --source 获取变量数据，请指定 --overwrite_vars。默认行为会添加来自外部源的任何新变量，覆盖已存在的键，但会保留任何未从外部数据源获取的变量。

awx-manage inventory_import --source=/ansible/inventory/ --inventory-id=1 --overwrite

注意

只要未设置 --overwrite_vars，对资产清单主机变量的编辑和添加就会在资产清单同步后保留。

11.2. 清理旧数据

awx-manage 有各种命令用于从 AWX 中清除旧数据。AWX 管理员可以使用管理作业界面进行访问或使用命令行。

• awx-manage cleanup_jobs [--help]

这将永久删除指定天数之前的作业的作业详细信息和作业输出。

• awx-manage cleanup_activitystream [--help]

11.3. 集群管理

注意

除非 Red Hat Ansible 人员指示，否则请勿运行其他 awx-manage 命令。

11.4. 会话管理

11.4.1. expire_sessions

使用此命令终止所有会话或特定用户的所有会话。当用户在组织中更改角色、从 AD 中删除各种组或管理员希望确保用户由于这些组中的成员身份而无法再执行作业时，请考虑使用此命令。

$ awx-manage expire_sessions

此命令默认终止所有会话。与这些会话关联的用户将因此被注销。要仅使特定用户的会话过期，您可以使用 --user 标志传递其用户名（在下面为 example_user 指定实际用户名）

$ awx-manage expire_sessions --user example_user

11.4.2. clearsessions

使用此命令删除所有已过期的会话。有关更多详细信息，请参阅 Django 的关于 clearsessions 的文档。

11.5. 分析收集

使用此命令按需收集预定义窗口（默认为 4 小时）之外的分析数据

$ awx-manage gather_analytics --ship

对于具有断开连接的环境且希望收集有关在一段时间内自动化的唯一主机的使用信息的客户，请使用此命令

awx-manage host_metric --since YYYY-MM-DD --until YYYY-MM-DD --json

参数 --since 和 --until 指定日期范围，并且是可选的，但必须存在其中一个。 --json 标志指定输出格式，并且是可选的。