Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ngine-io/ansible-collection-cloudstack
CloudStack Ansible Collections
https://github.com/ngine-io/ansible-collection-cloudstack
ansible ansible-collection ansible-collections cloudstack
Last synced: 2 months ago
JSON representation
CloudStack Ansible Collections
- Host: GitHub
- URL: https://github.com/ngine-io/ansible-collection-cloudstack
- Owner: ngine-io
- License: gpl-3.0
- Created: 2020-01-23T15:31:29.000Z (almost 5 years ago)
- Default Branch: master
- Last Pushed: 2024-08-26T15:17:53.000Z (5 months ago)
- Last Synced: 2024-08-27T15:28:58.956Z (5 months ago)
- Topics: ansible, ansible-collection, ansible-collections, cloudstack
- Language: Python
- Homepage: https://galaxy.ansible.com/ngine_io/cloudstack
- Size: 443 KB
- Stars: 21
- Watchers: 6
- Forks: 28
- Open Issues: 23
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.rst
- Contributing: CONTRIBUTING.md
- License: COPYING
Awesome Lists containing this project
README
[](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.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:
- 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.instance
```
## 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.
## Run tests
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/
```
## License
GNU General Public License v3.0
See [COPYING](COPYING) to see the full text.