1. 引言
在自动化运维和部署 VMware 虚拟化环境时，经常需要操作 OVF（Open Virtualization Format）文件。VMware 提供了官方的 OVF Tool 命令行工具，用于导入、导出、验证和操作 OVF/OVA 文件。通过 Ansible 的shell或command模块调用 OVF Tool，可以实现 OVF 文件管理的自动化，将 VMware 虚拟机的部署、克隆和迁移等任务集成到 Ansible 工作流中。
本文将详细介绍如何使用 Ansible 的shell和command模块来调用 OVF Tool 执行常见任务，并提供完整的示例 Playbook。
2. 环境准备
2.1 安装 OVF Tool
首先，确保在运行 Ansible 的控制节点或目标主机上安装了 OVF Tool。
- 从 VMware 官网下载 OVF Tool 安装包。
- 根据操作系统进行安装：
- Windows: 运行安装程序。
- Linux: 解压下载的 bundle 文件并运行安装脚本。
- macOS: 使用 pkg 安装包。
- 验证安装：在终端中运行
ovftool --version，应显示版本信息。
2.2 Ansible 环境
确保 Ansible 已安装并配置好目标主机的连接（SSH 或 WinRM）。
3. Ansible 模块选择：shell vs command
Ansible 提供了两个用于执行命令的模块：shell和command。在调用 OVF Tool 时，需要根据需求选择：
| 模块 | 特点 | 适用场景 |
|---|---|---|
shell | 通过系统的 shell（如 /bin/bash）执行命令，支持管道、重定向、环境变量等 shell 特性。 | 需要管道、重定向、变量扩展或执行复杂 shell 脚本时。 |
command | 直接执行命令，不通过 shell。更安全，但无法使用 shell 特性。 | 执行简单的 OVF Tool 命令，无需管道或重定向时。 |
建议：大多数 OVF Tool 命令可以直接使用command模块。如果需要处理命令输出或使用管道，则使用shell模块。
4. 使用 command 模块调用 OVF Tool
command模块适用于简单的 OVF Tool 命令调用。
4.1 基本语法
- name: 使用 command 模块调用 OVF Tool command: ovftool [参数] 源 目标 register: ovftool_result4.2 示例：验证 OVF 文件
- name: 验证 OVF 文件 command: ovftool --verifyOnly /path/to/vm.ovf register: verify_result ignore_errors: yes name: 显示验证结果 debug: msg: "{{ verify_result.stdout }}"4.3 示例：导出 OVA 文件
- name: 导出虚拟机为 OVA command: ovftool vi://username:password@vcenter-host/Datacenter/vm/my-vm /backup/my-vm.ova register: export_result name: 检查导出是否成功 debug: msg: "OVA 导出完成，文件位于 /backup/my-vm.ova"5. 使用 shell 模块调用 OVF Tool
当需要管道、重定向或复杂命令组合时，使用shell模块。
5.1 基本语法
- name: 使用 shell 模块调用 OVF Tool shell: ovftool [参数] 源 目标 2>&1 | tee /var/log/ovftool.log register: ovftool_result5.2 示例：导入 OVF 并捕获日志
- name: 导入 OVF 文件并记录日志 shell: | ovftool \ --name=NewVM \ --datastore=datastore1 \ --network="VM Network" \ /ova-files/myvm.ova \ vi://administrator@vsphere.local:password@vcenter-host/Datacenter/host/Cluster 2>&1 | tee /tmp/ovftool_import.log args: executable: /bin/bash register: import_result name: 显示导入日志尾部 debug: msg: "{{ import_result.stdout_lines[-5:] }}"5.3 示例：使用管道处理输出
- name: 检查 OVF 文件信息并提取磁盘大小 shell: ovftool /path/to/vm.ovf | grep "Disk" | head -1 register: disk_info name: 显示磁盘信息 debug: msg: "{{ disk_info.stdout }}"6. 完整 Playbook 示例
以下是一个完整的 Ansible Playbook，演示如何使用 OVF Tool 从 vCenter 导出虚拟机并导入到另一个 vCenter。
--- - name: 使用 OVF Tool 迁移虚拟机 hosts: localhost gather_facts: no vars: source_vcenter: "vcenter-source.example.com" source_user: "administrator@vsphere.local" source_password: "{{ vault_source_password }}" source_vm_path: "/Datacenter/vm/Production/AppServer" target_vcenter: "vcenter-target.example.com" target_user: "administrator@vsphere.local" target_password: "{{ vault_target_password }}" target_folder: "/Datacenter/vm/Development" ovf_tool_path: "/usr/local/bin/ovftool" temp_ova: "/tmp/AppServer_migration.ova" tasks: name: 从源 vCenter 导出虚拟机为 OVA command: "{{ ovf_tool_path }} --noSSLVerify vi://{{ source_user }}:{{ source_password }}@{{ source_vcenter }}{{ source_vm_path }} {{ temp_ova }}" register: export_task ignore_errors: yes name: 检查导出结果 debug: msg: "{{ export_task.stdout }}" when: export_task.failed name: 将 OVA 导入到目标 vCenter command: "{{ ovf_tool_path }} --noSSLVerify --name=AppServer_Dev {{ temp_ova }} vi://{{ target_user }}:{{ target_password }}@{{ target_vcenter }}{{ target_folder }}" register: import_task when: not export_task.failed name: 清理临时 OVA 文件 file: path: "{{ temp_ova }}" state: absent when: not export_task.failed name: 输出迁移摘要 debug: msg: | 虚拟机迁移完成。 源: {{ source_vcenter }}{{ source_vm_path }} 目标: {{ target_vcenter }}{{ target_folder }} when: not export_task.failed and not import_task.failed</code></pre> 最佳实践与注意事项 安全性：使用 Ansible Vault 加密 vCenter 密码等敏感信息。 错误处理：使用 ignore_errors: yes 和 failed_when 条件来处理 OVF Tool 可能返回的非零退出码。 超时设置：OVF 导入/导出可能耗时较长，通过 timeout 参数增加任务超时时间。 日志记录：使用 shell 模块的重定向功能将详细输出保存到日志文件，便于排查问题。 幂等性：OVF Tool 操作通常不是幂等的，重复执行可能导致重复创建虚拟机。建议在 Playbook 中加入检查目标是否已存在的逻辑。 总结 通过 Ansible 的 shell 和 command 模块调用 OVF Tool，可以高效地将 VMware 虚拟机的 OVF/OVA 文件管理任务自动化。根据具体需求选择合适的模块：简单命令用 command，需要管道、重定向或复杂 shell 功能时用 shell。结合 Ansible 的变量、循环、条件判断和错误处理机制，可以构建出健壮的虚拟机部署和迁移工作流。
