Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0

## [Unreleased]

**Highlights:** Apache Solr runs on Debian, Ubuntu and RHEL 10 and supports Solr 9.11. Hosts that deploy the OWASP Core Rule Set with apache_httpd need `apache_httpd__mod_security_coreruleset_version` in their inventory, since the role no longer picks a release on its own and verifies the download against a checksum. The `systemd_unit` role also manages socket units, so a host can forward a TCP port with `systemd-socket-proxyd` without installing a proxy server. Hosts set up with `setup_basic` follow more of the CIS Benchmarks out of the box: root can no longer log in over SSH, USB storage is blocked, a sysctl hardening baseline is applied, and the cron configuration is readable by root only. Before updating, make sure Ansible logs in with an unprivileged user, and allow USB storage on hosts that need it. Nextcloud keeps the apps and app settings that the admin changed in the web interface, and JPEG previews work again. Large runs are easier to follow with the `linuxfabrik.lfops.compact` stdout callback, which shows one block per task, a progress bar per host, and only what changed. The `linuxfabrik.lfops.dashboard` stdout callback shows a run on one fixed screen, with the hosts sorted by severity. `duba` backups no longer fail on a small `/tmp`, `duba` throttles itself instead.
**Highlights:** Apache Solr runs on Debian, Ubuntu and RHEL 10 and supports Solr 9.11. Hosts that deploy the OWASP Core Rule Set with apache_httpd need `apache_httpd__mod_security_coreruleset_version` in their inventory, since the role no longer picks a release on its own and verifies the download against a checksum. The `systemd_unit` role also manages socket units, so a host can forward a TCP port with `systemd-socket-proxyd` without installing a proxy server. Hosts set up with `setup_basic` follow more of the CIS Benchmarks out of the box: root can no longer log in over SSH, USB storage is blocked, a sysctl hardening baseline is applied, and the cron configuration is readable by root only. Before updating, make sure Ansible logs in with an unprivileged user, and allow USB storage on hosts that need it. Nextcloud keeps the apps and app settings that the admin changed in the web interface, and JPEG previews work again. Large runs are easier to follow with the `linuxfabrik.lfops.compact` stdout callback, which shows one block per task, a progress bar per host, and only what changed. The `linuxfabrik.lfops.dashboard` stdout callback shows a run on one fixed screen, with a progress bar, the estimated remaining time and the hosts sorted by severity. `duba` backups no longer fail on a small `/tmp`, `duba` throttles itself instead.

### Breaking Changes

Expand Down Expand Up @@ -93,7 +93,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
* **role:freeipa_server**: The `freeipa_server__healthcheck_*` variables set the certificate warning period, the timeout per check and the excludes of `ipa-healthcheck`, by default with 30 instead of 10 seconds per check.
* **role:freeipa_server**: Installs `ipa-healthcheck` and runs it right after the installation and then daily at 06:xx, at a fixed minute per host or after the next boot if the host was down at that time, so its report in `/var/log/ipa/healthcheck/healthcheck.log` is ready for monitoring.
* **execution-environment**: The image carries its LFOps version in the `LFOPS_EE_VERSION` environment variable and the `org.opencontainers.image.version` label, and the dashboard callback shows it.
* **plugin:dashboard**: The `linuxfabrik.lfops.dashboard` stdout callback shows a run on one fixed screen with counters and the hosts sorted by severity, and the details of the tasks with changes, warnings or failures at the end.
* **plugin:dashboard**: The `linuxfabrik.lfops.dashboard` stdout callback shows a run on one fixed screen with a progress bar, counters and the hosts sorted by severity, and the details of the tasks with changes, warnings or failures at the end.
* **plugin:compact**: The `linuxfabrik.lfops.compact` stdout callback shortens the output of large runs to one block per task, with a progress bar per host, one line each for the ok and the skipped hosts, the diff or module output of the changed hosts and the warnings, each grouped by identical text, and a report of the distinct changes, warnings and errors by severity at the end.
* **role:rpm, playbook:rpm, playbook:setup_basic**: Checks the RPM database on RHEL 8, 9 and 10 before the first package task, aborts on a damaged one instead of failing later with `rpmdb open failed`, and on RHEL 8 repairs a database that a killed rpm process left unusable, keeping all packages.
* **role:dnf, playbook:dnf**: Sets options in `/etc/dnf/dnf.conf` on RHEL 8, 9 and 10, by default `minrate=200k` and `timeout=15`, so DNF drops slow mirrors sooner. Hosts without DNF 4 are left alone.
Expand Down
19 changes: 11 additions & 8 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -382,24 +382,27 @@ Enable it with `stdout_callback = linuxfabrik.lfops.compact` in the `ansible.cfg

The goal of the `linuxfabrik.lfops.dashboard` stdout callback is a live view of a run, similar to how glances shows the load of a system: always visible, without scrolling, and adapting to the size of the terminal.

It shows the run on one fixed screen that is updated in place instead of scrolling: the current role and task, counters of the results of the current task and of the whole run, and the hosts, sorted by their most severe result (fatal, warning, changed, ignored, ok) and then by name, each with its counts of fatal (F), warning (W) and changed (C) results and its last notable result, marked with the letter of its kind. A host with only ok results shows its last ok result, hosts with only skipped results are counted, not listed:
It shows the run on one fixed screen that is updated in place instead of scrolling: the current role and task, a progress bar of the play, counters of the results of the current task and of the whole run, with the ok results of the task followed by the hosts still at work on it and the number of hosts (`ok 20/5/35`), and the hosts, sorted by their most severe result (fatal, warning, changed, ignored, ok) and then by name. Each host comes with its counts of fatal (F), warning (W), changed (C) and ok (O) results and its last notable result (LAST WORST), marked with the letter of its kind. A rising O count shows that a host is still at work while LAST WORST stays the same. A host with only ok results shows its last ok result, hosts with only skipped results are counted, not listed:

```text
linuxfabrik.lfops.setup_basic 35 hosts 00:12:34
LFOps main@3e8a7b75, 2 uncommitted ansible-core 2.16.19 mounted from /h/u/lfops
Role: linuxfabrik.lfops.firewall
Task: Deploy the firewall rules
step 140/421 (33%) ETA 00:15:12
──────────────────────────────────────────────────────────────────────────────────
Task ok 20 changed 3 skipped 5 fatal 1 unreachable 0 pending 6
Run ok 1840 changed 61 warning 12 fatal 1 unreachable 0
Task ok 20/5/35 changed 3 skipped 5 fatal 1 unreachable 0 ignored 0
Run ok 1840 changed 61 warning 12 fatal 1 unreachable 0
──────────────────────────────────────────────────────────────────────────────────
HOST F W C LAST
web-02 1 0 2 F firewall - Deploy the firewall rules: ...
web-01 0 2 5 W lvm - pvcreate / pvresize: Rescan path does not exist ...
db-01 0 0 7 C firewall - Deploy the firewall rules
app-01 0 0 0 O firewall - Deploy the firewall rules
HOST F W C O LAST WORST
web-02 1 0 2 48 F firewall - Deploy the firewall rules: ...
web-01 0 2 5 61 W lvm - pvcreate / pvresize: Rescan path does not exist ...
db-01 0 0 7 59 C firewall - Deploy the firewall rules
app-01 0 0 0 66 O firewall - Deploy the firewall rules
```

The progress bar counts the tasks of the play that are known when it starts, after `--tags` and `--skip-tags` are applied, and is drawn in reverse video on a color terminal. The estimated remaining time (ETA) assumes that the steps left take as long on average as the steps so far, so it gets more accurate towards the end of the play. A task included with `include_tasks` or `include_role` is one step, so the bar stands still while the tasks it includes run. Handlers and `rescue` sections are not counted. The bar measures tasks, not time, and starts over with every batch of `serial`.

At the end of the run, the details follow in the format of the [compact output](#compact-output), but only for the tasks with changes, warnings or failures, then the recap and the report. Without a terminal (log file, pipe, CI), with `--verbose`, or on a terminal smaller than 65 columns and 12 lines, it behaves exactly like `linuxfabrik.lfops.compact`. Enable it like the compact output, with `linuxfabrik.lfops.dashboard` as the stdout callback. See `ansible-doc --type callback linuxfabrik.lfops.dashboard` for details.

### LFOps-wide Variables
Expand Down
Loading
Loading