79 lines
4.3 KiB
Markdown
79 lines
4.3 KiB
Markdown
# Ansible role - motd
|
||
[](https://www.claranet.fr/)
|
||
[](LICENSE)
|
||
[](https://github.com/claranet/ansible-role-motd/releases)
|
||
[](https://github.com/claranet/ansible-role-motd/actions?query=workflow%3A%22Ansible+Molecule%22)
|
||
[](https://github.com/ansible/ansible)
|
||
[](https://galaxy.ansible.com/claranet/motd)
|
||
|
||
|
||
> :star: Star us on GitHub — it motivates us a lot!
|
||
|
||
Install and configure dynamic MOTD and SSH banner
|
||
|
||
This role uses [https://github.com/claranet/motd](https://github.com/claranet/motd) by default to get the banner and the MOTD
|
||
|
||
```
|
||
System info:
|
||
Hostname·········: claranet_motd_ubuntu-20.04
|
||
Distro···········: Ubuntu 20.04.3 LTS
|
||
Kernel···········: Linux 5.10.47-linuxkit
|
||
Uptime···········: up 2 days, 23 hours, 18 minutes
|
||
Load·············: 1.33 (1m), 0.43 (5m), 0.20 (15m)
|
||
Processes········: 13 (root), 3 (user), 16 (total)
|
||
CPU··············: Intel(R) Core(TM) i7-8569U CPU @ 2.80GHz (4 vCPU)
|
||
Memory···········: 626Mi used, 2.6Gi avail, 3.8Gi total
|
||
Local IPs········: 172.17.0.6
|
||
|
||
Disk usage:
|
||
/ 9% used out of 63G
|
||
[====··············································]
|
||
|
||
Ansible:
|
||
Last deployment···: 2021-09-27T13:33:33.665714Z
|
||
```
|
||
|
||
## :warning: Requirements
|
||
|
||
Ansible >= 2.9
|
||
|
||
## :zap: Installation
|
||
|
||
```bash
|
||
ansible-galaxy install claranet.motd
|
||
```
|
||
|
||
## :gear: Role variables
|
||
|
||
Variable | Default value | Description
|
||
-----------------------------|------------------------------------------------------------------------|----------------------------------------------------------------
|
||
motd_disable_default_motd | true | Disable system default MOTD (/etc/motd)
|
||
motd_banner_template | https://raw.githubusercontent.com/claranet/motd/master/banner | SSH banner template<br>Can be a URL, a local template or `null`
|
||
motd_banner_template_prepend | "" | Prepend raw content to `motd_banner_template`
|
||
motd_banner_template_append | "" | Append raw content to `motd_banner_template`
|
||
motd_banner_template_username| {{ motd_template_username }} | Used when `motd_banner_template` is an URL
|
||
motd_banner_template_password| {{ motd_template_password }} | Used when `motd_banner_template` is an URL
|
||
motd_template | https://raw.githubusercontent.com/claranet/motd/master/scripts/00-basic| Dynmaic MOTD template<br>Can be a URL or a local template
|
||
motd_template_prepend | "" | Prepend raw content to `motd_template`
|
||
motd_template_append | See [defaults/main.yml](defaults/main.yml) | Append raw content to `motd_template`
|
||
motd_template_username | "" | Used when `motd_template` is an URL
|
||
motd_template_password | "" | Used when `motd_template` is an URL
|
||
|
||
## :pencil2: Example Playbook
|
||
|
||
```yaml
|
||
---
|
||
- hosts: all
|
||
roles:
|
||
- role: claranet.motd
|
||
motd_template: "{{ playbook_dir }}/templates/dynmotd.j2"
|
||
```
|
||
|
||
## :closed_lock_with_key: [Hardening](HARDENING.md)
|
||
|
||
## :heart_eyes_cat: [Contributing](CONTRIBUTING.md)
|
||
|
||
## :copyright: [License](LICENSE)
|
||
|
||
[Mozilla Public License Version 2.0](https://www.mozilla.org/en-US/MPL/2.0/)
|