README.md

   1 # Apt module for Puppet
   2
   3 ## Description
   4 Provides helpful definitions for dealing with Apt.
   5
   6 ## Usage
   7
   8 ### apt::force
   9 Force a package to be installed from a specific release.  Useful when using repositoires like Debian unstable in Ubuntu.
  10 <pre>
  11 apt::force { "glusterfs-server":
  12         release => "unstable",
  13         version => '3.0.3',
  14         require => Apt::Source["debian_unstable"],
  15 }
  16 </pre>
  17
  18 ### apt::pin
  19 Add an apt pin for a certain release.
  20 <pre>
  21 apt::pin { "karmic": priority => 700 }
  22 apt::pin { "karmic-updates": priority => 700 }
  23 apt::pin { "karmic-security": priority => 700 }
  24 </pre>
  25
  26 ### apt::ppa
  27 Add a ppa repository using `add-apt-repository`.  Somewhat experimental.
  28 <pre>
  29 apt::ppa { "ppa:drizzle-developers/ppa" }
  30 </pre>
  31
  32 ### apt::release
  33 Set the default apt release.  Useful when using repositoires like Debian unstable in Ubuntu.
  34 <pre>
  35 apt::release { "karmic": }
  36 </pre>
  37
  38 ## apt::source
  39 Add an apt source to `/etc/apt/sources.list.d/`.
  40 <pre>
  41 apt::source { "debian_unstable":
  42         location => "http://debian.mirror.iweb.ca/debian/",
  43         release => "unstable",
  44         repos => "main contrib non-free",
  45         required_packages => "debian-keyring debian-archive-keyring",
  46         key => "55BE302B",
  47         key_server => "subkeys.pgp.net",
  48         pin => "-10"
  49 }
  50 </pre>