X-Git-Url: https://review.fuel-infra.org/gitweb?a=blobdiff_plain;f=README.md;h=3168f518cb212451ed2db81e11d629adf68b04b9;hb=3f6863ac4c97f834bebc811852452b073d202682;hp=30dfed24164b11a747ed2e7e4b83e0f9e63e98b4;hpb=252bb9fef6f3d8ee1e6710a5d2e68ba81f6e2ae2;p=puppet-modules%2Fpuppetlabs-apt.git diff --git a/README.md b/README.md index 30dfed2..3168f51 100644 --- a/README.md +++ b/README.md @@ -58,11 +58,11 @@ include apt **Warning:** Using short key IDs presents a serious security issue, potentially leaving you open to collision attacks. We recommend you always use full fingerprints to identify your GPG keys. This module allows short keys, but issues a security warning if you use them. -Declare the `apt::key` class: +Declare the `apt::key` defined type: ```puppet apt::key { 'puppetlabs': - id => '47B320EB4C7C375AA9DAE1A01054B7A24BD6EC30', + id => '6F6B15509CF8E59E6E469F327F438280EF8D349F', server => 'pgp.mit.edu', options => 'http-proxy="http://proxyuser:proxypass@example.org:3128"', } @@ -147,10 +147,10 @@ apt::source { 'puppetlabs': location => 'http://apt.puppetlabs.com', repos => 'main', key => { - 'id' => '47B320EB4C7C375AA9DAE1A01054B7A24BD6EC30', + 'id' => '6F6B15509CF8E59E6E469F327F438280EF8D349F', 'server' => 'pgp.mit.edu', }, -}, +} ``` ### Configure Apt from Hiera @@ -178,7 +178,7 @@ apt::sources: location: 'http://apt.puppetlabs.com' repos: 'main' key: - id: '47B320EB4C7C375AA9DAE1A01054B7A24BD6EC30' + id: '6F6B15509CF8E59E6E469F327F438280EF8D349F' server: 'pgp.mit.edu' ``` @@ -192,21 +192,21 @@ apt::source { "archive.ubuntu.com-${lsbdistcodename}": key => '630239CC130E1A7FD81A27B140976EAF437D05B5', repos => 'main universe multiverse restricted', } - + apt::source { "archive.ubuntu.com-${lsbdistcodename}-security": location => 'http://archive.ubuntu.com/ubuntu', key => '630239CC130E1A7FD81A27B140976EAF437D05B5', repos => 'main universe multiverse restricted', release => "${lsbdistcodename}-security" } - + apt::source { "archive.ubuntu.com-${lsbdistcodename}-updates": location => 'http://archive.ubuntu.com/ubuntu', key => '630239CC130E1A7FD81A27B140976EAF437D05B5', repos => 'main universe multiverse restricted', release => "${lsbdistcodename}-updates" } - + apt::source { "archive.ubuntu.com-${lsbdistcodename}-backports": location => 'http://archive.ubuntu.com/ubuntu', key => '630239CC130E1A7FD81A27B140976EAF437D05B5', @@ -260,6 +260,8 @@ Main class, includes all other classes. ##### Parameters (all optional) +* `confs`: Creates new `apt::conf` resources. Valid options: a hash to be passed to the [`create_resources` function](https://docs.puppetlabs.com/references/latest/function.html#createresources). Default: {}. + * `keys`: Creates new `apt::key` resources. Valid options: a hash to be passed to the [`create_resources` function](https://docs.puppetlabs.com/references/latest/function.html#createresources). Default: {}. * `ppas`: Creates new `apt::ppa` resources. Valid options: a hash to be passed to the [`create_resources` function](https://docs.puppetlabs.com/references/latest/function.html#createresources). Default: {}. @@ -420,8 +422,8 @@ Manages PPA repositories using `add-apt-repository`. Not supported on Debian. * `package_name`: Names the package that provides the `apt-add-repository` command. Valid options: a string. Defaults: * Lucid and Precise: 'python-software-properties' - * Trusty, Utopic, and Vivid: 'software-properties-common' - * All others: undef + * Trusty and newer: 'software-properties-common' + * All others: 'python-software-properties' * `release`: *Optional if lsb-release is installed (unless you're using a different release than indicated by lsb-release, e.g., Linux Mint).* Specifies the operating system of your node. Valid options: a string containing a valid LSB distribution codename. Default: "$lsbdistcodename". @@ -485,6 +487,8 @@ Manages the Apt sources in `/etc/apt/sources.list.d/`. * `trusted_source`: Specifies whether to authenticate packages from this release, even if the Release file is not signed or the signature can't be checked. Valid options: 'true' and 'false'. Default: undef. This parameter is **deprecated** and will be removed in a future version of the module. +* `notify_update`: *Optional.* Specifies whether to trigger an `apt-get update` run. Valid options: 'true' and 'false'. Default: 'true'. + #### Type: `apt_key` Manages the GPG keys that Apt uses to authenticate packages.