gantsign.keyboard

Ansible Role: Keyboard

This project helps configure your keyboard settings.

Requirements

Ansible version 2.9 or higher
Compatible Linux Distributions:
- Debian family:
  - Debian versions:
    - Stretch (9)
    - Buster (10)
    - Bullseye (11)
  - Ubuntu versions:
    - Bionic (18.04)
    - Focal (20.04)

Role Variables

You can adjust the following settings (default values are listed):

# Keyboard model name.
keyboard_model: pc104

# Keyboard layout name.
keyboard_layout: us

# Keyboard variant components.
keyboard_variant: ''

# Keyboard option components.
keyboard_options: ''

# Behavior of BackSpace and Delete keys.
keyboard_backspace: guess

For more options, refer to man keyboard.

Example Playbook

- hosts: servers
  roles:
    - role: gantsign.keyboard
      # European keyboard model (pc105 is commonly used)
      keyboard_model: pc105
      # Layout for the UK
      keyboard_layout: gb

More Roles From GantSign

Explore additional roles from GantSign on Ansible Galaxy.

Development & Testing

This project uses Molecule for development and testing. The role is tested with Testinfra and pytest.

To develop or test, you need to install the following:

Linux (e.g., Ubuntu)
Docker
Python (including python-pip)
Ansible
Molecule

To make installation easier, this project includes Molecule Wrapper, a script that installs Molecule and its dependencies (except for Linux) and runs Molecule with your commands.

To test this role using Molecule Wrapper, run this command from the project root: