pkg

install or remove packages

Before the first install of a run on a host, apply refreshes the package index. After a repo step changed something, the next pkg step refreshes it again.

Keys

KeyTypeDefaultMeaning
namestring or list of stringsrequiredinstalled in one apt call
recommendsbooleantrueinstall recommended packages too
purgebooleanfalseremove the config files too
absentbooleanfalse

pkg.name

string or list of strings, required

Installed in one apt call.

pkg.recommends

boolean, default true

Install recommended packages too.

pkg.purge

boolean, default false

Remove the config files too. purge needs absent.

pkg.absent

boolean, default false

Remove the packages.

Example

- pkg:
    name: [nginx, certbot]
    recommends: false