-# Class: apt
+# == Class: apt
#
# This module manages the initial configuration of apt.
#
-# Parameters:
-# The parameters listed here are not required in general and were
-# added for use cases related to development environments.
-# disable_keys - disables the requirement for all packages to be signed
-# always_apt_update - rather apt should be updated on every run (intended
-# for development environments where package updates are frequent
-# purge_sources_list - Accepts true or false. Defaults to false If set to
-# true, Puppet will purge all unmanaged entries from sources.list"
-# purge_sources_list_d - Accepts true or false. Defaults to false. If set
-# to false, Puppet will purge all unmanaged entries from sources.list.d
+# The parameters listed here are not required in general and were
+# added for use cases related to development environments.
#
-# Actions:
+# === Parameters
#
-# Requires:
+# [*disable_keys*]
+# Disables the requirement for all packages to be signed
+#
+# [*always_apt_update*]
+# Rather apt should be updated on every run (intended
+# for development environments where package updates are frequent)
+#
+# [*apt_update_frequency*]
+# String: Supported values:
+# **always**: Will fire `apt-get update` at every puppet run. Intended to
+# deprecate the `always_apt_update` parameter.
+# *daily**: Trigger `apt-get update` if the value of the fact
+# `apt_update_last_success` is less than current epoch time - 86400.
+# *notifying the apt_update exec will trigger apt-get update regardless*
+# *weekly**: Trigger `apt-get update` if the value of the fact
+# `apt_update_last_success` is less than current epoch time - 604800.
+# *notifying the apt_update exec will trigger apt-get update regardless*
+# *reluctantly**: *Default* only run apt-get update if the exec resource `apt_update` is notified.
+#
+# [*purge_sources_list*]
+# Accepts true or false. Defaults to false If set to
+# true, Puppet will purge all unmanaged entries from sources.list
+#
+# [*purge_sources_list_d*]
+# Accepts true or false. Defaults to false. If set
+# to true, Puppet will purge all unmanaged entries from sources.list.d
+#
+# [*update_timeout*]
+# Overrides the exec timeout in seconds for apt-get update.
+# If not set defaults to Exec's default (300)
+#
+# [*update_tries*]
+# Number of times that `apt-get update` will be tried. Use this
+# to work around transient DNS and HTTP errors. By default, the command
+# will only be run once.
+#
+# === Examples
+#
+# class { 'apt': }
+#
+# === Requires
+#
+# puppetlabs/stdlib >= 2.2.1
#
-# Sample Usage:
-# class { 'apt': }
class apt(
- $always_apt_update = false,
- $disable_keys = undef,
- $proxy_host = false,
- $proxy_port = '8080',
- $purge_sources_list = false,
- $purge_sources_list_d = false
+ $always_apt_update = false,
+ $apt_update_frequency = 'reluctantly',
+ $disable_keys = undef,
+ $proxy_host = undef,
+ $proxy_port = '8080',
+ $purge_sources_list = false,
+ $purge_sources_list_d = false,
+ $purge_preferences = false,
+ $purge_preferences_d = false,
+ $update_timeout = undef,
+ $update_tries = undef,
+ $sources = undef,
+ $fancy_progress = undef
) {
+ if $::osfamily != 'Debian' {
+ fail('This module only works on Debian or derivatives like Ubuntu')
+ }
+
+ $frequency_options = ['always','daily','weekly','reluctantly']
+ validate_re($apt_update_frequency, $frequency_options)
include apt::params
include apt::update
- validate_bool($purge_sources_list, $purge_sources_list_d)
-
- if ! defined(Package['python-software-properties']) {
- package { 'python-software-properties': }
- }
+ validate_bool($purge_sources_list, $purge_sources_list_d,
+ $purge_preferences, $purge_preferences_d)
$sources_list_content = $purge_sources_list ? {
false => undef,
}
}
+ file { '/etc/apt/apt.conf.d/15update-stamp':
+ ensure => 'file',
+ content => template('apt/_header.erb', 'apt/15update-stamp.erb'),
+ group => 'root',
+ mode => '0644',
+ owner => 'root',
+ }
+
$root = $apt::params::root
$apt_conf_d = $apt::params::apt_conf_d
$sources_list_d = $apt::params::sources_list_d
+ $preferences_d = $apt::params::preferences_d
$provider = $apt::params::provider
file { 'sources.list':
notify => Exec['apt_update'],
}
+ if $purge_preferences {
+ file { 'apt-preferences':
+ ensure => absent,
+ path => "${root}/preferences",
+ }
+ }
+
+ file { 'preferences.d':
+ ensure => directory,
+ path => $preferences_d,
+ owner => root,
+ group => root,
+ purge => $purge_preferences_d,
+ recurse => $purge_preferences_d,
+ }
+
+ case $fancy_progress {
+ true: {
+ file { '99progressbar':
+ ensure => present,
+ content => template('apt/_header.erb', 'apt/progressbar.erb'),
+ path => "${apt_conf_d}/99progressbar",
+ }
+ }
+ false: {
+ file { '99progressbar':
+ ensure => absent,
+ path => "${apt_conf_d}/99progressbar",
+ }
+ }
+ undef: {} # do nothing
+ default: { fail('Valid values for fancy_progress are true or false') }
+ }
+
case $disable_keys {
true: {
file { '99unauth':
ensure => present,
- content => "APT::Get::AllowUnauthenticated 1;\n",
+ content => template('apt/_header.erb', 'apt/unauth.erb'),
path => "${apt_conf_d}/99unauth",
}
}
default: { fail('Valid values for disable_keys are true or false') }
}
- if ($proxy_host) {
- file { 'configure-apt-proxy':
- path => "${apt_conf_d}/proxy",
- content => "Acquire::http::Proxy \"http://${proxy_host}:${proxy_port}\";",
- notify => Exec['apt_update'],
+ case $proxy_host {
+ false, '', undef: {
+ file { '01proxy':
+ ensure => absent,
+ path => "${apt_conf_d}/01proxy",
+ notify => Exec['apt_update'],
+ }
+ }
+ default: {
+ file { '01proxy':
+ ensure => present,
+ path => "${apt_conf_d}/01proxy",
+ content => template('apt/_header.erb', 'apt/proxy.erb'),
+ notify => Exec['apt_update'],
+ mode => '0644',
+ owner => root,
+ group => root,
+ }
}
}
+
+ file { 'old-proxy-file':
+ ensure => absent,
+ path => "${apt_conf_d}/proxy",
+ notify => Exec['apt_update'],
+ }
+
+ # Need anchor to provide containment for dependencies.
+ anchor { 'apt::update':
+ require => Class['apt::update'],
+ }
+
+ # manage sources if present
+ if $sources != undef {
+ validate_hash($sources)
+ create_resources('apt::source', $sources)
+ }
}