# Apt module for Puppet

[![Build Status](https://travis-ci.org/puppetlabs/puppetlabs-apt.png?branch=master)](https://travis-ci.org/puppetlabs/puppetlabs-apt)

## Description
Provides helpful definitions for dealing with Apt.

## Usage

### apt
The apt class provides a number of common resources and options which
are shared by the various defined types in this module. This class
should always be included in your manifests if you are using the `apt`
module.

    class { 'apt':
      always_apt_update    => false,
      disable_keys         => undef,
      proxy_host           => false,
      proxy_port           => '8080',
      purge_sources_list   => false,
      purge_sources_list_d => false,
      purge_preferences_d  => false
    }

### apt::builddep
Install the build depends of a specified package.

    apt::builddep { "glusterfs-server": }

### apt::force
Force a package to be installed from a specific release.  Useful when
using repositories like Debian unstable in Ubuntu.

    apt::force { "glusterfs-server":
	  release => "unstable",
	  version => '3.0.3',
	  require => Apt::Source["debian_unstable"],
    }

### apt::pin
Add an apt pin for a certain release.

    apt::pin { "karmic": priority => 700 }
    apt::pin { "karmic-updates": priority => 700 }
    apt::pin { "karmic-security": priority => 700 }

### apt::ppa
Add a ppa repository using `add-apt-repository`.  Somewhat experimental.

    apt::ppa { "ppa:drizzle-developers/ppa": }

### apt::release
Set the default apt release.  Useful when using repositories like
Debian unstable in Ubuntu.

    apt::release { "karmic": }

### apt::source
Add an apt source to `/etc/apt/sources.list.d/`.

    apt::source { "debian_unstable":
      location          => "http://debian.mirror.iweb.ca/debian/",
      release           => "unstable",
      repos             => "main contrib non-free",
      required_packages => "debian-keyring debian-archive-keyring",
      key               => "55BE302B",
      key_server        => "subkeys.pgp.net",
      pin               => "-10",
      include_src       => true
    }

This source will configure your system for the Puppet Labs APT
repository.

    apt::source { 'puppetlabs':
      location   => 'http://apt.puppetlabs.com',
      repos      => 'main',
      key        => '4BD6EC30',
      key_server => 'pgp.mit.edu',
    }

### apt::key
Add a key to the list of keys used by apt to authenticate packages.

    apt::key { "puppetlabs":
      key        => "4BD6EC30",
      key_server => "pgp.mit.edu",
    }

    apt::key { "jenkins":
      key        => "D50582E6",
      key_source => "http://pkg.jenkins-ci.org/debian/jenkins-ci.org.key",
    }

Note that use of the "key_source" parameter requires wget to be
installed and working.


## Contributors
A lot of great people have contributed to this module. A somewhat
current list follows.

Ben Godfrey <ben.godfrey@wonga.com>
Branan Purvine-Riley <branan@puppetlabs.com>
Christian G. Warden <cwarden@xerus.org>  
Dan Bode <bodepd@gmail.com> <dan@puppetlabs.com>  
Garrett Honeycutt <github@garretthoneycutt.com>  
Jeff Wallace <jeff@evolvingweb.ca> <jeff@tjwallace.ca>  
Ken Barber <ken@bob.sh>  
Matthaus Litteken <matthaus@puppetlabs.com> <mlitteken@gmail.com>  
Matthias Pigulla <mp@webfactory.de>  
Monty Taylor <mordred@inaugust.com>  
Peter Drake <pdrake@allplayers.com>  
Reid Vandewiele <marut@cat.pdx.edu>  
Robert Navarro <rnavarro@phiivo.com>  
Ryan Coleman <ryan@puppetlabs.com>  
Scott McLeod <scott.mcleod@theice.com>  
Spencer Krum <spencer@puppetlabs.com>  
William Van Hevelingen <blkperl@cat.pdx.edu> <wvan13@gmail.com>  
Zach Leslie <zach@puppetlabs.com>