arillso.system.shell role – Complete shell environment and MOTD configuration

Note

This role is part of the arillso.system collection (version 1.0.5).

It is not included in ansible-core. To check whether it is installed, run ansible-galaxy collection list.

To install it use: ansible-galaxy collection install arillso.system.

To use it in a playbook, specify: arillso.system.shell.

Entry point main – Complete shell environment and MOTD configuration

Synopsis

  • Configures MOTD, SSH banners, shell environment, and terminal settings

  • Provides consistent shell environment across all managed systems

Parameters

Parameter

Comments

shell_collection_name

string

Fully qualified collection name for this role

Default: "arillso.system.shell"

shell_company_contact

string

Contact information displayed in MOTD

Default: "DevOps Team"

shell_company_name

string

Company name displayed in MOTD and banners

Default: "Hetzner Cloud K3s Platform"

shell_company_support_url

string

Support URL displayed in MOTD footer

Default: "https://github.com/sbaerlocher/devops"

shell_configure_aliases

boolean

Configure shell aliases

Choices:

  • false

  • true ← (default)

shell_configure_history

boolean

Configure shell history settings

Choices:

  • false

  • true ← (default)

shell_configure_profiles

boolean

Configure shell profile files

Choices:

  • false

  • true ← (default)

shell_configure_prompt

boolean

Configure shell prompt

Choices:

  • false

  • true ← (default)

shell_debug_mode

boolean

Enable debug output for troubleshooting

Choices:

  • false ← (default)

  • true

shell_default

string

Default shell for the system

Default: "/bin/bash"

shell_enable_background_processing

boolean

Enable background processing for status data

Choices:

  • false

  • true ← (default)

shell_enabled

boolean

Enable shell environment configuration

Choices:

  • false

  • true ← (default)

shell_environment

string

Environment classification for MOTD display

Default: "production"

shell_facts_collection_name

string

Facts collection name for gathering system data

Default: "arillso.system.facts"

shell_facts_dependency

boolean

Require facts role for system data

Choices:

  • false

  • true ← (default)

shell_ignore_package_errors

boolean

Ignore errors when installing packages

Choices:

  • false

  • true ← (default)

shell_ignore_template_errors

boolean

Ignore errors when rendering templates

Choices:

  • false ← (default)

  • true

shell_motd_enabled

boolean

Enable MOTD configuration

Choices:

  • false

  • true ← (default)

shell_motd_font

string

Font used for figlet MOTD style

Default: "standard"

shell_motd_show_cloud_info

boolean

Show cloud provider information in MOTD

Choices:

  • false

  • true ← (default)

boolean

Show footer with contact information in MOTD

Choices:

  • false

  • true ← (default)

shell_motd_show_network

boolean

Show network information in MOTD

Choices:

  • false

  • true ← (default)

shell_motd_show_performance

boolean

Show performance metrics in MOTD

Choices:

  • false

  • true ← (default)

shell_motd_show_system_info

boolean

Show system information in MOTD

Choices:

  • false

  • true ← (default)

shell_motd_style

string

MOTD display style

Choices:

  • "standard" ← (default)

  • "figlet"

  • "minimal"

shell_role_name

string

Name of this role for internal references

Default: "shell"

shell_ssh_banner_enabled

boolean

Enable SSH pre-login banner

Choices:

  • false

  • true ← (default)

boolean

Show legal notice in SSH banner

Choices:

  • false

  • true ← (default)

shell_ssh_banner_show_warnings

boolean

Show security warnings in SSH banner

Choices:

  • false

  • true ← (default)

shell_status_cache_dir

string

Directory for caching status data

Default: "/var/cache/arillso-system-shell"

shell_status_cache_ttl

integer

Cache time-to-live in seconds for status data

Default: 600

shell_status_precompute_interval

string

Cron interval for precomputing status data

Default: "*/5"

shell_terminal_colors_enabled

boolean

Enable terminal color support

Choices:

  • false

  • true ← (default)

shell_terminal_completion_enabled

boolean

Enable tab completion

Choices:

  • false

  • true ← (default)

shell_version

string

Version of the shell role

Default: "1.0.0"