From 0069946d61f840bf7cd76318e1fec6aa74ecc915 Mon Sep 17 00:00:00 2001
From: Christian Berendt <berendt@osism.tech>
Date: Wed, 1 May 2024 12:39:53 +0200
Subject: [PATCH] Improve osism.commons.packages

Signed-off-by: Christian Berendt <berendt@osism.tech>
---
 .../configuration-guide/commons/packages.md   | 42 ++++++++++++++++++-
 1 file changed, 40 insertions(+), 2 deletions(-)

diff --git a/docs/guides/configuration-guide/commons/packages.md b/docs/guides/configuration-guide/commons/packages.md
index b986ee2906..56b8be9f58 100644
--- a/docs/guides/configuration-guide/commons/packages.md
+++ b/docs/guides/configuration-guide/commons/packages.md
@@ -5,16 +5,35 @@ sidebar_label: Packages
 # Packages
 
 With the `osism.commons.packages` role, it is possible to add packages on a node
-in a general form.
+in a general form. The parameters should be used in the inventory or in the
+`environments/configuration.yml` file.
+
+The following packages are installed by default.
 
 ```
 required_packages_default:
+  - curl
+  - dmidecode
   - ethtool
+  - iotop
   - jq
+  - lsscsi
+  - ltrace
+  - mtr
+  - nvme-cli
+  - pciutils
   - rsyslog
+  - socat
+  - sysstat
+  - tmux
+  - tree
+  - whois
+```
+
+Additional packages can be added via the `required_packages_extra` parameter.
 
+```
 required_packages_extra: []
-required_packages: "{{ required_packages_default + required_packages_extra + required_packages_distribution }}"
 ```
 
 ## Distribution specific packages
@@ -25,7 +44,16 @@ With Debian, the packages listed in `required_packages_distribution` are install
 
 ```
 required_packages_distribution:
+  - command-not-found
+  - debconf
   - debsums
+  - htop
+  - iftop
+  - iperf
+  - multitail
+  - ncdu
+  - pv
+  - python-is-python3
   - selinux-utils
   - ssh
 ```
@@ -34,6 +62,16 @@ The `apt_cache_valid_time` parameter can be used to set the `cache_valid_time` p
 of the `ansible.builtin.apt` module. The module updates the apt cache if it is older than
 the `cache_valid_time`. The parameter is set in seconds and defaults to `3600`.
 
+### CentOS
+
+With CentOS, the packages listed in `required_packages_distribution` are installed by default.
+
+```
+required_packages_distribution:
+  - libselinux-utils
+  - openssh
+```
+
 ## Upgrade of packages
 
 The `upgrade_packages` parameter can be used to configure the upgrade of packages.