https://github.com/idealista/rsyslog_role
Ansible role to install RSYSLOG
https://github.com/idealista/rsyslog_role
ansible ansible-role rsyslog rsyslogd
Last synced: 2 months ago
JSON representation
Ansible role to install RSYSLOG
- Host: GitHub
- URL: https://github.com/idealista/rsyslog_role
- Owner: idealista
- License: apache-2.0
- Created: 2019-01-18T10:59:16.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2023-01-19T16:46:10.000Z (over 3 years ago)
- Last Synced: 2025-02-06T09:48:04.422Z (over 1 year ago)
- Topics: ansible, ansible-role, rsyslog, rsyslogd
- Language: YAML
- Size: 166 KB
- Stars: 1
- Watchers: 15
- Forks: 1
- 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.org/idealista/rsyslog_role)
[](https://galaxy.ansible.com/idealista/rsyslog_role)
# RSYSLOG Ansible role
This Ansible role installs a RSYSLOG 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 a [RSYSLOG](https://www.rsyslog.com/) server in a Debian system.
### Prerequisities
Ansible 4.0.0 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.
### Installing
Create or add to your roles dependency file (e.g requirements.yml):
```
- src: idealista.rsyslog_role
version: 2.2.0
name: rsyslog
```
Install the role with ansible-galaxy command:
```
ansible-galaxy install -p roles -r requirements.yml -f
```
Use in a playbook:
```
---
- hosts: someserver
roles:
- { role: rsyslog }
```
## Usage
Look to the [defaults vars](defaults/main.yml) file to see the possible configuration vars.
## Testing
```
$ pipenv sync
$ MOLECULE_DISTRO=(debian8|debian9|debian10) pipenv run molecule test
```
Note: Debian9 (Debian Stretch) will be used as default linux distro if none is provided.
See [molecule.yml](https://github.com/idealista/rsyslog_role/blob/master/molecule/default/molecule.yml) to check possible testing platforms.
## Built With
## Versioning
For the versions available, see the [tags on this repository](https://github.com/idealista/rsyslog_role/tags).
Additionaly you can see what change in each version in the [CHANGELOG.md](https://github.com/idealista/rsyslog_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/rsyslog_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](https://github.com/idealista/rsyslog_role/blob/master/.github/CONTRIBUTING.md) for details on our code of conduct, and the process for submitting pull requests to us.