65 lines
2.6 KiB
Markdown
65 lines
2.6 KiB
Markdown
# Ansible role - motd
|
||
|
||
Install and configure dynamic MOTD
|
||
|
||
This role uses [https://gitea.tips-of-mine.com/Tips-Of-Mine/motd](https://gitea.tips-of-mine.com/Tips-Of-Mine/motd) by default to get the MOTD
|
||
|
||
```
|
||
System info:
|
||
Hostname·········: tips-of-mine_motd_ubuntu-20.04
|
||
Distro···········: Ubuntu 20.04.3 LTS
|
||
Kernel···········: Linux 5.10.47-linuxkit
|
||
Uptime···········: up 12 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.10
|
||
|
||
## :zap: Installation
|
||
|
||
```bash
|
||
ansible-galaxy install tips-of-mine.motd
|
||
```
|
||
|
||
## :gear: Role variables
|
||
|
||
Variable | Default value | Description
|
||
-----------------------------|------------------------------------------------------------------------|----------------------------------------------------------------
|
||
motd_disable_default_motd | true | Disable system default MOTD (/etc/motd)
|
||
motd_template | https://gitea.tips-of-mine.com/Tips-Of-Mine/motd/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: tips-of-mine.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/)
|