ansible-module-vcloud-director is a set of ansible modules that manage a VMware vCloud Director instance.
- The pyvcloud module is required.
- vCD Ansible modules require Python 3.6 or above.
- pip install --user pyvcloud
- git clone https://github.com/vmware/ansible-module-vcloud-director
- cd ansible-module-vcloud-director
Refer docs to know more about available modules's usage.
- vcd_catalog
- vcd_catalog_item
- vcd_disk
- vcd_external_network
- vcd_org
- vcd_org_vdc
- vcd_roles
- vcd_user
- vcd_vapp
- vcd_vapp_network
- vcd_vapp_vm
- vcd_vapp_vm_disk
- vcd_vapp_vm_nic
- vcd_vapp_vm_snapshot
- vcd_vdc_gateway
- vcd_vdc_network
- vcd_gateway_services
We have also written sample ansible playbooks to show usage of these ansible modules and their interaction with vCD instance. We are using ansible role concept to define playbooks in modular fashion for these modules. Please refer roles and main.yml to see usage.
Following is the approx version matrix which are tested and supported through vCD ansible modules,
| vCD Version | API Versions |
|---|---|
| vCD 9.0 | 29.0 |
| vCD 9.1 | 30.0 |
| vCD 9.5 | 31.0 |
| vCD 9.7 | 32.0 |
| vCD 10.0 | 33.0 |
| vCD 10.1 | 34.0 |
Note - Testing is still in progress for new releases of vCD and Pyvcloud.
The ansible-module-vcloud-director project team welcomes contributions from the community. Before you start working with ansible-module-vcloud-director, please read our Developer Certificate of Origin. All contributions to this repository must be signed as described on that page. Your signature certifies that you wrote the patch or have the right to pass it on as an open-source patch. For more detailed information, refer to CONTRIBUTING.md.