diff options
Diffstat (limited to 'collections-debian-merged/ansible_collections/ngine_io/cloudstack/README.md')
| -rw-r--r-- | collections-debian-merged/ansible_collections/ngine_io/cloudstack/README.md | 80 |
1 files changed, 80 insertions, 0 deletions
diff --git a/collections-debian-merged/ansible_collections/ngine_io/cloudstack/README.md b/collections-debian-merged/ansible_collections/ngine_io/cloudstack/README.md new file mode 100644 index 00000000..4e5b3e59 --- /dev/null +++ b/collections-debian-merged/ansible_collections/ngine_io/cloudstack/README.md @@ -0,0 +1,80 @@ + + [](https://codecov.io/gh/ngine-io/ansible-collection-cloudstack) +[](LICENSE) + +# Ansible Collection for Apache CloudStack Clouds + +This collection provides a series of Ansible modules and plugins for interacting with the [Apache CloudStack](https://cloudstack.apache.org) Cloud. + +## Requirements + +- ansible version >= 2.9 + +## Installation + +To install the collection hosted in Galaxy: + +```bash +ansible-galaxy collection install ngine_io.cloudstack +``` + +To upgrade to the latest version of the collection: + +```bash +ansible-galaxy collection install ngine_io.cloudstack --force +``` + +## Usage + +### Playbooks + +To use a module from Apache CloudStack collection, please reference the full namespace, collection name, and modules name that you want to use: + +```yaml +--- +- name: Using Apache CloudStack collection + hosts: localhost + tasks: + - ngine_io.cloudstack.cs_instance: + ... +``` + +Or you can add full namepsace and collecton name in the `collections` element: + +```yaml +--- +- name: Using Apache CloudStack collection + hosts: localhost + collections: + - ngine_io.cloudstack + tasks: + - cs_instance: + ... +``` + +### Roles + +For existing Ansible roles, please also reference the full namespace, collection name, and modules name which used in tasks instead of just modules name. + +### Plugins + +To use a plugin, please reference the full namespace, collection name, and plugin name that you want to use: + +```yaml +plugin: ngine_io.cloudstack.cloudstack +``` + +## Contributing + +There are many ways in which you can participate in the project, for example: + +- Submit bugs and feature requests, and help us verify as they are checked in +- Review source code changes +- Review the documentation and make pull requests for anything from typos to new content +- If you are interested in fixing issues and contributing directly to the code base, please see the [CONTRIBUTING](CONTRIBUTING.md) document. + +## License + +GNU General Public License v3.0 + +See [COPYING](COPYING) to see the full text. |