X-Git-Url: https://review.fuel-infra.org/gitweb?a=blobdiff_plain;f=README.md;h=5064fed09306c63d992639fa40515ef2e4ecad54;hb=6751213bc3b966766a5c1a55c08952e7b983c9dc;hp=7e39c8d9eeb328ca8dff84da171c47428ce464f1;hpb=b67b91b53f9ac68de3d614f39ad2ae64435726d6;p=puppet-modules%2Fpuppetlabs-apt.git diff --git a/README.md b/README.md index 7e39c8d..5064fed 100644 --- a/README.md +++ b/README.md @@ -8,7 +8,7 @@ The apt module provides a simple interface for managing Apt source, key, and def The apt module automates obtaining and installing software packages on \*nix systems. -**Note**: While this module allows the use of short keys, **we urge you NOT to use short keys**, as they pose a serious security issue by opening you up to collision attacks. +**Note**: While this module allows the use of short keys, **warnings are thrown if a full fingerprint is not used**, as they pose a serious security issue by opening you up to collision attacks. ## Setup @@ -74,12 +74,11 @@ class { 'apt': ``` class { 'apt::unattended_upgrades': - origins => $::apt::params::origins, - blacklist => [], - update => '1', - download => '1', - upgrade => '1', - autoclean => '7', + blacklist => [], + update => '1', + download => '1', + upgrade => '1', + autoclean => '7', } ``` @@ -201,7 +200,7 @@ class { 'apt': release => 'unstable', repos => 'main contrib non-free', required_packages => 'debian-keyring debian-archive-keyring', - key => '8B48AD6246925553', + key => 'A1BD8E9D78F7FE5C3E65D8AF8B48AD6246925553', key_server => 'subkeys.pgp.net', pin => '-10', include_src => true, @@ -277,13 +276,22 @@ apt::sources: ####apt::unattended_upgrades -* `origins`: The repositories from which to automatically upgrade included packages. -* `blacklist`: A list of packages to **not** automatically upgrade. -* `update`: How often, in days, to run `apt-get update`. -* `download`: How often, in days, to run `apt-get upgrade --download-only`. -* `upgrade`: How often, in days, to upgrade packages included in the origins list. -* `autoclean`: How often, in days, to run `apt-get autoclean`. -* `randomsleep`: How long, in seconds, to randomly wait before applying upgrades. +* `legacy_origin`: If set to true, use the old `Unattended-Upgrade::Allowed-Origins` variable. If false, use `Unattended-Upgrade::Origins-Pattern`. OS-dependent defaults are defined in `apt::params`. +* `origins`: The repositories from which to automatically upgrade included packages. OS-dependent defaults are defined in `apt::params`. (Usually only security updates are enabled by default) +* `blacklist`: A list of packages to **not** automatically upgrade. This list is empty by default. +* `update`: How often, in days, to run `apt-get update`. Defaults to '1'. +* `download`: How often, in days, to run `apt-get upgrade --download-only`. Defaults to '1'. +* `upgrade`: How often, in days, to upgrade packages included in the origins list. Defaults to '1'. +* `autoclean`: How often, in days, to run `apt-get autoclean`. Defaults to '7'. +* `auto_fix`: Tries to automatically fix interrupted package installations. Defaults to 'true'. +* `minimal_steps`: Split the upgrade process into sections to allow shutdown during upgrade. Defaults to 'false'. +* `install_on_shutdown`: Install updates on shutdown instead of in the background. Defaults to 'false'. +* `mail_to`: Send e-mail to this address about packages upgrades or errors. This is not set by default. +* `mail_only_on_error`: Send e-mail only in case of error, not on successful upgrade. Defaults to 'false'. +* `remove_unused`: Removes unused dependencies. Defaults to 'true'. +* `auto_reboot`: Reboot the system **without confirmation** if an update requires rebooting. Defaults to 'false'. +* `dl_limit`: Use a bandwidth limit for downloading, specified in kb/sec. This is not set by default. +* `randomsleep`: How long, in seconds, to randomly wait before applying upgrades. This is not set by default. ####apt::source