No description
Find a file
Reid Vandewiele 8cdaf855a1 (#12823) Add apt::key defined type and modify apt::source to use it
Adding this defined type allows puppet to add keys to the apt keystore without
needing to add a corresponding source; it also adds the "key_source" parameter
for wget'ing keys from arbitrary URLs, and allows for keys to be explicity
removed.

apt::key allows a key to be ensured present multiple times to account for
apt::source resources that all reference the same key. However, this means
that it is possible for a given key to be defined multiple times with
differing source parameters. e.g.

apt::key { "Add key: 4BD6EC30 from Apt::Source bunny":
  key        => "4BD6EC30",
  key_server => "pgp.mit.edu",
}

apt::key { "Add key: 4BD6EC30 from Apt::Source rabbit":
  key        => "4BD6EC30",
  key_server => "keyserver.ubuntu.com",
}

The defined type will accept both definitions and will create multiple exec
resources. This was deemed preferable to the alternative (creating only one
exec resource) in that one broken definition won't hose an entire catalog. If
one definition fails to install the key because of a bad "key_server", the
next apt::key that uses the key will get it done.
2012-03-01 14:15:52 -08:00
manifests (#12823) Add apt::key defined type and modify apt::source to use it 2012-03-01 14:15:52 -08:00
spec (#12823) Add apt::key defined type and modify apt::source to use it 2012-03-01 14:15:52 -08:00
templates First commit 2010-04-27 16:38:28 -04:00
tests Test two sources with the same key 2012-02-23 15:44:26 -08:00
.gitignore ignore swap files. 2011-05-30 10:25:11 -07:00
LICENSE Update LICENSE. 2011-04-18 11:36:04 -04:00
Modulefile Add Modulefile to puppet-apt 2012-02-23 14:01:31 -08:00
Rakefile (#10451) Add test coverage to apt::ppa 2012-01-03 17:03:24 -08:00
README.md (#12823) Add apt::key defined type and modify apt::source to use it 2012-03-01 14:15:52 -08:00

Apt module for Puppet

Description

Provides helpful definitions for dealing with Apt.

Usage

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

### 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.

}