community.general.virtualbox 资源清单 – VirtualBox 资源清单来源

注意

此资源清单插件是 community.general 集合 (版本 10.1.0) 的一部分。

如果您使用的是 ansible 包，则可能已安装此集合。它不包含在 ansible-core 中。要检查是否已安装它，请运行 ansible-galaxy collection list。

要安装它，请使用： ansible-galaxy collection install community.general。

要在剧本中使用它，请指定： community.general.virtualbox。

概要

  • 从本地 VirtualBox 安装中获取资源清单主机。

  • 使用以 virtualbox.(yml|yaml) 或 vbox.(yml|yaml) 结尾的 YAML 配置文件。

  • inventory_hostname 始终是 VirtualBox 实例的“名称”。

  • 可以使用 VBoxManage 将组分配给虚拟机。可以使用 / 作为分隔符分配多个组。

  • 公开了一个单独的参数 enable_advanced_group_parsing 来更改分组行为。有关详细信息，请参见参数文档。

参数

参数

注释

cache

布尔值

切换以启用/禁用资源清单源数据的缓存，需要设置缓存插件才能正常工作。

选项

  • false ← (默认值)

  • true

配置

cache_connection

字符串

缓存连接数据或路径，有关详细信息，请阅读缓存插件文档。

配置

cache_plugin

字符串

要用于资源清单源数据的缓存插件。

默认值： "memory"

配置

cache_prefix

字符串

用于缓存插件文件/表的前缀

默认值： "ansible_inventory_"

配置

cache_timeout

整数

缓存持续时间（秒）

默认值： 3600

配置

compose

字典

从 Jinja2 表达式创建变量。

默认值： {}

enable_advanced_group_parsing

布尔值

在 community.general 9.2.0 中添加

默认组解析规则（当此设置为 false 时）是根据 / 字符分割 VirtualBox 虚拟机的组，并将结果列表元素分配为 Ansible 组。

将 enable_advanced_group_parsing=true 设置为 true 会更改此行为，使其与 VirtualBox 对组的解释相匹配，详见 https://www.virtualbox.org/manual/UserManual.html#gui-vmgroups。现在使用 , 字符分割组，/ 字符表示嵌套组。

启用后，使用 VBoxManage modifyvm "vm01" --groups "/TestGroup/TestGroup2,/TestGroup3" 配置的虚拟机将导致组 TestGroup2 成为 TestGroup 的子组；并且虚拟机是 TestGroup2 和 TestGroup3 的一部分。

选项

  • false ← (默认值)

  • true

groups

字典

根据 Jinja2 条件将主机添加到组。

默认值： {}

keyed_groups

列表 / 元素=字典

根据变量的值将主机添加到组。

默认值： []

default_value

字符串

在 ansible-core 2.12 中添加

当主机变量的值为空字符串时的默认值。

此选项与keyed_groups[].trailing_separator互斥。

key

字符串

用于生成组的输入字典中的键

parent_group

字符串

键控组的父组

prefix

字符串

键控组名称将以此前缀开头

默认值： ""

separator

字符串

用于构建键控组名称的分隔符

默认值： "_"

trailing_separator

布尔值

在 ansible-core 2.12 中添加

将此选项设置为False 以省略在值为空字符串时主机变量后的keyed_groups[].separator。

此选项与keyed_groups[].default_value互斥。

选项

  • false

  • true ← (默认)

leading_separator

布尔值

在 ansible-core 2.11 中添加

与 keyed_groups 结合使用。

默认情况下，没有提供前缀或分隔符的键控组的名称将以下划线开头。

这是因为默认前缀为“”而默认分隔符为“_”。

如果未给出前缀，则将此选项设置为 False 以省略前导下划线（或其他分隔符）。

如果组名派生自映射，则仍然使用分隔符来连接项目。

要完全不在组名中使用分隔符，请将键控组的分隔符设置为空字符串。

选项

  • false

  • true ← (默认)

network_info_path

字符串

查询网络信息 (ansible_host) 的属性路径

默认值： "/VirtualBox/GuestInfo/Net/0/V4/IP"

plugin

字符串 / 必需

确保这是“virtualbox”插件的源文件的标记

选项

  • "virtualbox"

  • "community.general.virtualbox"

query

字典

从 VirtualBox 属性创建变量

默认值： {}

running_only

布尔值

切换显示所有虚拟机还是仅显示当前正在运行的虚拟机

选项

  • false ← (默认值)

  • true

settings_password_file

字符串

提供包含设置密码的文件（等效于 –settingspwfile）

strict

布尔值

如果yes 将无效条目设为致命错误，否则跳过并继续。

由于可以在表达式中使用事实，因此它们可能并不总是可用，并且我们默认忽略这些错误。

选项

  • false ← (默认值)

  • true

use_extra_vars

布尔值

在 ansible-core 2.11 中添加

将额外的变量合并到可用于组合的变量中（最高优先级）。

选项

  • false ← (默认值)

  • true

配置

示例

# file must be named vbox.yaml or vbox.yml
simple_config_file:
    plugin: community.general.virtualbox
    settings_password_file: /etc/virtulbox/secrets
    query:
      logged_in_users: /VirtualBox/GuestInfo/OS/LoggedInUsersList
    compose:
      ansible_connection: ('indows' in vbox_Guest_OS)|ternary('winrm', 'ssh')

# add hosts (all match with minishift vm) to the group container if any of the vms are in ansible_inventory'
plugin: community.general.virtualbox
groups:
  container: "'minis' in (inventory_hostname)"

作者

  • 未知

提示

每个条目类型的配置条目的优先级顺序由低到高。例如，列表中较低的变量将覆盖较高的变量。