1 # Apt module for Puppet
3 [![Build Status](https://travis-ci.org/puppetlabs/puppetlabs-apt.png?branch=master)](https://travis-ci.org/puppetlabs/puppetlabs-apt)
6 Provides helpful definitions for dealing with Apt.
11 The apt class provides a number of common resources and options which
12 are shared by the various defined types in this module. This class
13 should always be included in your manifests if you are using the `apt`
17 always_apt_update => false,
18 disable_keys => undef,
21 purge_sources_list => false,
22 purge_sources_list_d => false,
23 purge_preferences_d => false
27 Install the build depends of a specified package.
29 apt::builddep { "glusterfs-server": }
32 Force a package to be installed from a specific release. Useful when
33 using repositories like Debian unstable in Ubuntu.
35 apt::force { "glusterfs-server":
36 release => "unstable",
38 require => Apt::Source["debian_unstable"],
42 Add an apt pin for a certain release.
44 apt::pin { "karmic": priority => 700 }
45 apt::pin { "karmic-updates": priority => 700 }
46 apt::pin { "karmic-security": priority => 700 }
49 Add a ppa repository using `add-apt-repository`. Somewhat experimental.
51 apt::ppa { "ppa:drizzle-developers/ppa": }
54 Set the default apt release. Useful when using repositories like
55 Debian unstable in Ubuntu.
57 apt::release { "karmic": }
60 Add an apt source to `/etc/apt/sources.list.d/`.
62 apt::source { "debian_unstable":
63 location => "http://debian.mirror.iweb.ca/debian/",
64 release => "unstable",
65 repos => "main contrib non-free",
66 required_packages => "debian-keyring debian-archive-keyring",
68 key_server => "subkeys.pgp.net",
73 This source will configure your system for the Puppet Labs APT
76 apt::source { 'puppetlabs':
77 location => 'http://apt.puppetlabs.com',
80 key_server => 'pgp.mit.edu',
84 Add a key to the list of keys used by apt to authenticate packages.
86 apt::key { "puppetlabs":
88 key_server => "pgp.mit.edu",
93 key_source => "http://pkg.jenkins-ci.org/debian/jenkins-ci.org.key",
96 Note that use of the "key_source" parameter requires wget to be
97 installed and working.
101 A lot of great people have contributed to this module. A somewhat
102 current list follows.
104 Ben Godfrey <ben.godfrey@wonga.com>
105 Branan Purvine-Riley <branan@puppetlabs.com>
106 Christian G. Warden <cwarden@xerus.org>
107 Dan Bode <bodepd@gmail.com> <dan@puppetlabs.com>
108 Garrett Honeycutt <github@garretthoneycutt.com>
109 Jeff Wallace <jeff@evolvingweb.ca> <jeff@tjwallace.ca>
110 Ken Barber <ken@bob.sh>
111 Matthaus Litteken <matthaus@puppetlabs.com> <mlitteken@gmail.com>
112 Matthias Pigulla <mp@webfactory.de>
113 Monty Taylor <mordred@inaugust.com>
114 Peter Drake <pdrake@allplayers.com>
115 Reid Vandewiele <marut@cat.pdx.edu>
116 Robert Navarro <rnavarro@phiivo.com>
117 Ryan Coleman <ryan@puppetlabs.com>
118 Scott McLeod <scott.mcleod@theice.com>
119 Spencer Krum <spencer@puppetlabs.com>
120 William Van Hevelingen <blkperl@cat.pdx.edu> <wvan13@gmail.com>
121 Zach Leslie <zach@puppetlabs.com>