Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/idealista/cassandra_role

Ansible role to install an Apache Cassandra server/cluster
https://github.com/idealista/cassandra_role

ansible ansible-role cassandra cassandra-cluster cassandra-database debian

Last synced: 28 days ago
JSON representation

Ansible role to install an Apache Cassandra server/cluster

Awesome Lists containing this project

README

        

![Logo](https://raw.githubusercontent.com/idealista/cassandra_role/master/logo.gif)

[![Build Status](https://travis-ci.org/idealista/cassandra_role.png)](https://travis-ci.org/idealista/cassandra_role)
[![Ansible Galaxy](https://img.shields.io/badge/galaxy-idealista.cassandra__role-B62682.svg)](https://galaxy.ansible.com/idealista/cassandra_role)

# Apache Cassandra Ansible role

This Ansible role installs an Apache Cassandra server in a Debian environment.

- [Getting Started](#getting-started)
- [Prerequisities](#prerequisities)
- [Installing](#installing)
- [Usage](#usage)
- [Testing](#testing)
- [Built With](#built-with)
- [Versioning](#versioning)
- [Authors](#authors)
- [License](#license)
- [Contributing](#contributing)

## Getting Started

These instructions will get you a copy of the role for your Ansible playbook. Once launched, it will install an [Apache Cassandra](https://cassandra.apache.org/) server in a Debian system.

### Prerequisities
Java 8 installed in the targets in order to boot cassandra service (maybe you want to use [our Java role for Ansible](https://github.com/idealista/java_role)).
Ansible >=2.7.0 version installed.
Pipenv 2018.11.26 and Python 3.7 also needed for testing.
Inventory destination should be a Debian environment.

For testing purposes, [Molecule](https://molecule.readthedocs.io/) with [Docker](https://www.docker.com/) as driver.

### Installing

Create or add to your roles dependency file (e.g requirements.yml):

```
- src: idealista.cassandra_role
version: 1.0.0
name: cassandra
```

Install the role with ansible-galaxy command:

```
ansible-galaxy install -p roles -r requirements.yml -f
```

Use in a playbook:

```
---
- hosts: someserver
roles:
- { role: cassandra }
```

## Usage

Look to the [defaults vars](defaults/main.yml) file to see the possible configuration vars.

## Testing

```
$ pipenv sync
$ pipenv run molecule test
```

See [molecule.yml](https://github.com/idealista/cassandra_role/blob/master/molecule/default/molecule.yml) to check possible testing platforms.

## Built With

![Ansible](https://img.shields.io/badge/ansible-2.7.7-green.svg)
![Molecule](https://img.shields.io/badge/molecule-2.19.0-green.svg)

## Versioning

For the versions available, see the [tags on this repository](https://github.com/idealista/cassandra_role/tags).

Additionaly you can see what change in each version in the [CHANGELOG.md](https://github.com/idealista/cassandra_role/blob/master/CHANGELOG.md) file.

## Authors

* **Idealista** - *Work with* - [idealista](https://github.com/idealista)

See also the list of [contributors](https://github.com/idealista/cassandra_role/contributors) who participated in this project.

## License

![Apache 2.0 License](https://img.shields.io/hexpm/l/plug.svg)

This project is licensed under the [Apache 2.0](https://www.apache.org/licenses/LICENSE-2.0) license - see the [LICENSE](LICENSE) file for details.

## Contributing

Please read [CONTRIBUTING.md](https://github.com/idealista/cassandra_role/blob/master/.github/CONTRIBUTING.md) for details on our code of conduct, and the process for submitting pull requests to us.