ngine-io

ansible-collection-cloudstack

Python

CloudStack Ansible Collections

Last updated Jun 23, 2026

Stars

Forks

Issues

Stars/day

Attention Score

View on GitHub ↗ Open in github.dev

Topics

#ansible #ansible-collection #ansible-collections #cloudstack

Language breakdown

Python 99.9%

Shell 0.1%

Jinja 0.1%

▸ Files click to expand

README

Ansible Collection for Apache CloudStack Clouds

This collection provides a series of Ansible modules and plugins for interacting with the Apache CloudStack Cloud.

Requirements

ansible version >= 2.9

Installation

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

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:

---
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:
      ...

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:

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 document.

Run tests

Activate env setup of ansible core:

git clone git@github.com:ansible/ansible.git
cd ansible
source hacking/env-setup

Clone the repo:

git clone git@github.com: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. csinstance (note no trailing slash in cloud/cs/csinstance)
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 to see the full text.

🔗 More in this category