[WIP] vcenter_object_move: add module to move vCenter inventory object

[sbaerlocher]

SUMMARY

This commit introduces the new module vcenter_object_move which allows moving vCenter inventory objects (e.g., Virtual Machines, Hosts, Datastores, Networks) into a specified destination folder. The module ensures idempotence by checking if the object is already located in the target folder and supports Ansible check mode for dry-run operations. This feature simplifies inventory management in vCenter environments and aids in maintaining an organized structure.

ISSUE TYPE

• New Module Pull Request

COMPONENT NAME

vcenter_object_move

ADDITIONAL INFORMATION

The module leverages pyVmomi to interact with the vCenter API and integrates with the existing utilities from the community.vmware collection. It performs the following steps:

1. Validates input parameters (datacenter, object_name, object_type, destination_folder).
2. Locates the vCenter datacenter and the specified inventory object.
3. Traverses the folder structure to locate the destination folder.
4. Moves the object if it is not already in the target folder; if it is, no action is taken.
5. Supports check mode to simulate the move without applying changes.

Example command output:

{
    "changed": true,
    "msg": "Object 'MyVM' was successfully moved to folder 'NewFolder/SubFolder'."
}

[softwarefactory-project-zuul]

Build failed.
https://ansible.softwarefactory-project.io/zuul/buildset/8f897e0850fc4296b1aeec831ff4ba51

✔️ ansible-tox-linters SUCCESS in 5m 14s
✔️ build-ansible-collection SUCCESS in 7m 44s
❌ ansible-test-cloud-integration-vcenter7_only-stable218 FAILURE in 14m 27s
⚠️ ansible-test-cloud-integration-vcenter7_2esxi-stable218 CANCELED
⚠️ ansible-test-cloud-integration-vcenter7_1esxi-stable218_1_of_2 CANCELED
⚠️ ansible-test-cloud-integration-vcenter7_1esxi-stable218_2_of_2 CANCELED
✔️ ansible-galaxy-importer SUCCESS in 3m 08s

[softwarefactory-project-zuul]

Build failed.
https://ansible.softwarefactory-project.io/zuul/buildset/629aa070d3164b78ba494a79e411df6a

✔️ ansible-tox-linters SUCCESS in 4m 46s
✔️ build-ansible-collection SUCCESS in 7m 36s
❌ ansible-test-cloud-integration-vcenter7_only-stable218 FAILURE in 8m 05s
⚠️ ansible-test-cloud-integration-vcenter7_2esxi-stable218 CANCELED
⚠️ ansible-test-cloud-integration-vcenter7_1esxi-stable218_1_of_2 CANCELED
⚠️ ansible-test-cloud-integration-vcenter7_1esxi-stable218_2_of_2 CANCELED
✔️ ansible-galaxy-importer SUCCESS in 4m 51s

[softwarefactory-project-zuul]

Build failed.
https://ansible.softwarefactory-project.io/zuul/buildset/c2b76435d74848de9878bf3d1ff594d6

✔️ ansible-tox-linters SUCCESS in 4m 43s
✔️ build-ansible-collection SUCCESS in 7m 21s
❌ ansible-test-cloud-integration-vcenter7_only-stable218 FAILURE in 13m 06s
⚠️ ansible-test-cloud-integration-vcenter7_2esxi-stable218 CANCELED
⚠️ ansible-test-cloud-integration-vcenter7_1esxi-stable218_1_of_2 CANCELED
⚠️ ansible-test-cloud-integration-vcenter7_1esxi-stable218_2_of_2 CANCELED
✔️ ansible-galaxy-importer SUCCESS in 5m 19s

[softwarefactory-project-zuul]

Build failed.
https://ansible.softwarefactory-project.io/zuul/buildset/308a5b51f60c4baf8b6483f78ede1aa8

✔️ ansible-tox-linters SUCCESS in 5m 40s
✔️ build-ansible-collection SUCCESS in 7m 22s
❌ ansible-test-cloud-integration-vcenter7_only-stable218 FAILURE in 13m 22s
⚠️ ansible-test-cloud-integration-vcenter7_2esxi-stable218 CANCELED
⚠️ ansible-test-cloud-integration-vcenter7_1esxi-stable218_1_of_2 CANCELED
⚠️ ansible-test-cloud-integration-vcenter7_1esxi-stable218_2_of_2 CANCELED
✔️ ansible-galaxy-importer SUCCESS in 4m 52s

[softwarefactory-project-zuul]

Build failed.
https://ansible.softwarefactory-project.io/zuul/buildset/fb44d59201ec4279a4a9d90e4e010235

✔️ ansible-tox-linters SUCCESS in 5m 06s
✔️ build-ansible-collection SUCCESS in 7m 25s
⚠️ ansible-test-cloud-integration-vcenter7_only-stable218 CANCELED
⚠️ ansible-test-cloud-integration-vcenter7_2esxi-stable218 CANCELED
⚠️ ansible-test-cloud-integration-vcenter7_1esxi-stable218_1_of_2 CANCELED
❌ ansible-test-cloud-integration-vcenter7_1esxi-stable218_2_of_2 FAILURE in 10m 53s
✔️ ansible-galaxy-importer SUCCESS in 5m 14s

[softwarefactory-project-zuul]

Build failed.
https://ansible.softwarefactory-project.io/zuul/buildset/b83b5a56e18c4e85b084ebda0554572d

✔️ ansible-tox-linters SUCCESS in 5m 04s
✔️ build-ansible-collection SUCCESS in 7m 25s
❌ ansible-test-cloud-integration-vcenter7_only-stable218 FAILURE in 7m 40s
⚠️ ansible-test-cloud-integration-vcenter7_2esxi-stable218 CANCELED
⚠️ ansible-test-cloud-integration-vcenter7_1esxi-stable218_1_of_2 CANCELED
⚠️ ansible-test-cloud-integration-vcenter7_1esxi-stable218_2_of_2 CANCELED
✔️ ansible-galaxy-importer SUCCESS in 4m 00s

[softwarefactory-project-zuul]

Build failed.
https://ansible.softwarefactory-project.io/zuul/buildset/173dd5fb7e344bc4ae471fe3aed4fa4c

✔️ ansible-tox-linters SUCCESS in 4m 50s
✔️ build-ansible-collection SUCCESS in 7m 33s
⚠️ ansible-test-cloud-integration-vcenter7_only-stable218 CANCELED
⚠️ ansible-test-cloud-integration-vcenter7_2esxi-stable218 CANCELED
❌ ansible-test-cloud-integration-vcenter7_1esxi-stable218_1_of_2 FAILURE in 8m 02s
⚠️ ansible-test-cloud-integration-vcenter7_1esxi-stable218_2_of_2 CANCELED
✔️ ansible-galaxy-importer SUCCESS in 4m 36s

[softwarefactory-project-zuul]

Build failed.
https://ansible.softwarefactory-project.io/zuul/buildset/300458c3e7654279b79f4411cd418942

✔️ ansible-tox-linters SUCCESS in 5m 14s
✔️ build-ansible-collection SUCCESS in 7m 21s
⚠️ ansible-test-cloud-integration-vcenter7_only-stable218 CANCELED
⚠️ ansible-test-cloud-integration-vcenter7_2esxi-stable218 CANCELED
❌ ansible-test-cloud-integration-vcenter7_1esxi-stable218_1_of_2 FAILURE in 11m 25s
⚠️ ansible-test-cloud-integration-vcenter7_1esxi-stable218_2_of_2 CANCELED
✔️ ansible-galaxy-importer SUCCESS in 4m 35s

[softwarefactory-project-zuul]

Build failed.
https://ansible.softwarefactory-project.io/zuul/buildset/3579929230fc48c694059d9346598471

✔️ ansible-tox-linters SUCCESS in 4m 41s
✔️ build-ansible-collection SUCCESS in 7m 29s
⚠️ ansible-test-cloud-integration-vcenter7_only-stable218 CANCELED
⚠️ ansible-test-cloud-integration-vcenter7_2esxi-stable218 CANCELED
❌ ansible-test-cloud-integration-vcenter7_1esxi-stable218_1_of_2 FAILURE in 16m 03s
⚠️ ansible-test-cloud-integration-vcenter7_1esxi-stable218_2_of_2 CANCELED
✔️ ansible-galaxy-importer SUCCESS in 5m 12s

[softwarefactory-project-zuul]

Build failed.
https://ansible.softwarefactory-project.io/zuul/buildset/4ab30e33bdc3421e8bfbd4b95221f716

✔️ ansible-tox-linters SUCCESS in 4m 46s
✔️ build-ansible-collection SUCCESS in 7m 22s
⚠️ ansible-test-cloud-integration-vcenter7_only-stable218 CANCELED
⚠️ ansible-test-cloud-integration-vcenter7_2esxi-stable218 CANCELED
❌ ansible-test-cloud-integration-vcenter7_1esxi-stable218_1_of_2 FAILURE in 9m 20s
⚠️ ansible-test-cloud-integration-vcenter7_1esxi-stable218_2_of_2 CANCELED
✔️ ansible-galaxy-importer SUCCESS in 4m 37s

[softwarefactory-project-zuul]

Build failed.
https://ansible.softwarefactory-project.io/zuul/buildset/f880374c75fb44f2b23913ee61784ff5

✔️ ansible-tox-linters SUCCESS in 5m 29s
✔️ build-ansible-collection SUCCESS in 7m 22s
⚠️ ansible-test-cloud-integration-vcenter7_only-stable218 CANCELED
⚠️ ansible-test-cloud-integration-vcenter7_2esxi-stable218 CANCELED
⚠️ ansible-test-cloud-integration-vcenter7_1esxi-stable218_1_of_2 CANCELED
❌ ansible-test-cloud-integration-vcenter7_1esxi-stable218_2_of_2 FAILURE in 17m 25s
✔️ ansible-galaxy-importer SUCCESS in 4m 18s