Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/idealista/prometheus_alertmanager_role
Ansible role to install Prometheus alert manager
https://github.com/idealista/prometheus_alertmanager_role
alert-manager ansible debian prometheus
Last synced: 28 days ago
JSON representation
Ansible role to install Prometheus alert manager
- Host: GitHub
- URL: https://github.com/idealista/prometheus_alertmanager_role
- Owner: idealista
- License: apache-2.0
- Created: 2017-02-27T21:42:04.000Z (almost 8 years ago)
- Default Branch: master
- Last Pushed: 2022-07-26T08:37:07.000Z (over 2 years ago)
- Last Synced: 2024-10-20T03:29:17.018Z (3 months ago)
- Topics: alert-manager, ansible, debian, prometheus
- Language: YAML
- Homepage:
- Size: 110 KB
- Stars: 1
- Watchers: 26
- Forks: 4
- Open Issues: 0
-
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.org/idealista/prometheus_alertmanager_role)
# Prometheus Alert Manager Ansible role
This ansible role installs an Alert Manager 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 [Alert Manager](https://prometheus.io/docs/alerting/alertmanager/) server in a Debian system. The role is only compatible with Alert Manager versions greater than 0.13.0.
### 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. Pipenv 2018.11.26 and Python 3 recommended.
### Installing
Create or add to your roles dependency file (e.g requirements.yml):
```
- src: idealista.prometheus_alertmanager_role
version: 3.0.0
name: alertmanager
```
Install the role with ansible-galaxy command:
```
ansible-galaxy install -p roles -r requirements.yml -f
```
Use in a playbook:
```
---
- hosts: someserver
roles:
- role: alertmanager
```
## Usage
Look to the [defaults](defaults/main.yml) properties file to see the possible configuration properties.
Alert Manager configuration is separated in 4 blocks (see https://prometheus.io/docs/alerting/configuration/).
First one, global configuration, is provided setting the properties for the role. The other ones: routes,
inhibit roles and receivers must be provided in 3 separated files. By default this files must be stored in
the path defined by this parameter `alertmanager_config_parts_path` and the filename headed with the position
of the block in the final config file. See [this folder](tests/files/) for example.
## Testing
```
pipenv shell
pipenv sync
molecule test
```
## Built With
## Versioning
For the versions available, see the [tags on this repository](https://github.com/idealista/prometheus_alertmanager_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_alertmanager_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.