{"id":20542439,"url":"https://github.com/mp-es/vmm_manager_ansible_collection","last_synced_at":"2026-05-09T18:38:43.302Z","repository":{"id":42649432,"uuid":"260302110","full_name":"MP-ES/vmm_manager_ansible_collection","owner":"MP-ES","description":"Ansible collection to vmm_manager application.","archived":false,"fork":false,"pushed_at":"2024-02-21T20:26:56.000Z","size":167,"stargazers_count":0,"open_issues_count":3,"forks_count":0,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-03-06T04:30:31.717Z","etag":null,"topics":["ansible","ansible-collection","hacktoberfest","vmm-manager"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/MP-ES.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-04-30T19:38:29.000Z","updated_at":"2022-01-11T18:38:23.000Z","dependencies_parsed_at":"2023-01-20T04:46:58.770Z","dependency_job_id":"671e1fe7-c7b8-4ee6-98b8-2890e8f94d1f","html_url":"https://github.com/MP-ES/vmm_manager_ansible_collection","commit_stats":null,"previous_names":[],"tags_count":12,"template":false,"template_full_name":null,"purl":"pkg:github/MP-ES/vmm_manager_ansible_collection","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MP-ES%2Fvmm_manager_ansible_collection","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MP-ES%2Fvmm_manager_ansible_collection/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MP-ES%2Fvmm_manager_ansible_collection/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MP-ES%2Fvmm_manager_ansible_collection/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/MP-ES","download_url":"https://codeload.github.com/MP-ES/vmm_manager_ansible_collection/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MP-ES%2Fvmm_manager_ansible_collection/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32831492,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-08T08:22:46.396Z","status":"online","status_checked_at":"2026-05-09T02:00:06.633Z","response_time":123,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ansible","ansible-collection","hacktoberfest","vmm-manager"],"created_at":"2024-11-16T01:32:14.650Z","updated_at":"2026-05-09T18:38:43.287Z","avatar_url":"https://github.com/MP-ES.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Ansible collection to vmm_manager\n\nAnsible collection to support [vmm_manager](https://github.com/MP-ES/vmm_manager) application on Ansible codes.\n\n[![License](https://img.shields.io/github/license/MP-ES/vmm_manager_ansible_collection.svg)](LICENSE)\n[![Integration](https://github.com/MP-ES/vmm_manager_ansible_collection/workflows/Integration/badge.svg)](https://github.com/MP-ES/vmm_manager_ansible_collection/actions?query=workflow%3AIntegration)\n[![Release](https://github.com/MP-ES/vmm_manager_ansible_collection/workflows/Release/badge.svg)](https://github.com/MP-ES/vmm_manager_ansible_collection/actions?query=workflow%3ARelease)\n\n## Installation and usage\n\n### Installing the collection from Ansible Galaxy\n\nBefore using the vmm_manager collection, you need to install it with the Ansible Galaxy CLI:\n\n```sh\nansible-galaxy collection install mpes.vmm_manager\n```\n\nYou can also include it in a `requirements.yml` file and install it via `ansible-galaxy collection install -r requirements.yml`, using the format:\n\n```yaml\n---\ncollections:\n  - name: mpes.vmm_manager\n```\n\n### Installing the vmm_manager\n\nThis collection requires the [vmm_manager](https://github.com/MP-ES/vmm_manager) application. You can install it with:\n\n```sh\npip install vmm-manager\n```\n\n### Using the dynamic inventory from this collection in your playbooks\n\nCreate an inventory file, named **\\*vmm_manager.yaml**, for example, [test_vmm_manager.yaml](test_vmm_manager.yaml) with this content:\n\n```yaml\nplugin: vmm_manager\nvmm_inventory: test_inventory.yaml # vmm_manager inventory file\ncache: True # optional\ncache_plugin: jsonfile # optional\n\n# Best practices: use environment variables to set these parameters\n# vmm_access_point: 'access_server'\n# vmm_server: 'scvmm_server'\n# vmm_username: 'username'\n# vmm_password: 'password'\n# vmm_ssh_priv_key_file: '/private/key' # optional\n# vmm_ssh_user: user # optional\n```\n\nUse the command `ansible-doc -t inventory vmm_manager` for more details.\n\n### Cache configuration (Optional)\n\nIf cache is enabled (recommend, due the response time of SCVMM queries), you have to set the cache plugin that Ansible will use (cache_plugin).\n\nIn case of **jsonfile** plugin, you have to set the cache location path, through environment variable **ANSIBLE_CACHE_PLUGIN_CONNECTION**, for example:\n\n```shell\nexport ANSIBLE_CACHE_PLUGIN_CONNECTION=.cache\n```\n\nFor more details about Ansible cache, see [Ansible cache plugins](https://docs.ansible.com/ansible/latest/plugins/cache.html).\n\n## Development\n\n### python-poetry configuration\n\n```shell\n# poetry installation\ncurl -sSL https://install.python-poetry.org | python3 -\n\n# autocomplete configuration\n# bash\npoetry completions bash \u003e\u003e ~/.bash_completion\n```\n\n### Dependencies\n\n```shell\npoetry install --no-root\n```\n\n### Configurations\n\nSet the environment variables:\n\n```shell\nexport ANSIBLE_INVENTORY_PLUGINS=plugins/inventory\n# if jsonfile cache is enabled\nexport ANSIBLE_CACHE_PLUGIN_CONNECTION=.cache\n```\n\n### Helpful developer commands\n\n```shell\n# developer shell\npoetry shell\n\n# delete poetry virtualenv\npoetry env remove python\n\n# Load envs\nexport $(cat .env | xargs)\n\n# List inventories\nansible-doc -t inventory -l\n\n# Check documentation\nansible-doc -t inventory vmm_manager\n\n# Test inventory list\nansible-inventory -i test_vmm_manager.yaml --list\n\n# Run linting\nflake8 . \u0026\u0026 isort --check-only --diff .\n\n# Fix dependencies sorting\nisort .\n```\n\n## References\n\n- [vmm_manager](https://github.com/MP-ES/vmm_manager)\n- [Developing Ansible collections](https://docs.ansible.com/ansible/latest/dev_guide/developing_collections.html#developing-collections)\n- [Developing Ansible plugins](https://docs.ansible.com/ansible/latest/dev_guide/developing_plugins.html#developing-plugins)\n- [Developing Ansible dynamic inventory](https://docs.ansible.com/ansible/latest/dev_guide/developing_inventory.html#inventory-sources)\n- [Poetry](https://python-poetry.org/)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmp-es%2Fvmm_manager_ansible_collection","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmp-es%2Fvmm_manager_ansible_collection","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmp-es%2Fvmm_manager_ansible_collection/lists"}