Consul Ansible role

Ansible role to install Consul (cluster of) server/client in a Debian environment.

• Getting Started
  • Prerequisities
  • Installing
• Usage
• Testing
• Built With
• Versioning
• Authors
• License
• Contributing

Getting Started

These instructions will get you a copy of the role for your Ansible Playbook. Once launched, it will install Consul in a Debian system.

Prerequisities

Ansible 4.x.x version installed. Inventory destination should be a Debian environment.

Rsyslog needs should be installed. It can be done with this role.

For testing purposes, Molecule with Docker as driver.

Installing

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

- src: idealista.consul_role
  version: 1.11.0
  name: consul

Install the role with ansible-galaxy command:

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

Use in a playbook:

---
- hosts: someserver
  roles:
    - consul

Usage

Look to the defaults properties file (defaults/main.yml) to see the possible configuration properties.

Logging uses rsyslog by default. It can be changed by overriding the consul_service_log_output variable. It can be changed to journal or other options seen at the StandardOutput and StandardError sections in:

• Debian 9 systemd docs
• Debian 10, 11 and 12 systemd docs

To uninstall just set:

consul_uninstall: true

Keep in mind that the following files will be removed when uninstalling:

/etc/rsyslog.d/consul.conf
/etc/logrotate.d/consul

Testing

$ pipenv sync

For more information read the pipenv docs.

Testing

$ pipenv run molecule -c molecule/default/molecule.yml test 

Built With

Versioning

For the versions available, see the tags on this repository.

Additionaly you can see what change in each version in the CHANGELOG.md file.

Authors

• Idealista - Work with - idealista

See also the list of contributors who participated in this project.

License

This project is licensed under the Apache 2.0 license - see the LICENSE file for details.

Contributing

Please read CONTRIBUTING.md for details on our code of conduct, and the process for submitting pull requests to us.