/prometheus_server_role

Ansible role to install a Prometheus server

Primary LanguageYAMLApache License 2.0Apache-2.0

Logo

Build Status

Prometheus Server Ansible role

This ansible role installs a Prometheus server in a debian environment. The server is installed using the sources.

Getting Started

These instructions will get you a copy of the role for your ansible playbook. Once launched, it will install an Prometheus server in a Debian system.

Prerequisities

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

For testing purposes, Molecule with Docker as driver. Take a look at the Pipfile file to check the dependencies that need to be installed to successfully run this component.

Installing

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

- src: idealista.prometheus_server_role
  version: 1.10.2
  name: prometheus

Install the role with ansible-galaxy command:

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

Use in a playbook:

---
- hosts: someserver
  roles:
    - role: prometheus

Usage

Look to the defaults properties file to see the possible configuration properties.

⚠️ The Prometheus rules support templating but custom jinja delimiters are used to avoid conflicts with the Go templates used by Prometheus. Those custom delimiters are defined in the following variables and can be overrided:

prometheus_rule_templates_variable_start: "<<"
prometheus_rule_templates_variable_end: ">>"
prometheus_rule_templates_block_start: "<%"
prometheus_rule_templates_block_end: "%>"

Testing

pipenv shell
pipenv sync
molecule test

See molecule.yml to check possible testing platforms

Built With

Ansible Molecule

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

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

License

Apache 2.0 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.