https://github.com/stephrobert/ansible-role-motd

https://github.com/stephrobert/ansible-role-motd

Last synced: 14 days ago
JSON representation

• Host: GitHub
• URL: https://github.com/stephrobert/ansible-role-motd
• Owner: stephrobert
• Created: 2023-12-14T09:36:12.000Z (about 1 year ago)
• Default Branch: main
• Last Pushed: 2023-12-14T09:38:48.000Z (about 1 year ago)
• Last Synced: 2024-11-03T07:33:12.105Z (about 2 months ago)
• Language: Shell
• Size: 11.7 KB
• Stars: 2
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# stephrobert.motd

[![Maintainer](https://img.shields.io/badge/maintained%20by-stephrobert-e00000?style=flat-square)](https://github.com/stephrobert)

[![License](https://img.shields.io/github/license/stephrobert/ansible-role-motd?style=flat-square)](https://github.com/stephrobert/ansible-role-motd/blob/main/LICENSE)

[![Release](https://img.shields.io/github/v/release/stephrobert/ansible-role-motd?style=flat-square)](https://github.com/stephrobert/ansible-role-motd/releases)

[![Status](https://img.shields.io/github/workflow/status/stephrobert/ansible-role-motd/Ansible%20Molecule?style=flat-square&label=tests)](https://github.com/stephrobert/ansible-role-motd/actions?query=workflow%3A%22Ansible+Molecule%22)

[![Ansible Galaxy](https://img.shields.io/badge/ansible-galaxy-black.svg?style=flat-square&logo=ansible)](https://galaxy.ansible.com/stephrobert/motd)[![Ansible version](https://img.shields.io/badge/ansible-%3E%3D2.10-black.svg?style=flat-square&logo=ansible)](https://github.com/ansible/ansible)

⭐ Star us on GitHub — it motivates us a lot!

Configure motd

**Platforms Supported**:

| Platform | Versions |

|----------|----------|

| Debian | bullseye |

| Ubuntu | jammy |

## ⚠️ Requirements

Ansible >= 2.11.

### Ansible role dependencies

None.

## ⚡ Installation

### Install with Ansible Galaxy

```shell

ansible-galaxy install stephrobert.motd

```

### Install with git

If you do not want a global installation, clone it into your `roles_path`.

```bash

git clone [email protected]:stephrobert/ansible-role-motd.git  stephrobert.motd

```

But I often add it as a submodule in a given `playbook_dir` repository.

```bash

git submodule add [email protected]:stephrobert/ansible-role-motd.git roles/stephrobert.motd

```

As the role is not managed by Ansible Galaxy, you do not have to specify the

github user account.

### ✏️ Example Playbook

Basic usage is:

```yaml

- hosts: all

  roles:

    - role: stephrobert.motd

      vars:

        motd_banner: stephrobert

        motd_disable_default_motd: true

        

```

## ⚙️ Role Variables

Variables are divided in three types.

The **default vars** section shows you which variables you may

override in your ansible inventory. As a matter of fact, all variables should

be defined there for explicitness, ease of documentation as well as overall

role manageability.

The **context variables** are shown in section below hint you

on how runtime context may affects role execution.

### Default variables

Role default variables from `defaults/main.yml`.

| Variable Name | Value |

|---------------|-------|

| motd_disable_default_motd | True |

| motd_banner | stephrobert |

### Context variables

Those variables from `vars/*.{yml,json}` are loaded dynamically during task

runtime using the `include_vars` module.

Variables loaded from `vars/main.yml`.

| Variable Name | Value |

|---------------|-------|

| motd_sshd_config_file_path | /etc/ssh/sshd_config.d/10-disable-motd |

| motd_pam_login_file_path | /etc/pam.d/login |

| motd_pam_sshd_file_path | /etc/pam.d/sshd |

| motd_file_path | /usr/local/bin/dynmotd |

## Author Information

none