Skip to content

Commit

Permalink
Improve osism.commons.packages
Browse files Browse the repository at this point in the history
Signed-off-by: Christian Berendt <[email protected]>
  • Loading branch information
berendt committed May 1, 2024
1 parent 167f46c commit 0069946
Showing 1 changed file with 40 additions and 2 deletions.
42 changes: 40 additions & 2 deletions docs/guides/configuration-guide/commons/packages.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand All @@ -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
```
Expand All @@ -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.
Expand Down

0 comments on commit 0069946

Please sign in to comment.