community.libvirt.libvirt_qemu 连接 - 在 libvirt/qemu 虚拟机上运行任务

注意

此连接插件是 community.libvirt 集合（版本 1.3.0）的一部分。

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

要安装它，请使用：ansible-galaxy collection install community.libvirt。您需要进一步的要求才能使用此连接插件，请参阅 要求 了解详细信息。

要在 playbook 中使用它，请指定：community.libvirt.libvirt_qemu。

community.libvirt 2.10.0 中的新增功能

概要

  • 使用 qemu agent API 运行命令或将文件放入/获取到 libvirt/qemu 虚拟机。

要求

本地控制器节点（执行此连接）需要以下要求。

  • python >= 2.6

  • libvirt python 绑定

参数

参数

注释

executable

字符串

在容器内执行时要使用的 shell。

对于 Windows VM，请将其设置为“cmd”或“powershell”。

默认值： "/bin/sh"

配置

  • 变量：ansible_shell_type

remote_addr

字符串

虚拟机名称。

默认值： "inventory_hostname"

配置

  • 变量：ansible_host

  • 变量：inventory_hostname

virt_uri

字符串

用于连接以访问虚拟机的 Libvirt URI。

默认值： "qemu:///system"

配置

  • 变量：ansible_libvirt_uri

注意事项

注意

  • 目前在 VM 中将 selinux 设置为 enforcing 时不起作用。

  • 需要在 VM 中安装 qemu-agent。

  • 需要访问 qemu-ga 命令 guest-exec、guest-exec-status、guest-file-close、guest-file-open、guest-file-read、guest-file-write。

作者

  • Jesse Pretorius (@odyssey4me)

提示

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