buluma.rsyslog
Rôle Ansible rsyslog
Installer et configurer rsyslog sur votre système.
GitHub | Version | Problèmes | Demandes de tirage | Téléchargements |
---|---|---|---|---|
Exemple de Playbook
Cet exemple est tiré de molecule/default/converge.yml
et est testé à chaque envoi, demande de tirage et version.
---
- nom: Convergence
hôtes: tous
devenir: vrai
collecter_faits: vrai
rôles:
- rôle: buluma.rsyslog
vars:
rsyslog_traditional_file_format: faux
rsyslog_omit_local_logging: faux
La machine doit être préparée. Dans CI, cela se fait avec molecule/default/prepare.yml
:
---
- nom: Préparer
hôtes: tous
devenir: vrai
collecter_faits: faux
rôles:
- rôle: buluma.bootstrap
Voir aussi une explication complète et un exemple sur comment utiliser ces rôles.
Variables de rôle
Les valeurs par défaut pour les variables sont définies dans defaults/main.yml
:
---
# fichier de défaut pour rsyslog
# Pour configurer un serveur pour recevoir des logs, définir rsyslog_receiver à vrai.
rsyslog_receiver: faux
# Pour transférer des logs à un autre serveur, définir rsyslog_remote à l'hôte ou
# l'adresse IP du serveur rsyslog récepteur.
# Ne pas définir cette variable n'enverra pas les logs.
# rsyslog_remote: server1.example.com
# Si rsylog_remote est défini, définit le modèle de "sélecteur" pour déterminer quels
# messages envoyer au serveur distant. Par défaut "*.*" envoie tout.
# Voir `man rsyslog.conf`.
rsyslog_remote_selector: "*.*"
# Si rsylog_remote est défini, utilise TCP si vrai. UDP si faux.
rsyslog_remote_tcp: vrai
# Si rsylog_remote est défini, port de destination à utiliser.
rsyslog_remote_port: 514
# Définit le mode pour les nouveaux répertoires; uniquement disponible dans le modèle hérité.
rsyslog_dircreatemode: "0700"
# Définit le mode pour les nouveaux fichiers; uniquement disponible dans le modèle hérité.
rsyslog_filecreatemode: "0644"
# Définit les mods activés
rsyslog_mods:
- imuxsock
- imjournal
# Configure rsyslog de manière minimale (peut entrer en conflit avec des fichiers de configuration personnalisés)
rsyslog_deploy_default_config: vrai
# Règles par défaut de rsyslogd
rsyslog_default_rules:
- { règle: '*.info;mail.none;authpriv.none;cron.none', logpath: '/var/log/messages' }
- { règle: 'authpriv.*', logpath: '/var/log/secure' }
- { règle: 'mail.*', logpath: '-/var/log/maillog' }
- { règle: 'cron.*', logpath: '/var/log/cron' }
- { règle: '*.emerg', logpath: ':omusrmsg:*' }
- { règle: 'uucp,news.crit', logpath: '/var/log/spooler' }
- { règle: 'local7.*', logpath: '/var/log/boot.log' }
# Utiliser le format de fichier de configuration hérité (obsolète) antérieur à la version 6, ou le format de fichier de configuration
# plus moderne dit "avancé" disponible à partir de la version 6. Le
# par défaut est d'utiliser le format 'hérité' pour ne pas changer les fichiers de configuration pour
# les utilisateurs existants de ce rôle.
# Plus d'informations sur les différents formats sur le site web de rsyslog :
# https://www.rsyslog.com/doc/v8-stable/configuration/conf_formats.html
rsyslog_config_file_format: hérité
# Le nom de règle conf à ajouter à /etc/rsyslog.d/
# rsyslog_forward_rule_name: <à remplir>
# Configurez l'état du paquet rsyslog sur `present`, ou définissez-le sur `latest` pour installer
# la version disponible la plus récente.
rsyslog_package_state: présent
# si défini sur faux (par défaut hérité pour rester compatible avec sysklogd), le domaine
# partie d'un nom qui est dans le même domaine que le système de réception est
# supprimé. Si défini sur vrai, les noms complets sont toujours utilisés.
rsyslog_preservefqdn: faux
# Configure les fichiers de configuration supplémentaires dans /etc/rsyslog.d
# Exemple :
# rsyslog_rsyslog_d_files:
# 000-splunk:
# content: |
# auth,authpriv.* action(type="omfwd"
# target="splunk"
# port="514"
# protocol="tcp")
rsyslog_rsyslog_d_files: []
# Évite les messages sd_journal_get_cursor() échoués : Impossible d'assigner l'adresse demandée
# à cause de logrotate
rsyslog_workaroundjournalbug: faux
# Désactive la réception de messages via le socket de log local
rsyslog_imuxsock_syssock: faux
# Installer des paquets rsyslog supplémentaires
# Exemple pour l'installation de rsyslog-elasticsearch :
# rsyslog_features:
# - gnutls
# - elastisearch
rsyslog_features: []
# Destination par défaut du fichier de configuration rsyslog
rsyslog_dest_conf_file: "/etc/rsyslog.conf"
# Activer / Désactiver l'option OmitLocalLogging
rsyslog_omit_local_logging: vrai
# Permet d'utiliser le format de fichier traditionnel.
rsyslog_traditional_file_format: vrai
Exigences
- Paquets pip listés dans requirements.txt.
État des rôles utilisés
Les rôles suivants sont utilisés pour préparer un système. Vous pouvez préparer votre système d'une autre manière.
Exigence | GitHub | Version |
---|---|---|
buluma.bootstrap |
Contexte
Ce rôle fait partie de nombreux rôles compatibles. Consultez la documentation de ces rôles pour plus d'informations.
Voici un aperçu des rôles liés :
Compatibilité
Ce rôle a été testé sur ces images de conteneurs:
conteneur | tags |
---|---|
Alpine | tous |
Amazon | Candidate |
EL | 8, 9 |
Debian | tous |
Fedora | tous |
opensuse | tous |
Ubuntu | tous |
La version minimale d'Ansible requise est 2.12, des tests ont été effectués sur :
- La version précédente.
- La version actuelle.
- La version de développement.
Si vous trouvez des problèmes, veuillez les signaler sur GitHub
Changelog
Licence
Informations sur l'auteur
Install and configure rsyslog on your system.
ansible-galaxy install buluma.rsyslog