cloud.vmware_ops roles/playbooks for VMware

This repository hosts the cloud.vmware_ops Ansible Collection.

The collection includes a variety of Ansible roles and playbooks to help automate the management of VMware.

Ansible version compatibility

This collection has been tested against following Ansible versions: >=2.14.0.

Python version compatibility

This collection requires Python 3.9 or greater.

Included content

Click on the name of a role to view that content's documentation:

Roles

Name	Description
cloud.vmware_ops.provision_vcenter	A role to provison Vcenter on ESXi host.
cloud.vmware_ops.provision_vm	A role to create/manage virtual machines on VMware.
cloud.vmware_ops.system_settings	A role to manage system settings on VMware.
cloud.vmware_ops.cluster_settings	A role to define cluster settings in vCenter.
cloud.vmware_ops.content_library	A role to manage VMWare content libaries.
cloud.vmware_ops.deploy_ovf	A role to deploy a VM from an OVF file.
cloud.vmware_ops.esxi_maintenance_mode	Either put an ESXI host in maintenance mode or take the host out of maintenance mode.
cloud.vmware_ops.export_vm_as_ovf	A role to export a VM from VCenter or ESXi as an OVF.
cloud.vmware_ops.info	A role that gather information from vCenter.
cloud.vmware_ops.manage_folder	A role to create, delete, or update a folder or folder tree in VCenter.
cloud.vmware_ops.provision_virtual_esxi	A role to provision one or more virtual ESXi hosts.
cloud.vmware_ops.snapshot_management	A role to manages virtual machines snapshots in vCenter.
cloud.vmware_ops.vcenter_host_connection	A role to add, remove, connect, disconnect, or reconnect an ESXi host from a VCenter.

Playbooks

Name	Description
cloud.vmware_ops.provision_vcenter	A playbook to provison Vcenter on ESXi host.
cloud.vmware_ops.system_settings	A playbook to manage system settings on VMware.
cloud.vmware_ops.cluster_settings	A set of playbook to manage cluster settings.
cloud.vmware_ops.esxi_management	A set of playbooks to manage esxi in a cluster.
cloud.vmware_ops.provision_vcenter	A playbook to provision vCenter applicationm on ESXi host.
cloud.vmware_ops.provision_vm	A set of playbooks to manage provisioning VM.
cloud.vmware_ops.snapshot_management	A set of playbooks to manage VM snapshots on vCenter.
cloud.vmware_ops.export_vm_as_ovf	A playbook to export vm as OVF file.
cloud.vmware_ops.info	A playbook to gather information from vCenter.
cloud.vmware_ops.manage_content_library	A playbook to manage content libraries in vCenter.
cloud.vmware_ops.manage_folder	A playbook to manage folders in vCenter.

Installation and Usage

Requirements

The community.vmware (>=4.4.0), vmware.vmware_rest, vmware.vmware, community.general and ansible.posix collections MUST be installed in order for this collection to work.

Installation

To consume this Validated Content from Automation Hub, please ensure that you add the following lines to your ansible.cfg file.

[galaxy]
server_list = automation_hub

[galaxy_server.automation_hub]
url=https://cloud.redhat.com/api/automation-hub/
auth_url=https://sso.redhat.com/auth/realms/redhat-external/protocol/openid-connect/token
token=<SuperSecretToken>

The token can be obtained from the Automation Hub Web UI.

Once the above steps are done, you can run the following command to install the collection.

ansible-galaxy collection install cloud.vmware_ops

Using this collection

Once installed, you can reference the cloud.vmware_ops collection content by its fully qualified collection name (FQCN), for example:

  - hosts: localhost
    roles:
      - role: cloud.vmware_ops.system_settings

Contributing to this collection

We welcome community contributions to this collection. If you find problems, please open an issue or create a PR against this collection repository.

Testing and Development

The project uses ansible-lint and black. Assuming this repository is checked out in the proper structure, e.g. collections_root/ansible_collections/cloud/vmware_ops/, run:

  tox -e linters

Sanity and unit tests are run as normal:

  ansible-test sanity

Integration Tests

Currently integration tests are using vcsim, which is VMware SOAP API simulator. So no external infrastructure is needed. Vcsim is executed in a podman container before the integration test is executed.

In order to run the integration tests, please follow:

make integration

License

GNU General Public License v3.0 or later

See LICENSE to see the full text.

cloud.vmware_ops.info make sure directory exists requires community.general

This is the error->

➜  vmware-demos git:(main) ansible-navigator run vmware_visbility.yml --mode stdout
[WARNING]: provided hosts list is empty, only localhost is available. Note that the implicit localhost does not match 'all'

PLAY [VMware visbility] *******************************************************************************************************************************************************

TASK [Set VCenter parameters] *************************************************************************************************************************************************
ok: [localhost]

TASK [cloud.vmware_ops.info : License info] ***********************************************************************************************************************************
included: /usr/share/ansible/collections/ansible_collections/cloud/vmware_ops/roles/info/tasks/license_info.yml for localhost

TASK [cloud.vmware_ops.info : Fetch the license information] ******************************************************************************************************************
ok: [localhost]

TASK [cloud.vmware_ops.info : Make sure directory exists] *********************************************************************************************************************
fatal: [localhost]: FAILED! => {"msg": "An unhandled exception occurred while templating '/tmp/license-{{ lookup('community.general.random_string', special=false) }}'. Error was a <class 'ansible.errors.AnsibleError'>, original message: lookup plugin (community.general.random_string) not found"}

The playbook is super simple:

---
- name: VMware visbility
  hosts: localhost
  gather_facts: false
  tasks:
    - name: Set VCenter parameters
      ansible.builtin.include_vars: login_info.yml

    - name: Use info role
      ansible.builtin.import_role:
        name: cloud.vmware_ops.info
      vars:
        info_license: true
        info_storage: true
        info_appliance: true
        info_guest: true
        info_hostname: "{{ vcenter_hostname }}"
        info_username: "{{ vcenter_username }}"
        info_password: "{{ vcenter_password }}"
        info_validate_certs: false

redhat-cop / cloud.vmware_ops Goto Github PK

cloud.vmware_ops's Introduction

cloud.vmware_ops roles/playbooks for VMware

Ansible version compatibility

Python version compatibility

Included content

Roles

Playbooks

Installation and Usage

Requirements

Installation

Using this collection

See Also

Contributing to this collection

Testing and Development

Integration Tests

License

cloud.vmware_ops's People

Contributors

Stargazers

Watchers

Forkers

cloud.vmware_ops's Issues

Recommend Projects

Recommend Topics

Recommend Org