X-Git-Url: https://review.fuel-infra.org/gitweb?a=blobdiff_plain;f=README.md;h=186c2c2d3ccf3b9e93212a815ec7adf41b352b5d;hb=d88040814352e08f9178d4ce2fd81f76160f8b9e;hp=1c06e1760c40fde7ce3443be31cf52daba6d6295;hpb=0e3220711ba9ce05715c39c22771e34b81b41382;p=puppet-modules%2Fpuppetlabs-apt.git diff --git a/README.md b/README.md index 1c06e17..186c2c2 100644 --- a/README.md +++ b/README.md @@ -8,7 +8,7 @@ The apt module provides a simple interface for managing Apt source, key, and def The apt module automates obtaining and installing software packages on \*nix systems. -**Note**: While this module allows the use of short keys, **we urge you NOT to use short keys**, as they pose a serious security issue by opening you up to collision attacks. +**Note**: While this module allows the use of short keys, **warnings are thrown if a full fingerprint is not used**, as they pose a serious security issue by opening you up to collision attacks. ## Setup @@ -74,12 +74,11 @@ class { 'apt': ``` class { 'apt::unattended_upgrades': - origins => $::apt::params::origins, - blacklist => [], - update => '1', - download => '1', - upgrade => '1', - autoclean => '7', + blacklist => [], + update => '1', + download => '1', + upgrade => '1', + autoclean => '7', } ``` @@ -201,7 +200,7 @@ class { 'apt': release => 'unstable', repos => 'main contrib non-free', required_packages => 'debian-keyring debian-archive-keyring', - key => '8B48AD6246925553', + key => 'A1BD8E9D78F7FE5C3E65D8AF8B48AD6246925553', key_server => 'subkeys.pgp.net', pin => '-10', include_src => true, @@ -277,6 +276,7 @@ apt::sources: ####apt::unattended_upgrades +* `legacy_origin`: If set to true, use the old `Unattended-Upgrade::Allowed-Origins` variable. If false, use `Unattended-Upgrade::Origins-Pattern`. OS-dependent defaults are defined in `apt::params`. * `origins`: The repositories from which to automatically upgrade included packages. * `blacklist`: A list of packages to **not** automatically upgrade. * `update`: How often, in days, to run `apt-get update`. @@ -332,6 +332,14 @@ apt::sources: It is recommended to read the manpage 'apt_preferences(5)' +####apt::ppa + +* `ensure`: Whether we are adding or removing the PPA. Can be 'present' or 'absent'. Defaults to 'present'. +* `release`: The codename for the operating system you're running. Defaults to `$lsbdistcodename`. Required if lsb-release is not installed. +* `options`: Options to be passed to the `apt-add-repository` command. OS-dependent defaults are set in `apt::params`. +* `package_name`: The package that provides the `apt-add-repository` command. OS-dependent defaults are set in `apt::params`. +* `package_manage`: Whether or not to manage the package providing `apt-add-repository`. Defaults to true. + ### Testing The apt module is mostly a collection of defined resource types, which provide reusable logic for managing Apt. It provides smoke tests for testing functionality on a target system, as well as spec tests for checking a compiled catalog against an expected set of resources.