diff options
Diffstat (limited to 'README')
| -rw-r--r-- | README | 88 |
1 files changed, 74 insertions, 14 deletions
@@ -11,10 +11,16 @@ backports.debian.org is added. dselect is switched to expert mode to suppress superfluous help screens. -sources.list and apt_preferences are managed. Testing and unstable are pinned to -very low values by default to prevent accidental upgrades. +sources.list and apt_preferences are managed. More recent Debian +releases are pinned to very low values by default to prevent +accidental upgrades. -This module needs lsb-release installed. +Ubuntu support is lagging behind but not absent either. + +This module needs: + +- lsb-release installed +- the common module: git://labs.riseup.net/shared-common Variables @@ -43,18 +49,17 @@ value can be set manually too, e.g. to enable forced upgrades $custom_sources_list -------------------- -By default this module will use a basic apt/sources.list with a -generic debian mirror. If you need to set more specific sources, -e.g. for country proximity, proxies, etc. you can set this variable to -the location of your sources.list template. For example, setting the -following variable before including this class will pull in the -templates/apt/sources.list file: +By default this module will use a basic apt/sources.list. +If you need to set more specific sources, e.g. for proxies, etc. you +can set this variable to the location of your sources.list template. +For example, setting the following variable before including this +class will pull in the templates/apt/sources.list file: $custom_sources_list ='template("apt/sources.list")' $custom_preferences -------------------- By default this module will use a basic apt/preferences file with -unstable and testing pinned to very low values so that any package +more recent releases pinned to very low values so that any package installation will not accidentally pull in packages from those suites unless you explicitly specify the version number. You can set this variable to pull in a customized apt/preferences template, for @@ -80,11 +85,68 @@ If this variable is set to true apt::unattended_upgrades is included, which will install the package unattended-upgrades and configure it to daily upgrade the system. +$apt_volatile_enabled +----------------- + +If this variable is set to true the Debian Volatile sources are added. +By default this is false for backward compatibility with older +versions of this module. + +$apt_include_src +---------------- + +If this variable is set to true a deb-src source is added for every +added binary archive source. +By default this is false for backward compatibility with older +versions of this module. + +$apt_use_next_release +--------------------- + +If this variable is set to true the sources for the next Debian +release are added. The default pinning configuration pins it to very +low values. +By default this is false for backward compatibility with older +versions of this module. + +$apt_debian_url, $apt_security_url, $apt_backports_url, $apt_volatile_url +------------------------------------------------------------------------- + +These variables allow to override the default APT mirrors respectively +used for the standard Debian archives, the Debian security archive, +the Debian official backports and the Debian Volatile archive. + +$apt_ubuntu_url +--------------- + +These variables allows to override the default APT mirror used for all +standard Ubuntu archives (including updates, security, backports). + +$apt_repos +---------- + +If this variable is set the default repositories list ("main contrib non-free") +is overriden. + Classes ======= -This module contains only the apt class, which sets up all described -functionality. +apt +--- + +The apt class sets up all documented functionality but cron-apt. + +apt::cron::download +------------------- + +This class sets up cron-apt so that it downloads upgradable packages, +does not actually do any upgrade and email when the output changes. + +apt::cron::dist-upgrade +----------------------- + +This class sets up cron-apt so that it dist-upgrades the system and +email when upgrades are performed. Defines ======= @@ -150,8 +212,6 @@ TODO Enable debian-archive-keyring handling for sarge, lenny and sid. -Enable selection of country-specific mirrors. - Currently this module updates the caches on every run. Running dselect update is a expensive operation and should be done only on schedule by using apticron. Sometimes -- especially when initially starting management or deploying new |