Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/idealista/prometheus_server_role
Ansible role to install a Prometheus server
https://github.com/idealista/prometheus_server_role
ansible debian prometheus
Last synced: 19 days ago
JSON representation
Ansible role to install a Prometheus server
- Host: GitHub
- URL: https://github.com/idealista/prometheus_server_role
- Owner: idealista
- License: apache-2.0
- Created: 2017-03-13T10:55:47.000Z (almost 8 years ago)
- Default Branch: master
- Last Pushed: 2023-05-04T15:11:56.000Z (over 1 year ago)
- Last Synced: 2024-10-20T03:29:18.464Z (2 months ago)
- Topics: ansible, debian, prometheus
- Language: YAML
- Homepage:
- Size: 188 KB
- Stars: 5
- Watchers: 25
- Forks: 4
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: .github/CONTRIBUTING.md
- License: LICENSE
- Code of conduct: .github/CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
[](https://travis-ci.com/idealista/prometheus_server_role)
# Prometheus Server Ansible role
This ansible role installs a Prometheus server in a debian environment. The server is installed using the sources.
- [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 [Prometheus](https://prometheus.io/) server in a Debian system.
### Prerequisities
Ansible 2.9.x.x version installed.
Inventory destination should be a Debian environment.
For testing purposes, [Molecule](https://molecule.readthedocs.io/) with [Docker](https://www.docker.com/) as driver.
Take a look at the [Pipfile](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](defaults/main.yml) properties file to see the possible configuration properties.
:warning: 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](https://github.com/idealista/prometheus_server_role/blob/master/molecule.yml) to check possible testing platforms
## Built With
## Versioning
For the versions available, see the [tags on this repository](https://github.com/idealista/prometheus_server_role/tags).
Additionaly you can see what change in each version in the [CHANGELOG.md](CHANGELOG.md) file.
## Authors
* **Idealista** - *Work with* - [idealista](https://github.com/idealista)
See also the list of [contributors](https://github.com/idealista/prometheus_server_role/contributors) who participated in this project.
## License
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](.github/CONTRIBUTING.md) for details on our code of conduct, and the process for submitting pull requests to us.