Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

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

Vultr Ansible Collections
https://github.com/ngine-io/ansible-collection-vultr

ansible ansible-collection ansible-collections vultr

Last synced: 2 months ago
JSON representation

Vultr Ansible Collections

Host: GitHub
URL: https://github.com/ngine-io/ansible-collection-vultr
Owner: ngine-io
License: gpl-3.0
Created: 2020-01-23T14:43:22.000Z (almost 5 years ago)
Default Branch: master
Last Pushed: 2023-01-23T21:40:26.000Z (almost 2 years ago)
Last Synced: 2023-03-04T00:19:25.788Z (almost 2 years ago)
Topics: ansible, ansible-collection, ansible-collections, vultr
Language: Python
Homepage: https://galaxy.ansible.com/ngine_io/vultr
Size: 132 KB
Stars: 15
Watchers: 4
Forks: 11
Open Issues: 5
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.rst
- Contributing: CONTRIBUTING.md
- License: COPYING

Awesome Lists containing this project

README

# !!! NOTE !!!

This collection is in maintance mode: bug fixes only. For new features, please visit https://github.com/vultr/ansible-collection-vultr/.

----

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

# Ansible Collection for Vultr Cloud

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

## Requirements

- ansible version >= 2.9

## Installation

To install the collection hosted in Galaxy:

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

To upgrade to the latest version of the collection:

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

## Usage

### Playbooks

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

```yaml
---
- name: Using Vultr collection
hosts: localhost
tasks:
- ngine_io.vultr.vultr_server:
...
```

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

```yaml
---
- name: Using Vultr collection
hosts: localhost
collections:
- ngine_io.vultr
tasks:
- vultr_server:
...
```

### 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 pluign, please reference the full namespace, collection name, and plugins name that you want to use:

```yaml
plugin: ngine_io.vultr.vultr
```

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