An open API service indexing awesome lists of open source software.

https://github.com/ngine-io/ansible-collection-exoscale

Exoscale Ansible Collection
https://github.com/ngine-io/ansible-collection-exoscale

ansible ansible-collection ansible-collections exoscale

Last synced: about 2 months ago
JSON representation

Exoscale Ansible Collection

Awesome Lists containing this project

README

        

![Collection integration](https://github.com/ngine-io/ansible-collection-exoscale/workflows/Sanity/badge.svg)
[![License](https://img.shields.io/badge/license-GPL%20v3.0-brightgreen.svg)](LICENSE)

:warning: **DEPRECATED:** Exoscale will no longer support the Cloudstack API after May 1, 2024.
[See Announcement](https://changelog.exoscale.com/en/deprecation-api-v1-as-of-may-1st-2024-uVYHUVZ3).

# Ansible Collection for exoscale Cloud

This collection provides a series of Ansible modules and plugins for interacting with the [exoscale](https://www.exoscale.com) Cloud.

## Requirements

- ansible version >= 2.9

## Installation

To install the collection hosted in Galaxy:

```bash
ansible-galaxy collection install ngine_io.exoscale
```

To upgrade to the latest version of the collection:

```bash
ansible-galaxy collection install ngine_io.exoscale --force
```

## Usage

### Playbooks

To use a module from exoscale collection, please reference the full namespace, collection name, and modules name that you want to use:

```yaml
---
- name: Using exoscale collection
hosts: localhost
tasks:
- ngine_io.exoscale.:
...
```

Or you can add full namepsace and collecton name in the `collections` element:

```yaml
---
- name: Using exoscale collection
hosts: localhost
collections:
- ngine_io.exoscale
tasks:
- :
...
```

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

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