Install and configure rsyslog on your system.
| Travis | GitHub | Quality | Downloads |
|---|---|---|---|
 |
 |
 |
 |
This example is taken from molecule/resources/converge.yml and is tested on each push, pull request and release.
---
- name: Converge
hosts: all
become: yes
gather_facts: yes
roles:
- role: robertdebock.rsyslogThe machine may need to be prepared using molecule/resources/prepare.yml:
---
- name: Prepare
hosts: all
become: yes
gather_facts: no
roles:
- role: robertdebock.bootstrapFor verification molecule/resources/verify.yml run after the role has been applied.
---
- name: Verify
hosts: all
become: yes
gather_facts: yes
tasks:
- name: check if connection still works
ping:Also see a full explanation and example on how to use these roles.
These variables are set in defaults/main.yml:
---
# defaults file for rsyslog
# To configure a server to reveice logs, set rsyslog_receiver to yes.
# Not setting this value will not configure the server tor receive logs.
# rsyslog_receiver: yes
# To forward logs to another server, set rsyslog_remote to the hostname or
# the ipaddress of the receiving rsyslog server.
# Not setting this variable will not forward logs.
# rsyslog_remote: server1.example.com
# Set the mode for new directories
rsyslog_dircreatemode: "0700"
# Set the mode for new files
rsyslog_filecreatemode: "0644"
# Set the mods enabled
rsyslog_mods:
- imuxsock
- imjournal
# Configure rsyslog minimally (may be in conflict with custom configuration files)
rsyslog_deploy_default_config: True```
## Requirements
- Access to a repository containing packages, likely on the internet.
- A recent version of Ansible. (Tests run on the current, previous and next release of Ansible.)
The following roles can be installed to ensure all requirements are met, using `ansible-galaxy install -r requirements.yml`:
```yaml
---
- robertdebock.bootstrap
This role is a part of many compatible roles. Have a look at the documentation of these roles for further information.
Here is an overview of related roles:
This role has been tested on these container images:
| container | tags |
|---|---|
| amazon | all |
| alpine | all |
| debian | all |
| el | 7, 8 |
| fedora | all |
| opensuse | all |
| ubuntu | bionic |
The minimum version of Ansible required is 2.8 but tests have been done to:
- The previous version, on version lower.
- The current version.
- The development version.
Some variarations of the build matrix do not work. These are the variations and reasons why the build won't work:
| variation | reason |
|---|---|
| archlinux/base | target not found: rsyslog |
Unit tests are done on every commit, pull request, release and periodically.
If you find issues, please register them in GitHub
Testing is done using Tox and Molecule:
Tox tests multiple ansible versions. Molecule tests multiple distributions.
To test using the defaults (any installed ansible version, namespace: robertdebock, image: fedora, tag: latest):
molecule test
# Or select a specific image:
image=ubuntu molecule test
# Or select a specific image and a specific tag:
image="debian" tag="stable" tox
Or you can test multiple versions of Ansible, and select images:
Tox allows multiple versions of Ansible to be tested. To run the default (namespace: robertdebock, image: fedora, tag: latest) tests:
tox
# To run CentOS (namespace: `robertdebock`, tag: `latest`)
image="centos" tox
# Or customize more:
image="debian" tag="stable" tox
Apache-2.0
Please consider sponsoring me.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent