From a453ac31f3428614cceb99027f8efbdb9258a40b Mon Sep 17 00:00:00 2001 From: Daniel Baumann Date: Tue, 14 May 2024 22:03:01 +0200 Subject: Adding upstream version 2.10.7+merged+base+2.10.8+dfsg. Signed-off-by: Daniel Baumann --- .../community/libvirt/README.md | 115 +++++++++++++++++++++ 1 file changed, 115 insertions(+) create mode 100644 collections-debian-merged/ansible_collections/community/libvirt/README.md (limited to 'collections-debian-merged/ansible_collections/community/libvirt/README.md') diff --git a/collections-debian-merged/ansible_collections/community/libvirt/README.md b/collections-debian-merged/ansible_collections/community/libvirt/README.md new file mode 100644 index 00000000..86ddaf11 --- /dev/null +++ b/collections-debian-merged/ansible_collections/community/libvirt/README.md @@ -0,0 +1,115 @@ +# community.libvirt Collection + + + +This repo hosts the `community.libvirt` Ansible Collection. + +The collection includes the libvirt modules and plugins supported by Ansible +libvirt community to help the management of virtual machines and/or containers +via the [libvirt][1] API. + +[1]: https://libvirt.org/ + +## Tested with Ansible + +TBD + +## External requirements + +TBD + +### Supported connections + +TBD + +## Included content + +TBD + +## Using this collection + + +Before using the libvirt community collection, you need to install the +collection with the `ansible-galaxy` CLI: + +```bash +ansible-galaxy collection install community.libvirt +``` + +Alternatively, you can also include it in a `requirements.yml` file and +install it via `ansible-galaxy collection install -r requirements.yml` using +the format: + +```yaml +collections: +- name: community.libvirt +``` + +For more information regarding using collections with Ansible, see the Ansible +[user guide][3]. + +[3]: https://docs.ansible.com/ansible/latest/user_guide/collections_using.html + +## Contributing to this collection + + +While this community is still developing its guidelines, the aspiration is to +follow the following general guidelines: + +- Changes should include tests and documentation where appropriate. +- Changes will be lint tested using standard python lint tests. +- No changes which do not pass CI testing will be approved/merged. +- The collection plugins must provide the same coverage of python support as + the versions of Ansible supported. +- The versions of Ansible supported by the collection must be the same as + those in developed, or those maintained, as shown in the Ansible [Release + and Maintenance][4] documentation. + +[4]: https://docs.ansible.com/ansible/latest/reference_appendices/release_and_maintenance.html + +As a fallback, the [Ansible Community Guide][5] remains our community +reference set of guidelines. + +[5]: https://docs.ansible.com/ansible/latest/community/index.html + +### Local Testing + +If you want to develop new content for this collection or improve what is +already here, the easiest way to work on the collection is to clone it into +one of the configured [COLLECTIONS_PATHS][2] and work on it there. + +[2]: https://docs.ansible.com/ansible/latest/reference_appendices/config.html#collections-paths + +### Testing with `ansible-test` + +TBD + +### Publishing New Version + +TBD + +## More Information + + +### Communication + +This is a small collection with a small number of contributors. As such, there +is no formal Ansible Working Group. To communicate with the maintainers, please +make contact via one of the following methods: + +- IRC on Freenode in #ansible-community +- [Issues](https://github.com/ansible-collections/libvirt/issues) on Github + +### Reference + +- [Ansible Collection overview](https://github.com/ansible-collections/overview) +- [Ansible User guide](https://docs.ansible.com/ansible/latest/user_guide/index.html) +- [Ansible Developer guide](https://docs.ansible.com/ansible/latest/dev_guide/index.html) +- [Ansible Community code of conduct](https://docs.ansible.com/ansible/latest/community/code_of_conduct.html) + +## License + + +GNU General Public License v3.0 or later. + +See [LICENCE](https://www.gnu.org/licenses/gpl-3.0.txt) to see the full text. -- cgit v1.2.3