ansible.builtin.vmware_vm_inventory (v2.8.18) — inventory

Install Ansible via pip

Install with pip install ansible==2.8.18

Description

Get virtual machines as inventory hosts from VMware environment.

Uses any file which ends with vmware.yml or vmware.yaml as a YAML configuration file.

The inventory_hostname is always the 'Name' and UUID of the virtual machine. UUID is added as VMware allows virtual machines with the same name.

Requirements

• Python >= 2.7
• PyVmomi
• requests >= 2.3
• vSphere Automation SDK - For tag feature
• vCloud Suite SDK - For tag feature

Inputs

    
port:
    default: 443
    description: Port number used to connect to vCenter or ESXi Server.
    env:
    - name: VMWARE_PORT

cache:
    default: false
    description:
    - Toggle to enable/disable the caching of the inventory's source data, requires a
      cache plugin setup to work.
    env:
    - name: ANSIBLE_INVENTORY_CACHE
    ini:
    - key: cache
      section: inventory
    type: bool

hostname:
    description: Name of vCenter or ESXi server.
    env:
    - name: VMWARE_SERVER
    required: true

password:
    description: Password of vSphere admin user.
    env:
    - name: VMWARE_PASSWORD
    required: true

username:
    description: Name of vSphere admin user.
    env:
    - name: VMWARE_USERNAME
    required: true

with_tags:
    default: false
    description:
    - Include tags and associated virtual machines.
    - Requires 'vSphere Automation SDK' and 'vCloud Suite SDK' libraries to be installed
      on the given controller machine.
    - Please refer following URLs for installation steps
    - https://code.vmware.com/web/sdk/65/vsphere-automation-python
    - https://code.vmware.com/web/sdk/60/vcloudsuite-python
    type: boolean

cache_plugin:
    default: memory
    description:
    - Cache plugin to use for the inventory's source data.
    env:
    - name: ANSIBLE_CACHE_PLUGIN
    - name: ANSIBLE_INVENTORY_CACHE_PLUGIN
    ini:
    - key: fact_caching
      section: defaults
    - key: cache_plugin
      section: inventory
    type: str

cache_prefix:
    default: ansible_inventory_
    description:
    - Prefix to use for cache plugin files/tables
    env:
    - name: ANSIBLE_CACHE_PLUGIN_PREFIX
    - name: ANSIBLE_INVENTORY_CACHE_PLUGIN_PREFIX
    ini:
    - key: fact_caching_prefix
      section: defaults
    - key: cache_prefix
      section: inventory

cache_timeout:
    default: 3600
    description:
    - Cache duration in seconds
    env:
    - name: ANSIBLE_CACHE_PLUGIN_TIMEOUT
    - name: ANSIBLE_INVENTORY_CACHE_TIMEOUT
    ini:
    - key: fact_caching_timeout
      section: defaults
    - key: cache_timeout
      section: inventory
    type: int

validate_certs:
    default: true
    description:
    - Allows connection when SSL certificates are not valid. Set to C(false) when certificates
      are not trusted.
    type: boolean

cache_connection:
    description:
    - Cache connection data or path, read cache plugin documentation for specifics.
    env:
    - name: ANSIBLE_CACHE_PLUGIN_CONNECTION
    - name: ANSIBLE_INVENTORY_CACHE_CONNECTION
    ini:
    - key: fact_caching_connection
      section: defaults
    - key: cache_connection
      section: inventory
    type: str