This collection provides a series of Ansible modules and plugins for interacting with the Apache CloudStack Cloud.
- ansible version >= 2.9
To install the collection hosted in Galaxy:
ansible-galaxy collection install ngine_io.cloudstack
To upgrade to the latest version of the collection:
ansible-galaxy collection install ngine_io.cloudstack --force
To use a module from Apache CloudStack collection, please reference the full namespace, collection name, and modules name that you want to use:
---
- name: Using Apache CloudStack collection
hosts: localhost
tasks:
- ngine_io.cloudstack.instance:
...
Or you can add full namepsace and collecton name in the collections
element:
---
- name: Using Apache CloudStack collection
hosts: localhost
collections:
- ngine_io.cloudstack
tasks:
- instance:
...
For existing Ansible roles, please also reference the full namespace, collection name, and modules name which used in tasks instead of just modules name.
To use a plugin, please reference the full namespace, collection name, and plugin name that you want to use:
plugin: ngine_io.cloudstack.instance
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 document.
Activate env setup of ansible core:
git clone [email protected]:ansible/ansible.git
cd ansible
source hacking/env-setup
Clone the repo:
git clone [email protected]:ngine-io/ansible-collection-cloudstack.git
cd ansible-collection-cloudstack
Run tests in docker with cloudstack simulator:
# All tests (note the trailing slash in `cloud/cs/`)
ansible-test integration --docker --color --diff -v cloud/cs/
# One test e.g. cs_instance (note no trailing slash in `cloud/cs/cs_instance`)
ansible-test integration --docker --color --diff -v cloud/cs/cs_instance
# Run tests for code you changed
ansible-test integration --docker --color --diff -v --changed cloud/cs/
GNU General Public License v3.0
See COPYING to see the full text.