ramondevprivate.common.fleet_inventory role – Document Debian servers as Markdown for Obsidian

Note

This role is part of the ramondevprivate.common collection (version 1.0.0).

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 ramondevprivate.common.

To use it in a playbook, specify: ramondevprivate.common.fleet_inventory.

Entry point main – Document Debian servers as Markdown for Obsidian

Synopsis

  • Collects read-only facts from each host, stores one JSON snapshot per host on the controller and renders a page per host, an overview and a server list.

  • Hosts that are targeted but not collected keep their last snapshot and are shown as not updated.

Parameters

Parameter

Comments

fleet_inventory_data_dir

path / required

Controller folder for the JSON snapshots. Keep it outside the vault.

fleet_inventory_descriptions_dir

string

Folder in fleet_inventory_output_dir for your own note per server, embedded in its page. The role only creates missing notes.

Empty switches descriptions off.

Default: "Descriptions"

fleet_inventory_group_filter

list / elements=string

Supplementary groups not shown for users.

Never list privilege groups like sudo, docker, lxd or adm.

Default: ["cdrom", "floppy", "audio", "dip", "video", "plugdev", "users", "netdev", "bluetooth"]

fleet_inventory_inactive_days

integer

A last login older than this many days (at collection time) marks a user inactive.

Default: 365

fleet_inventory_mermaid_charts

boolean

Bar charts for cores, RAM and disk in the overview.

Choices:

  • false

  • true ← (default)

fleet_inventory_output_dir

path / required

Vault folder for Overview.md, Server List.md and Servers/.

fleet_inventory_probe_host

string

Host that pings the public addresses (SSH host name or alias); it doesn’t have to be in the inventory and needs ping and Python, no sudo.

Empty means no probe; hosts keep their stored exposure.

Default: ""

fleet_inventory_probe_key

path

SSH key for the probe host (private key, or the public key of an agent key); only this key is offered.

Empty means the usual SSH defaults.

Default: ""

fleet_inventory_probe_port

integer

SSH port of the probe host; always passed, so a Port in ~/.ssh/config doesn’t apply.

Default: 22

fleet_inventory_probe_user

string

SSH user on the probe host; required with fleet_inventory_probe_host.

Default: ""

fleet_inventory_stopped_containers

boolean

List containers that are not running. Decided at render time; they are always collected.

Choices:

  • false

  • true ← (default)

fleet_inventory_update_max_age_days

integer

Auto-updates without a successful run for this many days (at collection time) need attention.

Default: 7

fleet_inventory_user_filter

list / elements=string

Accounts not collected at all. Filtering root hides who can log in as root.

Default: ["root", "debian"]