[PUP-8008] puppet module install fails to install apt 4.2.0 Created: 2017/10/02  Updated: 2018/09/11  Resolved: 2017/10/27

Status: Closed
Project: Puppet
Component/s: PMT
Affects Version/s: None
Fix Version/s: PUP 4.10.9, PUP 5.3.3

Type: CI Blocker Priority: Major
Reporter: Thomas Honey Assignee: Unassigned
Resolution: Fixed Votes: 0
Labels: None
Remaining Estimate: Not Specified
Time Spent: Not Specified
Original Estimate: Not Specified
Environment:

All OSes tested against PE. Affects the latest builds in hoyt, and also the 2017.2


Issue Links:
Relates
relates to FORGE-446 paging/sorting error causing failures... Closed
relates to PUP-8126 puppet module install --module_reposi... Closed
CI Pipeline/s:
modules
Team: Platform Core
Release Notes: Bug Fix
Release Notes Summary: Puppet module install may previously have been unable to install a module from the Forge (like apache or stdlib), when there were many versions of said module available. A bug related to URL encoding in paginated results has been resolved.
QA Risk Assessment: Needs Assessment

 Description   

https://jenkins-master-prod-1.delivery.puppetlabs.net/view/modules/view/linux/view/postgresql/view/master/job/forge-module_puppetlabs-postgresql_intn-sys_full-pe-current-master/PLATFORM=centos7-64default.a-redhat7-64mdca,WORKER_LABEL=beaker/99/consoleFull

03:12:34 Failure/Error: install_module_dependencies_on(hosts)
03:12:34 Beaker::Host::CommandFailure:
03:12:34   Host 'uacd2e1mnxhnx0t.delivery.puppetlabs.net' exited with 1 running:
03:12:34    puppet module install puppetlabs-apt -v 4.2.0
03:12:34   Last 10 lines of output were:
03:12:34   	Notice: Preparing to install into /etc/puppetlabs/code/environments/production/modules ...
03:12:34   	Notice: Downloading from https://forgeapi.puppet.com ...
03:12:34   	Error: Could not install 'puppetlabs-apt' (v4.2.0)
03:12:34   	  No releases matching '4.2.0' are available from https://forgeapi.puppet.com

If we run with verbose and debug, we can see that it is using pagination, but not checking the next page.

[root@n8vja2lvd96dr50 ~]# puppet module install puppetlabs-apt -v 4.2.0 --force --verbose --debug
Debug: Runtime environment: puppet_version=5.3.1, ruby_version=2.4.1, run_mode=user, default_encoding=UTF-8
Notice: Preparing to install into /etc/puppetlabs/code/environments/production/modules ...
Debug: puppetlabs-lvm initialized for i18n:
Debug: puppetlabs-facter_task initialized for i18n:
Debug: puppetlabs-package initialized for i18n:
Debug: puppetlabs-pe_accounts initialized for i18n:
Debug: puppetlabs-pe_concat initialized for i18n:
Debug: puppetlabs-pe_hocon initialized for i18n:
Debug: puppetlabs-pe_infrastructure initialized for i18n:
Debug: puppetlabs-pe_inifile initialized for i18n:
Debug: puppetlabs-pe_install initialized for i18n:
Debug: puppetlabs-pe_java_ks initialized for i18n:
Debug: puppetlabs-pe_nginx initialized for i18n:
Debug: puppetlabs-pe_postgresql initialized for i18n:
Debug: puppetlabs-pe_puppet_authorization initialized for i18n:
Debug: puppetlabs-pe_r10k initialized for i18n:
Debug: puppetlabs-pe_razor initialized for i18n:
Debug: puppetlabs-pe_repo initialized for i18n:
Debug: puppetlabs-pe_staging initialized for i18n:
Debug: puppetlabs-pe_support_script initialized for i18n:
Debug: puppetlabs-puppet_conf initialized for i18n:
Debug: puppetlabs-puppet_enterprise initialized for i18n:
Debug: puppetlabs-service initialized for i18n:
Notice: Downloading from https://forgeapi.puppet.com ...
Debug: HTTP GET https://forgeapi.puppet.com/v3/releases?module=puppetlabs-apt&module_groups=base pe_only
Debug: Evicting cache entry for environment 'production'
Debug: Caching environment 'production' (ttl = 0 sec)
Debug: HTTP GET https://forgeapi.puppet.com/v3/releases?module=puppetlabs-apt&module_groups=base+pe_only&limit=20&offset=20

This is prevents users from installing the latest version of postrgesql. It may also affect other modules



 Comments   
Comment by David Mallon [ 2017/10/02 ]

Geoff Nichols this is an issue we ran into on the Modules team but it will potentially be affecting multiple teams plus the external community. Essentially if a module has more than 20 releases/versions the issue above arises.

Would you be able to get some to look at it today?

Thanks

David

Comment by Thomas Honey [ 2017/10/02 ]

That looks very likely !!

Comment by David Mallon [ 2017/10/02 ]

I've passed the ticket on to Jesse Scott to investigate too

Comment by Paula Muir [ 2017/10/03 ]

We seem to see this happening consistently after a release of stdlib also.
I raised the following issue a while back https://tickets.puppetlabs.com/browse/FM-6359

Going to mark as a duplicate of this as it seems to be the same issue but with a different module.

Comment by Helen Campbell [ 2017/10/04 ]

So this issue seems to crop up every once in a while, and similarly to those occasions within a few days of us seeing these errors they go away.
This bug currently cannot be reproduced, and we are not entirely sure how to reproduce it.

The closest guess to reproduce would be to keep an eye out after stdlib or apt is released, though we would have quite a short amount of time in which to diagnose the problem, and thats if we can actually reproduce it.

Comment by Thomas Honey [ 2017/10/04 ]

This is still failing in jenkins and failing locally for me.

https://jenkins-master-prod-1.delivery.puppetlabs.net/view/modules/view/linux/view/postgresql/view/master/job/forge-module_puppetlabs-postgresql_intn-sys_full-pe-current-master/102/

Comment by Thomas Honey [ 2017/10/04 ]

BEAKER_destroy=no PUPPET_INSTALL_TYPE=pe BEAKER_PE_DIR=http://enterprise.delivery.puppetlabs.net/2017.3/ci-ready BEAKER_set=centos7-pooler bundle exec rspec spec/acceptance/sql_task_spec.rb
/Users/tp/workspace/git/puppetlabs-postgresql/.bundle/gems/ruby/2.3.0/gems/beaker-rspec-6.1.0/lib/beaker-rspec/helpers/serverspec.rb:43: warning: already initialized constant Module::VALID_OPTIONS_KEYS
/Users/tp/workspace/git/puppetlabs-postgresql/.bundle/gems/ruby/2.3.0/gems/specinfra-2.67.3/lib/specinfra/configuration.rb:4: warning: previous definition of VALID_OPTIONS_KEYS was here
Beaker::Hypervisor, found some vcloud boxes to create
Requesting VM set from vmpooler (with authentication token)
Using available host 'hzy8ciiuvdx9ys8.delivery.puppetlabs.net' (rhel7)
Spent 0.31 seconds grabbing VMs
Tagging vmpooler VMs
Spent 0.31 seconds tagging VMs
Disabling updates.puppetlabs.com by modifying hosts file to resolve updates to 127.0.0.1 on hzy8ciiuvdx9ys8.delivery.puppetlabs.net

  • Performing a standard monolithic install with frictionless agents
  • Generate the /tmp/2017-10-04_14.31.05.Mon7IH/pe.conf on hzy8ciiuvdx9ys8.delivery.puppetlabs.net
    localhost $ scp /var/folders/jp/c0flr1gd593fm2jsn3_9x9_00000gn/T/beaker20171004-69177-xd1204 rhel7:/tmp/2017-10-04_14.31.05.Mon7IH/pe.conf {:ignore => }
  • Setup frictionless installer on the master
  • Install agents
    Attempting to execute against an empty array of hosts ([], filtered to []), no execution will occur
  • Sign agent certificates
  • Stop puppet agents to avoid interfering with tests
  • Run puppet to setup mcollective and pxp-agent
    Attempting to execute against an empty array of hosts ([], filtered to []), no execution will occur
  • Run puppet a second time on the primary to populate services.conf (PE-19054)
    localhost $ scp /Users/tp/workspace/git/puppetlabs-postgresql rhel7:/etc/puppetlabs/code/modules {:ignore => [".bundle", ".git", ".idea", ".vagrant", ".vendor", "vendor", "acceptance", "bundle", "spec", "tests", "log", ".svn", "junit", "pkg", "example", ".", ".."]}

An error occurred while loading ./spec/acceptance/sql_task_spec.rb.
Failure/Error: install_module_dependencies_on(hosts)
Beaker::Host::CommandFailure:
Host 'hzy8ciiuvdx9ys8.delivery.puppetlabs.net' exited with 1 running:
puppet module install puppetlabs-apt -v 4.2.0
Last 10 lines of output were:
Notice: Preparing to install into /etc/puppetlabs/code/environments/production/modules ...
Notice: Downloading from https://forgeapi.puppet.com ...
Error: Could not install 'puppetlabs-apt' (v4.2.0)
No releases matching '4.2.0' are available from https://forgeapi.puppet.com

Comment by Jesse Scott [ 2017/10/04 ]

Can we see what IP "forgeapi.puppet.com" is resolving to during the tests on those hosts?

Comment by Eric Putnam [ 2017/10/05 ]

Jesse Scott,

[root@npzpfc9s27j2zhs ~]# ping forgeapi.puppet.com
PING forge-eip-prod.puppetlabs.com (52.10.130.237) 56(84) bytes of data.
64 bytes from ec2-52-10-130-237.us-west-2.compute.amazonaws.com (52.10.130.237): icmp_seq=1 ttl=49 time=4.77 ms
64 bytes from ec2-52-10-130-237.us-west-2.compute.amazonaws.com (52.10.130.237): icmp_seq=2 ttl=49 time=4.79 ms
64 bytes from ec2-52-10-130-237.us-west-2.compute.amazonaws.com (52.10.130.237): icmp_seq=3 ttl=49 time=4.82 ms
64 bytes from ec2-52-10-130-237.us-west-2.compute.amazonaws.com (52.10.130.237): icmp_seq=4 ttl=49 time=4.86 ms

Comment by Eric Putnam [ 2017/10/05 ]

also, payload from api call on the same machine (where puppetlabs-apt install failed)

[root@npzpfc9s27j2zhs ~]# curl https://forgeapi.puppetlabs.com:443/v3/modules/puppetlabs-apt
{
  "uri": "/v3/modules/puppetlabs-apt",
  "slug": "puppetlabs-apt",
  "name": "apt",
  "downloads": 11410368,
  "created_at": "2012-03-08 03:28:14 -0800",
  "updated_at": "2017-09-26 15:22:09 -0700",
  "deprecated_at": null,
  "deprecated_for": null,
  "superseded_by": null,
  "supported": true,
  "endorsement": "supported",
  "module_group": "base",
  "owner": {
    "uri": "/v3/users/puppetlabs",
    "slug": "puppetlabs",
    "username": "puppetlabs",
    "gravatar_id": "fdd009b7c1ec96e088b389f773e87aec"
  },
  "current_release": {
    "uri": "/v3/releases/puppetlabs-apt-4.2.0",
    "slug": "puppetlabs-apt-4.2.0",
    "module": {
      "uri": "/v3/modules/puppetlabs-apt",
      "slug": "puppetlabs-apt",
      "name": "apt",
      "deprecated_at": null,
      "owner": {
        "uri": "/v3/users/puppetlabs",
        "slug": "puppetlabs",
        "username": "puppetlabs",
        "gravatar_id": "fdd009b7c1ec96e088b389f773e87aec"
      }
    },
    "version": "4.2.0",
    "metadata": {
      "name": "puppetlabs-apt",
      "version": "4.2.0",
      "author": "Puppet Labs",
      "summary": "Provides an interface for managing Apt source, key, and definitions with Puppet",
      "license": "Apache-2.0",
      "source": "https://github.com/puppetlabs/puppetlabs-apt",
      "project_page": "https://github.com/puppetlabs/puppetlabs-apt",
      "issues_url": "https://tickets.puppetlabs.com/browse/MODULES",
      "dependencies": [
        {
          "name": "puppetlabs/stdlib",
          "version_requirement": ">= 4.16.0 < 5.0.0"
        }
      ],
      "data_provider": null,
      "operatingsystem_support": [
        {
          "operatingsystem": "Debian",
          "operatingsystemrelease": [
            "7",
            "8",
            "9"
          ]
        },
        {
          "operatingsystem": "Ubuntu",
          "operatingsystemrelease": [
            "14.04",
            "16.04"
          ]
        }
      ],
      "requirements": [
        {
          "name": "puppet",
          "version_requirement": ">= 4.7.0 < 6.0.0"
        }
      ]
    },
    "tags": [
      "debian",
      "apt",
      "ubuntu",
      "dpkg",
      "ppa",
      "apt-get",
      "aptitude"
    ],
    "supported": false,
    "validation_score": 100,
    "file_uri": "/v3/files/puppetlabs-apt-4.2.0.tar.gz",
    "file_size": 74697,
    "file_md5": "510b58c9c7f6ff04a66a620913fb9146",
    "downloads": 9174,
    "readme": "# apt\n\n#### Table of Contents\n\n\n2. [Module Description - What the module does and why it is useful](#module-description)\n3. [Setup - The basics of getting started with apt](#setup)\n    * [What apt affects](#what-apt-affects)\n    * [Beginning with apt](#beginning-with-apt)\n4. [Usage - Configuration options and additional functionality](#usage)\n    * [Add GPG keys](#add-gpg-keys)\n    * [Prioritize backports](#prioritize-backports)\n    * [Update the list of packages](#update-the-list-of-packages)\n    * [Pin a specific release](#pin-a-specific-release)\n    * [Add a Personal Package Archive repository](#add-a-personal-package-archive-repository)\n    * [Configure Apt from Hiera](#configure-apt-from-hiera)\n    * [Replace the default sources.list file](#replace-the-default-sourceslist-file)\n5. [Reference - An under-the-hood peek at what the module is doing and how](#reference)\n    * [Classes](#classes)\n    * [Defined Types](#defined-types)\n    * [Types](#types)\n    * [Facts](#facts)\n6. [Limitations - OS compatibility, etc.](#limitations)\n7. [Development - Guide for contributing to the module](#development)\n\n## Module Description\n\nThe apt module lets you use Puppet to manage Apt sources, keys, and other configuration options.\n\nApt (Advanced Package Tool) is a package manager available on Debian, Ubuntu, and several other operating systems. The apt module provides a series of classes, defines, types, and facts to help you automate Apt package management.\n\n**Note**: For this module to correctly autodetect which version of Debian/Ubuntu (or derivative) you're running, you need to make sure the 'lsb-release' package is installed. We highly recommend you either make this part of your provisioning layer, if you run many Debian or derivative systems, or ensure that you have Facter 2.2.0 or later installed, which will pull this dependency in for you.\n\n## Setup\n\n### What apt affects\n\n* Your system's `preferences` file and `preferences.d` directory\n* Your system's `sources.list` file and `sources.list.d` directory\n* System repositories\n* Authentication keys\n\n**Note:** This module offers `purge` parameters which, if set to 'true', **destroy** any configuration on the node's `sources.list(.d)` and `preferences(.d)` that you haven't declared through Puppet. The default for these parameters is 'false'.\n\n### Beginning with apt\n\nTo use the apt module with default parameters, declare the `apt` class.\n\n```puppet\ninclude apt\n```\n\n**Note:** The main `apt` class is required by all other classes, types, and defined types in this module. You must declare it whenever you use the module.\n\n## Usage\n\n### Add GPG keys\n\n**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.\n\nDeclare the `apt::key` defined type:\n\n```puppet\napt::key { 'puppetlabs':\n  id      => '6F6B15509CF8E59E6E469F327F438280EF8D349F',\n  server  => 'pgp.mit.edu',\n  options => 'http-proxy=\"http://proxyuser:proxypass@example.org:3128\"',\n}\n```\n\n### Prioritize backports\n\n```puppet\nclass { 'apt::backports':\n  pin => 500,\n}\n```\n\nBy default, the `apt::backports` class drops a pin file for backports, pinning it to a priority of 200. This is lower than the normal default of 500, so packages with `ensure => latest` don't get upgraded from backports without your explicit permission.\n\nIf you raise the priority through the `pin` parameter to 500, normal policy goes into effect and Apt installs or upgrades to the newest version. This means that if a package is available from backports, it and its dependencies are pulled in from backports unless you explicitly set the `ensure` attribute of the `package` resource to `installed`/`present` or a specific version.\n\n### Update the list of packages\n\nBy default, Puppet runs `apt-get update` on the first Puppet run after you include the `apt` class, and anytime `notify  => Exec['apt_update']` occurs; i.e., whenever config files get updated or other relevant changes occur. If you set `update['frequency']` to 'always', the update runs on every Puppet run. You can also set `update['frequency']` to 'daily' or 'weekly':\n\n```puppet\nclass { 'apt':\n  update => {\n    frequency => 'daily',\n  },\n}\n```\nWhen `Exec['apt_update']` is triggered, it generates a `Notice` message. Because the default [logging level for agents](https://docs.puppet.com/puppet/latest/configuration.html#loglevel) is `notice`, this causes the repository update to appear in logs and agent reports. Some tools, such as [The Foreman](https://www.theforeman.org), report the update notice as a significant change. To eliminate these updates from reports, set the [loglevel](https://docs.puppet.com/puppet/latest/metaparameter.html#loglevel) metaparameter for `Exec['apt_update']` above the agent logging level:\n\n```puppet\nclass { 'apt':\n  update => {\n    frequency => 'daily',\n    loglevel  => 'debug',\n  },\n}\n```\n\n### Pin a specific release\n\n```puppet\napt::pin { 'karmic': priority => 700 }\napt::pin { 'karmic-updates': priority => 700 }\napt::pin { 'karmic-security': priority => 700 }\n```\n\nYou can also specify more complex pins using distribution properties:\n\n```puppet\napt::pin { 'stable':\n  priority        => -10,\n  originator      => 'Debian',\n  release_version => '3.0',\n  component       => 'main',\n  label           => 'Debian'\n}\n```\n\nTo pin multiple packages, pass them to the `packages` parameter as an array or a space-delimited string.\n\n### Add a Personal Package Archive repository\n\n```puppet\napt::ppa { 'ppa:drizzle-developers/ppa': }\n```\n\n### Add an Apt source to `/etc/apt/sources.list.d/`\n\n```puppet\napt::source { 'debian_unstable':\n  comment  => 'This is the iWeb Debian unstable mirror',\n  location => 'http://debian.mirror.iweb.ca/debian/',\n  release  => 'unstable',\n  repos    => 'main contrib non-free',\n  pin      => '-10',\n  key      => {\n    'id'     => 'A1BD8E9D78F7FE5C3E65D8AF8B48AD6246925553',\n    'server' => 'subkeys.pgp.net',\n  },\n  include  => {\n    'src' => true,\n    'deb' => true,\n  },\n}\n```\n\nTo use the Puppet Labs Apt repository as a source:\n\n```puppet\napt::source { 'puppetlabs':\n  location => 'http://apt.puppetlabs.com',\n  repos    => 'main',\n  key      => {\n    'id'     => '6F6B15509CF8E59E6E469F327F438280EF8D349F',\n    'server' => 'pgp.mit.edu',\n  },\n}\n```\n\n### Configure Apt from Hiera\n\nInstead of specifying your sources directly as resources, you can instead just\ninclude the `apt` class, which will pick up the values automatically from\nhiera.\n\n```yaml\napt::sources:\n  'debian_unstable':\n    comment: 'This is the iWeb Debian unstable mirror'\n    location: 'http://debian.mirror.iweb.ca/debian/'\n    release: 'unstable'\n    repos: 'main contrib non-free'\n    pin: '-10'\n    key:\n      id: 'A1BD8E9D78F7FE5C3E65D8AF8B48AD6246925553'\n      server: 'subkeys.pgp.net'\n    include:\n      src: true\n      deb: true\n\n  'puppetlabs':\n    location: 'http://apt.puppetlabs.com'\n    repos: 'main'\n    key:\n      id: '6F6B15509CF8E59E6E469F327F438280EF8D349F'\n      server: 'pgp.mit.edu'\n```\n\n### Replace the default sources.list file\n\nThe following example replaces the default `/etc/apt/sources.list`. Along with this code, be sure to use the `purge` parameter, or you might get duplicate source warnings when running Apt.\n\n```puppet\napt::source { \"archive.ubuntu.com-${lsbdistcodename}\":\n  location => 'http://archive.ubuntu.com/ubuntu',\n  key      => '630239CC130E1A7FD81A27B140976EAF437D05B5',\n  repos    => 'main universe multiverse restricted',\n}\n\napt::source { \"archive.ubuntu.com-${lsbdistcodename}-security\":\n  location => 'http://archive.ubuntu.com/ubuntu',\n  key      => '630239CC130E1A7FD81A27B140976EAF437D05B5',\n  repos    => 'main universe multiverse restricted',\n  release  => \"${lsbdistcodename}-security\"\n}\n\napt::source { \"archive.ubuntu.com-${lsbdistcodename}-updates\":\n  location => 'http://archive.ubuntu.com/ubuntu',\n  key      => '630239CC130E1A7FD81A27B140976EAF437D05B5',\n  repos    => 'main universe multiverse restricted',\n  release  => \"${lsbdistcodename}-updates\"\n}\n\napt::source { \"archive.ubuntu.com-${lsbdistcodename}-backports\":\n location => 'http://archive.ubuntu.com/ubuntu',\n key      => '630239CC130E1A7FD81A27B140976EAF437D05B5',\n repos    => 'main universe multiverse restricted',\n release  => \"${lsbdistcodename}-backports\"\n}\n```\n\n## Reference\n\n### Classes\n\n#### Public Classes\n\n* [`apt`](#class-apt)\n* [`apt::backports`](#class-aptbackports)\n\n#### Private Classes\n\n* `apt::params`: Provides defaults for the apt module parameters.\n* `apt::update`: Updates the list of available packages using `apt-get update`.\n\n### Defined Types\n\n* [`apt::conf`](#defined-type-aptconf)\n* [`apt::key`](#defined-type-aptkey)\n* [`apt::pin`](#defined-type-aptpin)\n* [`apt::ppa`](#defined-type-aptppa)\n* [`apt::setting`](#defined-type-aptsetting)\n* [`apt::source`](#defined-type-aptsource)\n\n### Types\n\n* [`apt_key`](#type-apt_key)\n\n### Facts\n\n* `apt_updates`: The number of installed packages with available updates.\n\n* `apt_security_updates`: The number of installed packages with available security updates.\n\n* `apt_package_updates`: The names of all installed packages with available updates. In Facter 2.0 and later this data is formatted as an array; in earlier versions it is a comma-delimited string.\n\n* `apt_update_last_success`: The date, in epochtime, of the most recent successful `apt-get update` run (based on the mtime of  /var/lib/apt/periodic/update-success-stamp).\n\n* `apt_reboot_required`: Determines if a reboot is necessary after updates have been installed.\n\n#### Class: `apt`\n\nMain class, includes all other classes.\n\n##### Parameters (all optional)\n\n* `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: {}.\n\n* `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: {}.\n\n* `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: {}.\n\n* `proxy`: Configures Apt to connect to a proxy server. Valid options: a hash made up from the following keys:\n\n  * 'host': Specifies a proxy host to be stored in `/etc/apt/apt.conf.d/01proxy`. Valid options: a string containing a hostname. Default: undef.\n\n  * 'port': Specifies a proxy port to be stored in `/etc/apt/apt.conf.d/01proxy`. Valid options: an integer containing a port number. Default: 8080.\n\n  * 'https': Specifies whether to enable https proxies. Valid options: 'true' and 'false'. Default: 'false'.\n\n  * 'ensure': Optional parameter. Valid options: 'file', 'present', and 'absent'. Default: 'undef'. Prefer 'file' over 'present'.\n\n* `purge`: Specifies whether to purge any existing settings that aren't managed by Puppet. Valid options: a hash made up from the following keys:\n\n  * 'sources.list': Specifies whether to purge any unmanaged entries from `sources.list`. Valid options: 'true' and 'false'. Default: 'false'.\n\n  * 'sources.list.d': Specifies whether to purge any unmanaged entries from `sources.list.d`. Valid options: 'true' and 'false'. Default: 'false'.\n\n  * 'preferences': Specifies whether to purge any unmanaged entries from `preferences`. Valid options: 'true' and 'false'. Default: 'false'.\n\n  * 'preferences.d': Specifies whether to purge any unmanaged entries from `preferences.d`. Valid options: 'true' and 'false'. Default: 'false'.\n\n* `settings`: Creates new `apt::setting` resources. Valid options: a hash to be passed to the [`create_resources` function](https://docs.puppetlabs.com/references/latest/function.html#createresources). Default: {}.\n\n* `sources`: Creates new `apt::source` resources. Valid options: a hash to be passed to the [`create_resources` function](https://docs.puppetlabs.com/references/latest/function.html#createresources). Default: {}.\n\n* `pins`: Creates new `apt::pin` resources. Valid options: a hash to be passed to the [`create_resources` function](https://docs.puppetlabs.com/references/latest/function.html#createresources). Default: {}.\n\n* `update`: Configures various update settings. Valid options: a hash made up from the following keys:\n\n  * 'frequency': Specifies how often to run `apt-get update`. If the exec resource `apt_update` is notified, `apt-get update` runs regardless of this value. Valid options: 'always' (at every Puppet run); 'daily' (if the value of `apt_update_last_success` is less than current epoch time minus 86400); 'weekly' (if the value of `apt_update_last_success` is less than current epoch time minus 604800); and 'reluctantly' (only if the exec resource `apt_update` is notified). Default: 'reluctantly'.\n\n  * 'timeout': Specifies how long to wait for the update to complete before canceling it. Valid options: an integer, in seconds. Default: 300.\n\n  * 'tries': Specifies how many times to retry the update after receiving a DNS or HTTP error. Valid options: an integer. Default: 1.\n\n#### Class: `apt::backports`\n\nManages backports.\n\n##### Parameters (all optional on Debian and Ubuntu; all required on other operating systems, except where specified)\n\n* `key`: Specifies a key to authenticate the backports. Valid options: a string to be passed to the `id` parameter of the `apt::key` defined type, or a hash of `parameter => value` pairs to be passed to `apt::key`'s `id`, `server`, `content`, `source`, and/or `options` parameters. Defaults:\n\n  * Debian: 'A1BD8E9D78F7FE5C3E65D8AF8B48AD6246925553'\n  * Ubuntu: '630239CC130E1A7FD81A27B140976EAF437D05B5'\n\n* `location`: Specifies an Apt repository containing the backports to manage. Valid options: a string containing a URL. Defaults:\n\n  * Debian: 'http://deb.debian.org/debian'\n  * Ubuntu: 'http://archive.ubuntu.com/ubuntu'\n\n* `pin`: *Optional.* Specifies a pin priority for the backports. Valid options: a number or string to be passed to the `id` parameter of the `apt::pin` defined type, or a hash of `parameter => value` pairs to be passed to `apt::pin`'s corresponding parameters. Default: '200'.\n\n* `release`: Specifies a distribution of the Apt repository containing the backports to manage. Valid options: a string containing the release, used in populating the `source.list` configuration file. Default: on Debian and Ubuntu, '${lsbdistcodename}-backports'. We recommend keeping this default, except on other operating systems.\n\n* `repos`: Specifies a component of the Apt repository containing the backports to manage. Valid options: A string containing the repos to include, used in populating the `source.list` configuration file. Defaults:\n\n  * Debian: 'main contrib non-free'\n  * Ubuntu: 'main universe multiverse restricted'\n\n#### Defined Type: `apt::conf`\n\nSpecifies a custom Apt configuration file.\n\n##### Parameters\n\n* `content`: *Required, unless `ensure` is set to 'absent'.* Directly supplies content for the configuration file. Valid options: a string. Default: undef.\n\n* `ensure`: Specifies whether the configuration file should exist. Valid options: 'present' and 'absent'. Default: 'present'.\n\n* `priority`: *Optional.* Determines the order in which Apt processes the configuration file. Files with lower priority numbers are loaded first. Valid options: a string containing an integer. Default: '50'.\n\n* `notify_update`: *Optional.* Specifies whether to trigger an `apt-get update` run. Valid options: 'true' and 'false'. Default: 'true'.\n\n#### Defined Type: `apt::key`\n\nManages the GPG keys that Apt uses to authenticate packages.\n\nThe `apt::key` defined type makes use of the `apt_key` type, but includes extra functionality to help prevent duplicate keys.\n\n##### Parameters (all optional)\n\n* `content`: Supplies the entire GPG key. Useful in case the key can't be fetched from a remote location and using a file resource is inconvenient. Valid options: a string. Default: undef.\n\n* `ensure`: Specifies whether the key should exist. Valid options: 'present' and 'absent'. Default: 'present'.\n\n* `id`: Specifies a GPG key to authenticate Apt package signatures. Valid options: a string containing a key ID (8 or 16 hexadecimal characters, optionally prefixed with \"0x\") or a full key fingerprint (40 hexadecimal characters). Default: $title.\n\n* `options`: Passes additional options to `apt-key adv --keyserver-options`. Valid options: a string. Default: undef.\n\n* `source`: Specifies the location of an existing GPG key file to copy. Valid options: a string containing a URL (ftp://, http://, or https://) or an absolute path. Default: undef.\n\n* `server`: Specifies a keyserver to provide the GPG key. Valid options: a string containing a domain name or a full URL (http://, https://, or hkp://). Default: 'keyserver.ubuntu.com'.\n\n#### Defined Type: `apt::pin`\n\nManages Apt pins. Does not trigger an `apt-get update` run.\n\n**Note:** For context on these parameters, we recommend reading the man page ['apt_preferences(5)'](http://linux.die.net/man/5/apt_preferences)\n\n##### Parameters (all optional)\n\n* `codename`: Specifies the distribution (lsbdistcodename) of the Apt repository. Valid options: a string. Default: ''.\n\n* `component`: Names the licensing component associated with the packages in the directory tree of the Release file. Valid options: a string. Default: ''.\n\n* `ensure`: Specifies whether the pin should exist. Valid options: 'file', 'present', and 'absent'. Default: 'present'.\n\n* `explanation`: Supplies a comment to explain the pin. Valid options: a string. Default: \"${caller_module_name}: ${name}\".\n\n* `label`: Names the label of the packages in the directory tree of the Release file. Valid options: a string (most commonly, 'debian'). Default: ''.\n\n* `order`: Determines the order in which Apt processes the pin file. Files with lower order numbers are loaded first. Valid options: an integer. Default: 50.\n\n* `origin`: Tells Apt to prefer packages from the specified server. Valid options: a string containing a hostname. Default: ''.\n\n* `originator`: Names the originator of the packages in the directory tree of the Release file. Valid options: a string (most commonly, 'debian'). Default: ''.\n\n* `packages`: Specifies which package(s) to pin. Valid options: a string or an array. Default: '*'.\n\n* `priority`: Sets the priority of the package. If multiple versions of a given package are available, `apt-get` installs the one with the highest priority number (subject to dependency constraints). Valid options: an integer. Default: 0.\n\n* `release`: Tells Apt to prefer packages that support the specified release. Typical values include 'stable', 'testing', and 'unstable' Valid options: a string. Default: ''.\n\n* `release_version`: Tells Apt to prefer packages that support the specified operating system release version (e.g., Debian release version 7). Valid options: a string. Default: ''.\n\n* `version`: Tells Apt to prefer a specified package version or version range. Valid options: a string. Default: ''.\n\n#### Defined Type: `apt::ppa`\n\nManages PPA repositories using `add-apt-repository`. Not supported on Debian.\n\n##### Parameters (all optional, except where specified)\n\n* `ensure`: Specifies whether the PPA should exist. Valid options: 'present' and 'absent'. Default: 'present'.\n\n* `options`: Supplies options to be passed to the `add-apt-repository` command. Valid options: a string. Defaults:\n\n  * Lucid: undef\n  * All others: '-y'\n\n* `package_manage`: Specifies whether Puppet should manage the package that provides `apt-add-repository`. Valid options: 'true' and 'false'. Default: 'false'.\n\n* `package_name`: Names the package that provides the `apt-add-repository` command. Valid options: a string. Defaults:\n\n  * Lucid and Precise: 'python-software-properties'\n  * Trusty and newer: 'software-properties-common'\n  * All others: 'python-software-properties'\n\n* `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\".\n\n#### Defined Type: `apt::setting`\n\nManages Apt configuration files.\n\n##### Parameters\n\n* `content`: *Required, unless `source` is set.* Directly supplies content for the configuration file. Cannot be used in combination with `source`. Valid options: see the `content` attribute of [Puppet's native `file` type](https://docs.puppetlabs.com/references/latest/type.html#file-attribute-content). Default: undef.\n\n* `ensure`: Specifies whether the file should exist. Valid options: 'present', 'absent', and 'file'. Default: 'file'.\n\n* `notify_update`: *Optional.* Specifies whether to trigger an `apt-get update` run. Valid options: 'true' and 'false'. Default: 'true'.\n\n* `priority`: *Optional.* Determines the order in which Apt processes the configuration file. Files with higher priority numbers are loaded first. Valid options: an integer or zero-padded integer. Default: 50.\n\n* `source`: *Required, unless `content` is set.* Specifies a source file to supply the content of the configuration file. Cannot be used in combination with `content`. Valid options: see the `source` attribute of [Puppet's native `file` type](https://docs.puppetlabs.com/references/latest/type.html#file-attribute-source). Default: undef.\n\n#### Defined Type: `apt::source`\n\nManages the Apt sources in `/etc/apt/sources.list.d/`.\n\n##### Parameters (all optional, except where specified)\n\n* `allow_unsigned`: 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: 'false'.\n\n* `architecture`: Tells Apt to only download information for specified architectures. Valid options: a string containing one or more architecture names, separated by commas (e.g., 'i386' or 'i386,alpha,powerpc'). Default: undef (if unspecified, Apt downloads information for all architectures defined in the Apt::Architectures option).\n\n* `comment`: Supplies a comment for adding to the Apt source file. Valid options: a string. Default: $name.\n\n* `ensure`: Specifies whether the Apt source file should exist. Valid options: 'present' and 'absent'. Default: 'present'.\n\n* `key`: Creates a declaration of the apt::key defined type. Valid options: a string to be passed to the `id` parameter of the `apt::key` defined type, or a hash of `parameter => value` pairs to be passed to `apt::key`'s `id`, `server`, `content`, `source`, and/or `options` parameters. Default: undef.\n\n* `include`: Configures include options. Valid options: a hash of available keys. Default: {}. Available keys are:\n\n  * 'deb' - Specifies whether to request the distribution's compiled binaries. Valid options: 'true' and 'false'. Default: 'true'.\n\n  * 'src' - Specifies whether to request the distribution's uncompiled source code. Valid options: 'true' and 'false'. Default: 'false'.\n\n* `location`: *Required, unless `ensure` is set to 'absent'.* Specifies an Apt repository. Valid options: a string containing a repository URL. Default: undef.\n\n* `pin`: Creates a declaration of the apt::pin defined type. Valid options: a number or string to be passed to the `id` parameter of the `apt::pin` defined type, or a hash of `parameter => value` pairs to be passed to `apt::pin`'s corresponding parameters. Default: undef.\n\n* `release`: Specifies a distribution of the Apt repository. Valid options: a string. Default: \"$lsbdistcodename\".\n\n  * `repos`: Specifies a component of the Apt repository. Valid options: a string. Default: 'main'.\n\n* `notify_update`: *Optional.* Specifies whether to trigger an `apt-get update` run. Valid options: 'true' and 'false'. Default: 'true'.\n\n#### Type: `apt_key`\n\nManages the GPG keys that Apt uses to authenticate packages.\n\n**Note:** In most cases, we recommend using the `apt::key` defined type. It makes use of the `apt_key` type, but includes extra functionality to help prevent duplicate keys.\n\n##### Parameters (all optional)\n\n* `content`: Supplies the entire GPG key. Useful in case the key can't be fetched from a remote location and using a file resource is inconvenient. Cannot be used in combination with `source`. Valid options: a string. Default: undef.\n\n* `options`: Passes additional options to `apt-key adv --keyserver-options`. Valid options: a string. Default: undef.\n\n* `server`: Specifies a keyserver to provide Puppet's GPG key. Valid options: a string containing a domain name or a full URL. Default: 'keyserver.ubuntu.com'.\n\n* `source`: Specifies the location of an existing GPG key file to copy. Cannot be used in combination with `content`. Valid options: a string containing a URL (ftp://, http://, or https://) or an absolute path. Default: undef.\n\n## Limitations\n\nThis module is tested and officially supported on Debian 6 and 7 and Ubuntu 10.04, 12.04, and 14.04. Testing on other platforms has been light and cannot be guaranteed.\n\nThis module is not designed to be split across [run stages](https://docs.puppetlabs.com/puppet/latest/reference/lang_run_stages.html).\n\n### Adding new sources or PPAs\n\nIf you are adding a new source or PPA and trying to install packages from the new source or PPA on the same Puppet run, your `package` resource should depend on `Class['apt::update']`, in addition to depending on the `Apt::Source` or the `Apt::Ppa`. You can also add [collectors](https://docs.puppetlabs.com/puppet/latest/reference/lang_collectors.html) to ensure that all packages happen after `apt::update`, but this can lead to dependency cycles and has implications for [virtual resources](https://docs.puppetlabs.com/puppet/latest/reference/lang_collectors.html#behavior).\n\n```puppet\nClass['apt::update'] -> Package <| provider == 'apt' |>\n```\n\n## Development\nPuppet Labs modules on the Puppet Forge are open projects, and community contributions are essential for keeping them great. We can't access the huge number of platforms and myriad hardware, software, and deployment configurations that Puppet is intended to serve. We want to keep it as easy as possible to contribute changes so that our modules work in your environment. There are a few guidelines that we need contributors to follow so that we can have a chance of keeping on top of things.\n\nFor more information, see our [module contribution guide.](https://docs.puppetlabs.com/forge/contributing.html)\n\nTo see who's already involved, see the [list of contributors.](https://github.com/puppetlabs/puppetlabs-apt/graphs/contributors)\n",
    "changelog": "# Changelog\n\nAll notable changes to this project will be documented in this file. The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/)\nand this project adheres to [Semantic Versioning](http://semver.org).\n\n## Supported Release [4.2.0]\n### Summary\n\nThis release is primarily to fix an error around GPG keys in Debian 9, but includes some other small features and fixes as well.\n\n#### Added\n- `apt_package_security_updates` fact\n- The ability to modify the loglevel of `Exec['apt_update'}`\n- Puppet 5 support\n\n#### Changed\n- Ubuntu 16.04 now uses `software-priorities-common`\n\n#### Removed\n- Debian 6, Ubuntu 10.04 and 12.04 support. Existing compatibility remains intact but bugs will not be prioritized for these OSes.\n\n#### Fixed\n- **[(MODULES-4686)](https://tickets.puppetlabs.com/browse/MODULES-4686) an error that was causing GPG keyserver imports to fail on Debian 9**\n\n## Supported Release 4.1.0\n### Summary\n\nThis release removes Data in Modules due to current compatibility issues and reinstates the params.pp file. Also includes a couple of bug fixes.\n\n#### Features\n- (MODULES-4973) Data in Modules which was introduced in the last release has now been reverted due to compatibility issues.\n\n#### Bugfixes\n- Now apt_key only sends the auth basic header when userinfo can be parsed from the URL.\n- Reverted the removal of Evolving Web's attribution in NOTICE file.\n- Test added to ensure empty string allowed for $release in apt::source.\n\n\n## Supported Release 3.0.0 and 4.0.0\n### Summary\n\nThis release adds new Puppet 4 features: data in modules, EPP templates, the $facts hash, and data types. This release is fully backwards compatible to existing Puppet 4 configurations and provides you with deprecation warnings for every argument that will not work as expected with the final 4.0.0 release. See the stdlib docs here for an in-depth discussion of this: https://github.com/puppetlabs/puppetlabs-stdlib#validate_legacy\n\nIf you want to learn more about the new features used or you wish to upgrade a module yourself, have a look at the NTP: A Puppet 4 language update blog post.\n\nIf you're still running Puppet 3, remain on the latest puppetlabs-apt 2.x release for now, and see the documentation to upgrade to Puppet 4.\n\n#### Changes\n\nData in modules: Moves all distribution and OS-dependent defaults into YAML files in data/, alleviating the need for a params class. Note that while this feature is currently still classed as experimental, the final implementation will support the changes here.\nEPP templating: Uses the Puppet language as a base for templates to create simpler and safer templates. No need for Ruby anymore!\nThe $facts hash: Makes facts visibly distinct from other variables for more readable and maintainable code. This helps eliminate confusion if you use a local variable whose name happens to match that of a common fact.\nData types for validation: Helps you find and replace deprecated code in existing validate functions with stricter, more readable data type notation. First upgrade to the 3.0.0 release of this module, and address all deprecation warnings before upgrading to the final 4.0.0 release. Please see the stdlib docs for an in-depth discussion of this process.\n\n#### Bugfixes\n- Fix apt::source epp template regression introduced in 3.0.0 for the architecture parameter\n\n## Supported Release 2.4.0\n### Summary\nA release that includes only a couple of additional features, but includes several cleanups and bugfixes around existing issues.\n\n#### Features\n- Tests updated to check for idempotency.\n- (MODULES-4224) Implementation of beaker-module_install_helper.\n- Deprecation warnings are now handled by the deprecation function in stdlib.\n\n#### Bugfixes\n- Now http and https sources fixed for apt_key and can take a userinfo.\n- GPG key update.\n- Notify_update param now defaults to true to avoid validation errors.\n- Implement retry on tests which pull key from a key server which sometimes times out (transient error).\n- String comparison error now comphensated for in update.pp.\n- (MODULES-4104) Removal of the port number from repository location in order to get the host name of the repository.\n- Puppet lint warnings addressed.\n- A few small readme issues addressed.\n\n## Supported Release 2.3.0\n### Summary\nA release containing many bugfixes with additional features.\n\n#### Features\n- Apt_updates facts now use /usr/bin/apt-get.\n- Addition of notify update to apt::source.\n- Update to newest modulesync_configs.\n- Installs software-properties-common for Xenial.\n- Modulesync updates.\n- Add ability to specify a hash of apt::conf defines.\n\n#### Bugfixes\n- A clean up of spec/defines/key_compat_specs, also now runs under STRICT_VARIABLES.\n- Apt::setting expects priority to be an integer, set defaults accordingly.\n- Fixed version check for Ubuntu on 16.04.\n- Now uses hkps.pool.sks-keyservers.net instead of pgp.mit.edu.\n- Updates and fixes to tests. General cleanup.\n- Fixed regexp for $ensure params.\n- Apt/params: Remove unused LSB facts.\n- Replaced `-s` with `-f` in ppa rspec tests - After the repository is added, the \"${::apt::sources_list_d}/${sources_list_d_filename}\" file is created as an empty file. The unless condition of Exec[\"add-apt-repository-${name}\"] calls test -s, which returns 1 if the file is empty. Because the file is empty, the unless condition is never true and the repository is added on every execution. This change replaces the -s test condition with -f, which is true if the file exists or false otherwise.\n- Limit non-strict parsing to pre-3.5.0 only - Puppet 3.5.0 introduced strict variables and the module handles strict variables by using the defined() function. This does not work on prior versions of puppet so we now gate based on that version. Puppet 4 series has a new setting `strict` that may be set to enforce strict variables while `strict_variables` remains unset (see PUP-6358) which causes the conditional in manifests/params.pp to erroniously use non-strict 3.5-era parsing and fail. This new conditional corrects the cases such that strict variable behavior happens on versions 3.5.0 and later.\n\n## Supported Release 2.2.2\n### Summary\n\nSeveral bug fixes and the addition of support updates to Debian 8 and Ubuntu Wily.\n\n#### Bugfixes\n- Small fixes to descriptions within the readme and the addition of some examples.\n- Updates to run on Ubuntu Wily.\n- Fixed apt_key tempfile race condition.\n- Run stages limitation added to the documentation.\n- Remove unneeded whitespace in source.list template.\n- Handle PPA names that contain a plus character.\n- Update to current msync configs.\n- Avoid duplicate package resources when package_manage => true.\n- Avoid multiple package resource declarations.\n- Ensure PPAs in tests have valid form.\n- Look for correct sources.list.d file for apt::ppa.\n- Debian 8 support addiiton to metadata.\n\n## Supported Release 2.2.1\n### Summary\n\nSmall release for support of newer PE versions. This increments the version of PE in the metadata.json file.\n\n## 2015-09-29 - Supported Release 2.2.0\n### Summary\n\nThis release includes a few bugfixes.\n\n#### Features\n- Adds an `ensure` parameter for user control of proxy presence.\n- Adds ability to set `notify_update` to `apt::conf` (MODULES-2269).\n- Apt pins no longer trigger an `apt-get update` run.\n- Adds support for creating pins from main class.\n\n#### Bugfixes\n- Updates to use the official Debian mirrors.\n- Fixes path to `preferences` and `preferences.d`\n- Fixes pinning for backports (MODULES-2446).\n- Fixes the name/extension of the preferences files.\n\n## 2015-07-28 - Supported Release 2.1.1\n### Summary\n\nThis release includes a few bugfixes.\n\n#### Bugfixes\n- Fix incorrect use of anchoring (MODULES-2190)\n- Use correct comment type for apt.conf files\n- Test fixes\n- Documentation fixes\n\n## 2015-06-16 - Supported Release 2.1.0\n### Summary\n\nThis release largely makes `apt::key` and `apt::source` API-compatible with the 1.8.x versions for ease in upgrading, and also addresses some compatibility issues with older versions of Puppet.\n\n#### Features\n- Add API compatibility to `apt::key` and `apt::source`\n- Added `apt_reboot_required` fact\n\n#### Bugfixes\n- Fix compatibility with Puppet versions 3.0-3.4\n- Work around future parser bug PUP-4133\n\n## 2015-04-28 - Supported Release 2.0.1\n### Summary\n\nThis bug fixes a few compatibility issues that came up with the 2.0.0 release, and includes test and documentation updates.\n\n#### Bugfixes\n- Fix incompatibility with keyrings containing multiple keys\n- Fix bugs preventing the module from working with Puppet < 3.5.0\n\n## 2015-04-07 - Supported Release 2.0.0\n### Summary\n\nThis is a major rewrite of the apt module. Many classes and defines were removed, but all existing functionality should still work. Please carefully review documentation before upgrading.\n\n#### Backwards-incompatible changes\n\nAs this is a major rewrite of the module there are a great number of backwards incompatible changes. Please review this and the updated README carefully before upgrading.\n\n##### `apt_key`\n- `keyserver_options` parameter renamed to `options`\n\n##### `apt::backports`\n- This no longer works out of the box on Linux Mint. If using this on mint, you must specify the `location`, `release`, `repos`, and `key` parameters. [Example](examples/backports.pp)\n\n##### `apt::builddep`\n- This define was removed. Functionality can be matched passing 'build-dep' to `install_options` in the package resource. [Example](examples/builddep.pp)\n\n##### `apt::debian::testing`\n- This class was removed. Manually add an `apt::source` instead. [Example](examples/debian_testing.pp)\n\n##### `apt::debian::unstable`\n- This class was removed. Manually add an `apt::source` instead. [Example](examples/debian_unstable.pp)\n\n##### `apt::force`\n- This define was removed. Functionallity can be matched by setting `install_options` in the package resource. See [here](examples/force.pp) for how to set the options.\n\n##### `apt::hold`\n- This define was removed. Simply use an `apt::pin` with `priority => 1001` for the same functionality.\n\n##### `apt`\n- `always_apt_update` - This parameter was removed. Use `update => { 'frequency' => 'always' }` instead.\n- `apt_update_frequency` - This parameter was removed. Use `update => { 'frequency' => <frequency> }` instead.\n- `disable_keys` - This parameter was removed. See this [example](examples/disable_keys.pp) if you need this functionality.\n- `proxy_host` - This parameter was removed. Use `proxy => { 'host' => <host> }` instead.\n- `proxy_port` - This parameter was removed. Use `proxy => { 'port' => <port> }` instead.\n- `purge_sources_list` - This parameter was removed. Use `purge => { 'sources.list' => <bool> }` instead.\n- `purge_sources_list_d` - This parameter was removed. Use `purge => { 'sources.list.d' => <bool> }` instead.\n- `purge_preferences` - This parameter was removed. Use `purge => { 'preferences' => <bool> }` instead.\n- `purge_preferences_d` - This parameter was removed. Use `purge => { 'preferences.d' => <bool> }` instead.\n- `update_timeout` - This parameter was removed. Use `update => { 'timeout' => <timeout> }` instead.\n- `update_tries` - This parameter was removed. Use `update => { 'tries' => <tries> }` instead.\n\n##### `apt::key`\n- `key` - This parameter was renamed to `id`.\n- `key_content` - This parameter was renamed to `content`.\n- `key_source` - This parameter was renamed to `source`.\n- `key_server` - This parameter was renamed to `server`.\n- `key_options` - This parameter was renamed to `options`.\n\n##### `apt::release`\n- This class was removed. See this [example](examples/release.pp) for how to achieve this functionality.\n\n##### `apt::source`\n- `include_src` - This parameter was removed. Use `include => { 'src' => <bool> }` instead. ***NOTE*** This now defaults to false.\n- `include_deb` - This parameter was removed. Use `include => { 'deb' => <bool> }` instead.\n- `required_packages` - This parameter was removed. Use package resources for these packages if needed.\n- `key` - This can either be a key id or a hash including key options. If using a hash, `key => { 'id' => <id> }` must be specified.\n- `key_server` - This parameter was removed. Use `key => { 'server' => <server> }` instead.\n- `key_content` - This parameter was removed. Use `key => { 'content' => <content> }` instead.\n- `key_source` - This parameter was removed. Use `key => { 'source' => <source> }` instead.\n- `trusted_source` - This parameter was renamed to `allow_unsigned`.\n\n##### `apt::unattended_upgrades`\n- This class was removed and is being republished under the puppet-community namespace. The git repository is available [here](https://github.com/puppet-community/puppet-unattended_upgrades) and it will be published to the forge [here](https://forge.puppetlabs.com/puppet/unattended_upgrades).\n\n#### Changes to default behavior\n- By default purge unmanaged files in 'sources.list', 'sources.list.d', 'preferences', and 'preferences.d'.\n- Changed default for `package_manage` in `apt::ppa` to `false`. Set to `true` in a single PPA if you need the package to be managed.\n- `apt::source` will no longer include the `src` entries by default. \n- `pin` in `apt::source` now defaults to `undef` instead of `false`\n\n#### Features\n- Added the ability to pass hashes of `apt::key`s, `apt::ppa`s, and `apt::setting`s to `apt`.\n- Added 'https' key to `proxy` hash to allow disabling `https_proxy` for the `apt::ppa` environment.\n- Added `apt::setting` define to abstract away configuration.\n- Added the ability to pass hashes to `pin` and `key` in `apt::backports` and `apt::source`.\n\n#### Bugfixes\n- Fixes for strict variables.\n\n## 2015-03-17 - Supported Release 1.8.0\n### Summary\n\nThis is the last planned feature release of the 1.x series of this module. All new features will be evaluated for puppetlabs-apt 2.x.\n\nThis release includes many important features, including support for full fingerprints, and fixes issues where `apt_key` was not supporting user/password and `apt_has_updates` was not properly parsing the `apt-check` output.\n\n#### Changes to default behavior\n- The apt module will now throw warnings if you don't use full fingerprints for `apt_key`s\n\n#### Features\n- Use gpg to check keys to work around https://bugs.launchpad.net/ubuntu/+source/gnupg2/+bug/1409117 (MODULES-1675)\n- Add 'oldstable' to the default update origins for wheezy\n- Add utopic, vivid, and cumulus compatibility\n- Add support for full fingerprints\n- New parameter for `apt::source`\n  - `trusted_source`\n- New parameters for `apt::ppa`\n  - `package_name`\n  - `package_manage`\n- New parameter for `apt::unattended_upgrades`\n  - `legacy_origin`\n- Separate `apt::pin` from `apt::backports` to allow pin by release instead of origin\n\n#### Bugfixes\n- Cleanup lint and future parser issues\n- Fix to support username and passwords again for `apt_key` (MODULES-1119)\n- Fix issue where `apt::force` `$install_check` didn't work with non-English locales (MODULES-1231)\n- Allow 5 digit ports in `apt_key`\n- Fix for `ensure => absent` in `apt_key` (MODULES-1661)\n- Fix `apt_has_updates` not parsing `apt-check` output correctly\n- Fix inconsistent headers across files (MODULES-1200)\n- Clean up formatting for 50unattended-upgrades.erb\n\n## 2014-10-28 - Supported Release 1.7.0\n### Summary\n\nThis release includes several new features, documentation and test improvements, and a few bug fixes.\n\n#### Features\n- Updated unit and acceptance tests\n- Update module to work with Linux Mint\n- Documentation updates\n- Future parser / strict variables support\n- Improved support for long GPG keys\n- New parameters!\n  - Added `apt_update_frequency` to apt\n  - Added `cfg_files` and `cfg_missing` parameters to apt::force\n  - Added `randomsleep` to apt::unattended_upgrades\n- Added `apt_update_last_success` fact\n- Refactored facts for performance improvements\n\n#### Bugfixes\n- Update apt::builddep to require Exec['apt_update'] instead of notifying it\n- Clean up lint errors\n\n## 2014-08-20 - Supported Release 1.6.0\n### Summary\n\n#### Features\n- Allow URL or domain name for key_server parameter\n- Allow custom comment for sources list\n- Enable auto-update for Debian squeeze LTS\n- Add facts showing available updates\n- Test refactoring\n\n#### Bugfixes\n- Allow dashes in URL or domain for key_server parameter\n\n## 2014-08-13 - Supported Release 1.5.3\n### Summary\n\nThis is a bugfix releases.  It addresses a bad regex, failures with unicode\ncharacters, and issues with the $proxy_host handling in apt::ppa.\n\n#### Features\n- Synced files from Modulesync\n\n#### Bugfixes\n- Fix regex to follow APT requirements in apt::pin\n- Fix for unicode characters\n- Fix inconsistent $proxy_host handling in apt and apt::ppa\n- Fix typo in README\n- Fix broken acceptance tests\n\n## 2014-07-15 - Supported Release 1.5.2\n### Summary\n\nThis release merely updates metadata.json so the module can be uninstalled and\nupgraded via the puppet module command.\n\n## 2014-07-10 - Supported Release 1.5.1\n### Summary\n\nThis release has added tests to ensure graceful failure on OSX.\n\n## 2014-06-04 - Release 1.5.0\n### Summary\n\nThis release adds support for Ubuntu 14.04.  It also includes many new features \nand important bugfixes.  One huge change is that apt::key was replaced with\napt_key, which allows you to use puppet resource apt_key to inventory keys on\nyour system.\n\nSpecial thanks to daenney, our intrepid unofficial apt maintainer!\n\n#### Features\n- Add support for Ubuntu Trusty!\n- Add apt::hold define\n- Generate valid *.pref files in apt::pin\n- Made pin_priority configurable for apt::backports\n- Add apt_key type and provider\n- Rename \"${apt_conf_d}/proxy\" to \"${apt_conf_d}/01proxy\"\n- apt::key rewritten to use apt_key type\n- Add support for update_tries to apt::update\n\n#### Bugfixes\n- Typo fixes\n- Fix unattended upgrades\n- Removed bogus line when using purge_preferences\n- Fix apt::force to upgrade allow packages to be upgraded to the pacakge from the specified release\n\n## 2014-03-04 - Supported Release 1.4.2\n### Summary\n\nThis is a supported release. This release tidies up 1.4.1 and re-enables\nsupport for Ubuntu 10.04\n\n#### Features\n\n#### Bugfixes\n- Fix apt:ppa to include the -y Ubuntu 10.04 requires.\n- Documentation changes.\n- Test fixups.\n\n#### Known Bugs\n\n* No known issues.\n\n\n\n## 2014-02-13 1.4.1\n### Summary\nThis is a bugfix release.\n\n#### Bugfixes\n- Fix apt::force unable to upgrade packages from releases other than its original\n- Removed a few refeneces to aptitude instead of apt-get for portability\n- Removed call to getparam() due to stdlib dependency\n- Correct apt::source template when architecture is provided\n- Retry package installs if apt is locked\n- Use root to exec in apt::ppa\n- Updated tests and converted acceptance tests to beaker\n\n## 2013-10-08 - Release 1.4.0\n\n### Summary\n\nMinor bugfix and allow the timeout to be adjusted.\n\n#### Features\n- Add an `updates_timeout` to apt::params\n\n#### Bugfixes\n- Ensure apt::ppa can read a ppa removed by hand.\n\n\n## 2013-10-08 - Release 1.3.0\n### Summary\n\nThis major feature in this release is the new apt::unattended_upgrades class,\nallowing you to handle Ubuntu's unattended feature.  This allows you to select\nspecific packages to automatically upgrade without any further user\ninvolvement.\n\nIn addition we extend our Wheezy support, add proxy support to apt:ppa and do\nvarious cleanups and tweaks.\n\n#### Features\n- Add apt::unattended_upgrades support for Ubuntu.\n- Add wheezy backports support.\n- Use the geoDNS http.debian.net instead of the main debian ftp server.\n- Add `options` parameter to apt::ppa in order to pass options to apt-add-repository command.\n- Add proxy support for apt::ppa (uses proxy_host and proxy_port from apt).\n\n#### Bugfixes\n- Fix regsubst() calls to quote single letters (for future parser).\n- Fix lint warnings and other misc cleanup.\n\n\n## 2013-07-03 - Release 1.2.0\n\n#### Features\n- Add geppetto `.project` natures\n- Add GH auto-release\n- Add `apt::key::key_options` parameter\n- Add complex pin support using distribution properties for `apt::pin` via new properties:\n  - `apt::pin::codename`\n  - `apt::pin::release_version`\n  - `apt::pin::component`\n  - `apt::pin::originator`\n  - `apt::pin::label`\n- Add source architecture support to `apt::source::architecture`\n\n#### Bugfixes\n- Use apt-get instead of aptitude in apt::force\n- Update default backports location\n- Add dependency for required packages before apt-get update\n\n\n## 2013-06-02 - Release 1.1.1\n### Summary\n\nThis is a bug fix release that resolves a number of issues:\n\n* By changing template variable usage, we remove the deprecation warnings\n  for Puppet 3.2.x\n* Fixed proxy file removal, when proxy absent\n\nSome documentation, style and whitespaces changes were also merged. This\nrelease also introduced proper rspec-puppet unit testing on Travis-CI to help\nreduce regression.\n\nThanks to all the community contributors below that made this patch possible.\n\n#### Detail Changes\n\n* fix minor comment type (Chris Rutter)\n* whitespace fixes (Michael Moll)\n* Update travis config file (William Van Hevelingen)\n* Build all branches on travis (William Van Hevelingen)\n* Standardize travis.yml on pattern introduced in stdlib (William Van Hevelingen)\n* Updated content to conform to README best practices template (Lauren Rother)\n* Fix apt::release example in readme (Brian Galey)\n* add @ to variables in template (Peter Hoeg)\n* Remove deprecation warnings for pin.pref.erb as well (Ken Barber)\n* Update travis.yml to latest versions of puppet (Ken Barber)\n* Fix proxy file removal (Scott Barber)\n* Add spec test for removing proxy configuration (Dean Reilly)\n* Fix apt::key listing longer than 8 chars (Benjamin Knofe)\n\n\n\n\n## Release 1.1.0\n### Summary\n\nThis release includes Ubuntu 12.10 (Quantal) support for PPAs.\n\n---\n\n## 2012-05-25 - Puppet Labs <info@puppetlabs.com> - Release 0.0.4\n### Summary\n\n * Fix ppa list filename when there is a period in the PPA name\n * Add .pref extension to apt preferences files\n * Allow preferences to be purged\n * Extend pin support\n\n\n## 2012-05-04 - Puppet Labs <info@puppetlabs.com> - Release 0.0.3\n### Summary\n \n * only invoke apt-get update once\n * only install python-software-properties if a ppa is added\n * support 'ensure => absent' for all defined types\n * add apt::conf\n * add apt::backports\n * fixed Modulefile for module tool dependency resolution\n * configure proxy before doing apt-get update\n * use apt-get update instead of aptitude for apt::ppa\n * add support to pin release\n\n\n## 2012-03-26 - Puppet Labs <info@puppetlabs.com> - Release 0.0.2\n### Summary\n\n* 41cedbb (#13261) Add real examples to smoke tests.\n* d159a78 (#13261) Add key.pp smoke test\n* 7116c7a (#13261) Replace foo source with puppetlabs source\n* 1ead0bf Ignore pkg directory.\n* 9c13872 (#13289) Fix some more style violations\n* 0ea4ffa (#13289) Change test scaffolding to use a module & manifest dir fixture path\n* a758247 (#13289) Clean up style violations and fix corresponding tests\n* 99c3fd3 (#13289) Add puppet lint tests to Rakefile\n* 5148cbf (#13125) Apt keys should be case insensitive\n* b9607a4 Convert apt::key to use anchors\n\n\n## 2012-03-07 - Puppet Labs <info@puppetlabs.com> - Release 0.0.1\n### Summary\n\n* d4fec56 Modify apt::source release parameter test\n* 1132a07 (#12917) Add contributors to README\n* 8cdaf85 (#12823) Add apt::key defined type and modify apt::source to use it\n* 7c0d10b (#12809) $release should use $lsbdistcodename and fall back to manual input\n* be2cc3e (#12522) Adjust spec test for splitting purge\n* 7dc60ae (#12522) Split purge option to spare sources.list\n* 9059c4e Fix source specs to test all key permutations\n* 8acb202 Add test for python-software-properties package\n* a4af11f Check if python-software-properties is defined before attempting to define it.\n* 1dcbf3d Add tests for required_packages change\n* f3735d2 Allow duplicate $required_packages\n* 74c8371 (#12430) Add tests for changes to apt module\n* 97ebb2d Test two sources with the same key\n* 1160bcd (#12526) Add ability to reverse apt { disable_keys => true }\n* 2842d73 Add Modulefile to puppet-apt\n* c657742 Allow the use of the same key in multiple sources\n* 8c27963 (#12522) Adding purge option to apt class\n* 997c9fd (#12529) Add unit test for apt proxy settings\n* 50f3cca (#12529) Add parameter to support setting a proxy for apt\n* d522877 (#12094) Replace chained .with_* with a hash\n* 8cf1bd0 (#12094) Remove deprecated spec.opts file\n* 2d688f4 (#12094) Add rspec-puppet tests for apt\n* 0fb5f78 (#12094) Replace name with path in file resources\n* f759bc0 (#11953) Apt::force passes $version to aptitude\n* f71db53 (#11413) Add spec test for apt::force to verify changes to unless\n* 2f5d317 (#11413) Update dpkg query used by apt::force\n* cf6caa1 (#10451) Add test coverage to apt::ppa\n* 0dd697d include_src parameter in example; Whitespace cleanup\n* b662eb8 fix typos in \"repositories\"\n* 1be7457 Fix (#10451) - apt::ppa fails to \"apt-get update\" when new PPA source is added\n* 864302a Set the pin priority before adding the source (Fix #10449)\n* 1de4e0a Refactored as per mlitteken\n* 1af9a13 Added some crazy bash madness to check if the ppa is installed already. Otherwise the manifest tries to add it on every run!\n* 52ca73e (#8720) Replace Apt::Ppa with Apt::Builddep\n* 5c05fa0 added builddep command.\n* a11af50 added the ability to specify the content of a key\n* c42db0f Fixes ppa test.\n* 77d2b0d reformatted whitespace to match recommended style of 2 space indentation.\n* 27ebdfc ignore swap files.\n* 377d58a added smoke tests for module.\n* 18f614b reformatted apt::ppa according to recommended style.\n* d8a1e4e Created a params class to hold global data.\n* 636ae85 Added two params for apt class\n* 148fc73 Update LICENSE.\n* ed2d19e Support ability to add more than one PPA\n* 420d537 Add call to apt-update after add-apt-repository in apt::ppa\n* 945be77 Add package definition for python-software-properties\n* 71fc425 Abs paths for all commands\n* 9d51cd1 Adding LICENSE\n* 71796e3 Heading fix in README\n* 87777d8 Typo in README\n* f848bac First commit\n\n\n[4.2.0]:https://github.com/puppetlabs/puppetlabs-apt/compare/4.1.0...4.2.0\n",
    "license": "\n                                 Apache License\n                           Version 2.0, January 2004\n                        http://www.apache.org/licenses/\n\n   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION\n\n   1. Definitions.\n\n      \"License\" shall mean the terms and conditions for use, reproduction,\n      and distribution as defined by Sections 1 through 9 of this document.\n\n      \"Licensor\" shall mean the copyright owner or entity authorized by\n      the copyright owner that is granting the License.\n\n      \"Legal Entity\" shall mean the union of the acting entity and all\n      other entities that control, are controlled by, or are under common\n      control with that entity. For the purposes of this definition,\n      \"control\" means (i) the power, direct or indirect, to cause the\n      direction or management of such entity, whether by contract or\n      otherwise, or (ii) ownership of fifty percent (50%) or more of the\n      outstanding shares, or (iii) beneficial ownership of such entity.\n\n      \"You\" (or \"Your\") shall mean an individual or Legal Entity\n      exercising permissions granted by this License.\n\n      \"Source\" form shall mean the preferred form for making modifications,\n      including but not limited to software source code, documentation\n      source, and configuration files.\n\n      \"Object\" form shall mean any form resulting from mechanical\n      transformation or translation of a Source form, including but\n      not limited to compiled object code, generated documentation,\n      and conversions to other media types.\n\n      \"Work\" shall mean the work of authorship, whether in Source or\n      Object form, made available under the License, as indicated by a\n      copyright notice that is included in or attached to the work\n      (an example is provided in the Appendix below).\n\n      \"Derivative Works\" shall mean any work, whether in Source or Object\n      form, that is based on (or derived from) the Work and for which the\n      editorial revisions, annotations, elaborations, or other modifications\n      represent, as a whole, an original work of authorship. For the purposes\n      of this License, Derivative Works shall not include works that remain\n      separable from, or merely link (or bind by name) to the interfaces of,\n      the Work and Derivative Works thereof.\n\n      \"Contribution\" shall mean any work of authorship, including\n      the original version of the Work and any modifications or additions\n      to that Work or Derivative Works thereof, that is intentionally\n      submitted to Licensor for inclusion in the Work by the copyright owner\n      or by an individual or Legal Entity authorized to submit on behalf of\n      the copyright owner. For the purposes of this definition, \"submitted\"\n      means any form of electronic, verbal, or written communication sent\n      to the Licensor or its representatives, including but not limited to\n      communication on electronic mailing lists, source code control systems,\n      and issue tracking systems that are managed by, or on behalf of, the\n      Licensor for the purpose of discussing and improving the Work, but\n      excluding communication that is conspicuously marked or otherwise\n      designated in writing by the copyright owner as \"Not a Contribution.\"\n\n      \"Contributor\" shall mean Licensor and any individual or Legal Entity\n      on behalf of whom a Contribution has been received by Licensor and\n      subsequently incorporated within the Work.\n\n   2. Grant of Copyright License. Subject to the terms and conditions of\n      this License, each Contributor hereby grants to You a perpetual,\n      worldwide, non-exclusive, no-charge, royalty-free, irrevocable\n      copyright license to reproduce, prepare Derivative Works of,\n      publicly display, publicly perform, sublicense, and distribute the\n      Work and such Derivative Works in Source or Object form.\n\n   3. Grant of Patent License. Subject to the terms and conditions of\n      this License, each Contributor hereby grants to You a perpetual,\n      worldwide, non-exclusive, no-charge, royalty-free, irrevocable\n      (except as stated in this section) patent license to make, have made,\n      use, offer to sell, sell, import, and otherwise transfer the Work,\n      where such license applies only to those patent claims licensable\n      by such Contributor that are necessarily infringed by their\n      Contribution(s) alone or by combination of their Contribution(s)\n      with the Work to which such Contribution(s) was submitted. If You\n      institute patent litigation against any entity (including a\n      cross-claim or counterclaim in a lawsuit) alleging that the Work\n      or a Contribution incorporated within the Work constitutes direct\n      or contributory patent infringement, then any patent licenses\n      granted to You under this License for that Work shall terminate\n      as of the date such litigation is filed.\n\n   4. Redistribution. You may reproduce and distribute copies of the\n      Work or Derivative Works thereof in any medium, with or without\n      modifications, and in Source or Object form, provided that You\n      meet the following conditions:\n\n      (a) You must give any other recipients of the Work or\n          Derivative Works a copy of this License; and\n\n      (b) You must cause any modified files to carry prominent notices\n          stating that You changed the files; and\n\n      (c) You must retain, in the Source form of any Derivative Works\n          that You distribute, all copyright, patent, trademark, and\n          attribution notices from the Source form of the Work,\n          excluding those notices that do not pertain to any part of\n          the Derivative Works; and\n\n      (d) If the Work includes a \"NOTICE\" text file as part of its\n          distribution, then any Derivative Works that You distribute must\n          include a readable copy of the attribution notices contained\n          within such NOTICE file, excluding those notices that do not\n          pertain to any part of the Derivative Works, in at least one\n          of the following places: within a NOTICE text file distributed\n          as part of the Derivative Works; within the Source form or\n          documentation, if provided along with the Derivative Works; or,\n          within a display generated by the Derivative Works, if and\n          wherever such third-party notices normally appear. The contents\n          of the NOTICE file are for informational purposes only and\n          do not modify the License. You may add Your own attribution\n          notices within Derivative Works that You distribute, alongside\n          or as an addendum to the NOTICE text from the Work, provided\n          that such additional attribution notices cannot be construed\n          as modifying the License.\n\n      You may add Your own copyright statement to Your modifications and\n      may provide additional or different license terms and conditions\n      for use, reproduction, or distribution of Your modifications, or\n      for any such Derivative Works as a whole, provided Your use,\n      reproduction, and distribution of the Work otherwise complies with\n      the conditions stated in this License.\n\n   5. Submission of Contributions. Unless You explicitly state otherwise,\n      any Contribution intentionally submitted for inclusion in the Work\n      by You to the Licensor shall be under the terms and conditions of\n      this License, without any additional terms or conditions.\n      Notwithstanding the above, nothing herein shall supersede or modify\n      the terms of any separate license agreement you may have executed\n      with Licensor regarding such Contributions.\n\n   6. Trademarks. This License does not grant permission to use the trade\n      names, trademarks, service marks, or product names of the Licensor,\n      except as required for reasonable and customary use in describing the\n      origin of the Work and reproducing the content of the NOTICE file.\n\n   7. Disclaimer of Warranty. Unless required by applicable law or\n      agreed to in writing, Licensor provides the Work (and each\n      Contributor provides its Contributions) on an \"AS IS\" BASIS,\n      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or\n      implied, including, without limitation, any warranties or conditions\n      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A\n      PARTICULAR PURPOSE. You are solely responsible for determining the\n      appropriateness of using or redistributing the Work and assume any\n      risks associated with Your exercise of permissions under this License.\n\n   8. Limitation of Liability. In no event and under no legal theory,\n      whether in tort (including negligence), contract, or otherwise,\n      unless required by applicable law (such as deliberate and grossly\n      negligent acts) or agreed to in writing, shall any Contributor be\n      liable to You for damages, including any direct, indirect, special,\n      incidental, or consequential damages of any character arising as a\n      result of this License or out of the use or inability to use the\n      Work (including but not limited to damages for loss of goodwill,\n      work stoppage, computer failure or malfunction, or any and all\n      other commercial damages or losses), even if such Contributor\n      has been advised of the possibility of such damages.\n\n   9. Accepting Warranty or Additional Liability. While redistributing\n      the Work or Derivative Works thereof, You may choose to offer,\n      and charge a fee for, acceptance of support, warranty, indemnity,\n      or other liability obligations and/or rights consistent with this\n      License. However, in accepting such obligations, You may act only\n      on Your own behalf and on Your sole responsibility, not on behalf\n      of any other Contributor, and only if You agree to indemnify,\n      defend, and hold each Contributor harmless for any liability\n      incurred by, or claims asserted against, such Contributor by reason\n      of your accepting any such warranty or additional liability.\n\n   END OF TERMS AND CONDITIONS\n\n   APPENDIX: How to apply the Apache License to your work.\n\n      To apply the Apache License to your work, attach the following\n      boilerplate notice, with the fields enclosed by brackets \"[]\"\n      replaced with your own identifying information. (Don't include\n      the brackets!)  The text should be enclosed in the appropriate\n      comment syntax for the file format. We also recommend that a\n      file or class name and description of purpose be included on the\n      same \"printed page\" as the copyright notice for easier\n      identification within third-party archives.\n\n   Copyright [yyyy] [name of copyright owner]\n\n   Licensed under the Apache License, Version 2.0 (the \"License\");\n   you may not use this file except in compliance with the License.\n   You may obtain a copy of the License at\n\n       http://www.apache.org/licenses/LICENSE-2.0\n\n   Unless required by applicable law or agreed to in writing, software\n   distributed under the License is distributed on an \"AS IS\" BASIS,\n   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n   See the License for the specific language governing permissions and\n   limitations under the License.\n",
    "tasks": [
 
    ],
    "created_at": "2017-09-26 15:22:09 -0700",
    "updated_at": "2017-09-26 15:25:09 -0700",
    "deleted_at": null,
    "deleted_for": null
  },
  "releases": [
    {
      "uri": "/v3/releases/puppetlabs-apt-4.2.0",
      "slug": "puppetlabs-apt-4.2.0",
      "version": "4.2.0",
      "supported": false,
      "created_at": "2017-09-26 15:22:09 -0700",
      "deleted_at": null,
      "file_uri": "/v3/files/puppetlabs-apt-4.2.0.tar.gz",
      "file_size": 74697
    },
    {
      "uri": "/v3/releases/puppetlabs-apt-4.1.0",
      "slug": "puppetlabs-apt-4.1.0",
      "version": "4.1.0",
      "supported": false,
      "created_at": "2017-06-05 02:28:06 -0700",
      "deleted_at": null,
      "file_uri": "/v3/files/puppetlabs-apt-4.1.0.tar.gz",
      "file_size": 73480
    },
    {
      "uri": "/v3/releases/puppetlabs-apt-4.0.0",
      "slug": "puppetlabs-apt-4.0.0",
      "version": "4.0.0",
      "supported": false,
      "created_at": "2017-04-27 08:38:13 -0700",
      "deleted_at": null,
      "file_uri": "/v3/files/puppetlabs-apt-4.0.0.tar.gz",
      "file_size": 72908
    },
    {
      "uri": "/v3/releases/puppetlabs-apt-3.0.0",
      "slug": "puppetlabs-apt-3.0.0",
      "version": "3.0.0",
      "supported": false,
      "created_at": "2017-04-19 09:00:38 -0700",
      "deleted_at": null,
      "file_uri": "/v3/files/puppetlabs-apt-3.0.0.tar.gz",
      "file_size": 73942
    },
    {
      "uri": "/v3/releases/puppetlabs-apt-2.4.0",
      "slug": "puppetlabs-apt-2.4.0",
      "version": "2.4.0",
      "supported": false,
      "created_at": "2017-04-06 09:46:05 -0700",
      "deleted_at": null,
      "file_uri": "/v3/files/puppetlabs-apt-2.4.0.tar.gz",
      "file_size": 72389
    },
    {
      "uri": "/v3/releases/puppetlabs-apt-2.3.0",
      "slug": "puppetlabs-apt-2.3.0",
      "version": "2.3.0",
      "supported": false,
      "created_at": "2016-09-20 04:13:15 -0700",
      "deleted_at": null,
      "file_uri": "/v3/files/puppetlabs-apt-2.3.0.tar.gz",
      "file_size": 63285
    },
    {
      "uri": "/v3/releases/puppetlabs-apt-2.2.2",
      "slug": "puppetlabs-apt-2.2.2",
      "version": "2.2.2",
      "supported": false,
      "created_at": "2016-02-29 13:46:32 -0800",
      "deleted_at": null,
      "file_uri": "/v3/files/puppetlabs-apt-2.2.2.tar.gz",
      "file_size": 62744
    },
    {
      "uri": "/v3/releases/puppetlabs-apt-2.2.1",
      "slug": "puppetlabs-apt-2.2.1",
      "version": "2.2.1",
      "supported": false,
      "created_at": "2015-12-08 06:30:07 -0800",
      "deleted_at": null,
      "file_uri": "/v3/files/puppetlabs-apt-2.2.1.tar.gz",
      "file_size": 57430
    },
    {
      "uri": "/v3/releases/puppetlabs-apt-2.2.0",
      "slug": "puppetlabs-apt-2.2.0",
      "version": "2.2.0",
      "supported": false,
      "created_at": "2015-09-29 09:44:20 -0700",
      "deleted_at": null,
      "file_uri": "/v3/files/puppetlabs-apt-2.2.0.tar.gz",
      "file_size": 57358
    },
    {
      "uri": "/v3/releases/puppetlabs-apt-2.1.1",
      "slug": "puppetlabs-apt-2.1.1",
      "version": "2.1.1",
      "supported": false,
      "created_at": "2015-07-27 17:16:00 -0700",
      "deleted_at": null,
      "file_uri": "/v3/files/puppetlabs-apt-2.1.1.tar.gz",
      "file_size": 56803
    },
    {
      "uri": "/v3/releases/puppetlabs-apt-2.1.0",
      "slug": "puppetlabs-apt-2.1.0",
      "version": "2.1.0",
      "supported": false,
      "created_at": "2015-06-16 15:03:51 -0700",
      "deleted_at": null,
      "file_uri": "/v3/files/puppetlabs-apt-2.1.0.tar.gz",
      "file_size": 56582
    },
    {
      "uri": "/v3/releases/puppetlabs-apt-2.0.1",
      "slug": "puppetlabs-apt-2.0.1",
      "version": "2.0.1",
      "supported": false,
      "created_at": "2015-04-28 11:19:14 -0700",
      "deleted_at": null,
      "file_uri": "/v3/files/puppetlabs-apt-2.0.1.tar.gz",
      "file_size": 54719
    },
    {
      "uri": "/v3/releases/puppetlabs-apt-2.0.0",
      "slug": "puppetlabs-apt-2.0.0",
      "version": "2.0.0",
      "supported": false,
      "created_at": "2015-04-22 10:07:28 -0700",
      "deleted_at": null,
      "file_uri": "/v3/files/puppetlabs-apt-2.0.0.tar.gz",
      "file_size": 48949
    },
    {
      "uri": "/v3/releases/puppetlabs-apt-1.8.0",
      "slug": "puppetlabs-apt-1.8.0",
      "version": "1.8.0",
      "supported": false,
      "created_at": "2015-03-17 14:45:08 -0700",
      "deleted_at": null,
      "file_uri": "/v3/files/puppetlabs-apt-1.8.0.tar.gz",
      "file_size": 54120
    },
    {
      "uri": "/v3/releases/puppetlabs-apt-1.7.0",
      "slug": "puppetlabs-apt-1.7.0",
      "version": "1.7.0",
      "supported": false,
      "created_at": "2014-10-28 12:16:07 -0700",
      "deleted_at": null,
      "file_uri": "/v3/files/puppetlabs-apt-1.7.0.tar.gz",
      "file_size": 50069
    },
    {
      "uri": "/v3/releases/puppetlabs-apt-1.6.0",
      "slug": "puppetlabs-apt-1.6.0",
      "version": "1.6.0",
      "supported": true,
      "created_at": "2014-08-13 15:18:04 -0700",
      "deleted_at": null,
      "file_uri": "/v3/files/puppetlabs-apt-1.6.0.tar.gz",
      "file_size": 45390
    },
    {
      "uri": "/v3/releases/puppetlabs-apt-1.5.2",
      "slug": "puppetlabs-apt-1.5.2",
      "version": "1.5.2",
      "supported": true,
      "created_at": "2014-07-21 15:51:19 -0700",
      "deleted_at": null,
      "file_uri": "/v3/files/puppetlabs-apt-1.5.2.tar.gz",
      "file_size": 46963
    },
    {
      "uri": "/v3/releases/puppetlabs-apt-1.5.1",
      "slug": "puppetlabs-apt-1.5.1",
      "version": "1.5.1",
      "supported": true,
      "created_at": "2014-07-10 11:24:08 -0700",
      "deleted_at": null,
      "file_uri": "/v3/files/puppetlabs-apt-1.5.1.tar.gz",
      "file_size": 46304
    },
    {
      "uri": "/v3/releases/puppetlabs-apt-1.5.0",
      "slug": "puppetlabs-apt-1.5.0",
      "version": "1.5.0",
      "supported": false,
      "created_at": "2014-06-04 11:10:11 -0700",
      "deleted_at": null,
      "file_uri": "/v3/files/puppetlabs-apt-1.5.0.tar.gz",
      "file_size": 47391
    },
    {
      "uri": "/v3/releases/puppetlabs-apt-1.4.2",
      "slug": "puppetlabs-apt-1.4.2",
      "version": "1.4.2",
      "supported": true,
      "created_at": "2014-03-03 17:41:34 -0800",
      "deleted_at": null,
      "file_uri": "/v3/files/puppetlabs-apt-1.4.2.tar.gz",
      "file_size": 34545
    },
    {
      "uri": "/v3/releases/puppetlabs-apt-1.4.1",
      "slug": "puppetlabs-apt-1.4.1",
      "version": "1.4.1",
      "supported": false,
      "created_at": "2014-02-14 15:30:42 -0800",
      "deleted_at": "2015-04-15 14:16:38 -0700",
      "file_uri": "/v3/files/puppetlabs-apt-1.4.1.tar.gz",
      "file_size": 34509
    },
    {
      "uri": "/v3/releases/puppetlabs-apt-1.4.0",
      "slug": "puppetlabs-apt-1.4.0",
      "version": "1.4.0",
      "supported": false,
      "created_at": "2013-10-15 11:06:03 -0700",
      "deleted_at": null,
      "file_uri": "/v3/files/puppetlabs-apt-1.4.0.tar.gz",
      "file_size": 27238
    },
    {
      "uri": "/v3/releases/puppetlabs-apt-1.3.0",
      "slug": "puppetlabs-apt-1.3.0",
      "version": "1.3.0",
      "supported": false,
      "created_at": "2013-09-17 10:34:14 -0700",
      "deleted_at": null,
      "file_uri": "/v3/files/puppetlabs-apt-1.3.0.tar.gz",
      "file_size": 25435
    },
    {
      "uri": "/v3/releases/puppetlabs-apt-1.2.0",
      "slug": "puppetlabs-apt-1.2.0",
      "version": "1.2.0",
      "supported": false,
      "created_at": "2013-07-05 10:27:35 -0700",
      "deleted_at": null,
      "file_uri": "/v3/files/puppetlabs-apt-1.2.0.tar.gz",
      "file_size": 21622
    },
    {
      "uri": "/v3/releases/puppetlabs-apt-1.1.1",
      "slug": "puppetlabs-apt-1.1.1",
      "version": "1.1.1",
      "supported": false,
      "created_at": "2013-07-01 17:44:23 -0700",
      "deleted_at": null,
      "file_uri": "/v3/files/puppetlabs-apt-1.1.1.tar.gz",
      "file_size": 18779
    },
    {
      "uri": "/v3/releases/puppetlabs-apt-1.1.0",
      "slug": "puppetlabs-apt-1.1.0",
      "version": "1.1.0",
      "supported": false,
      "created_at": "2012-12-02 16:05:23 -0800",
      "deleted_at": null,
      "file_uri": "/v3/files/puppetlabs-apt-1.1.0.tar.gz",
      "file_size": 15880
    },
    {
      "uri": "/v3/releases/puppetlabs-apt-1.0.1",
      "slug": "puppetlabs-apt-1.0.1",
      "version": "1.0.1",
      "supported": false,
      "created_at": "2012-10-30 05:35:58 -0700",
      "deleted_at": null,
      "file_uri": "/v3/files/puppetlabs-apt-1.0.1.tar.gz",
      "file_size": 15646
    },
    {
      "uri": "/v3/releases/puppetlabs-apt-1.0.0",
      "slug": "puppetlabs-apt-1.0.0",
      "version": "1.0.0",
      "supported": false,
      "created_at": "2012-10-30 03:33:28 -0700",
      "deleted_at": null,
      "file_uri": "/v3/files/puppetlabs-apt-1.0.0.tar.gz",
      "file_size": 15580
    },
    {
      "uri": "/v3/releases/puppetlabs-apt-0.0.4",
      "slug": "puppetlabs-apt-0.0.4",
      "version": "0.0.4",
      "supported": false,
      "created_at": "2012-06-07 17:50:45 -0700",
      "deleted_at": null,
      "file_uri": "/v3/files/puppetlabs-apt-0.0.4.tar.gz",
      "file_size": 14966
    },
    {
      "uri": "/v3/releases/puppetlabs-apt-0.0.3",
      "slug": "puppetlabs-apt-0.0.3",
      "version": "0.0.3",
      "supported": false,
      "created_at": "2012-05-04 21:37:19 -0700",
      "deleted_at": null,
      "file_uri": "/v3/files/puppetlabs-apt-0.0.3.tar.gz",
      "file_size": 14869
    },
    {
      "uri": "/v3/releases/puppetlabs-apt-0.0.2",
      "slug": "puppetlabs-apt-0.0.2",
      "version": "0.0.2",
      "supported": false,
      "created_at": "2012-03-27 00:07:26 -0700",
      "deleted_at": "2015-04-15 14:16:38 -0700",
      "file_uri": "/v3/files/puppetlabs-apt-0.0.2.tar.gz",
      "file_size": 13060
    },
    {
      "uri": "/v3/releases/puppetlabs-apt-0.0.1",
      "slug": "puppetlabs-apt-0.0.1",
      "version": "0.0.1",
      "supported": false,
      "created_at": "2012-03-08 03:29:25 -0800",
      "deleted_at": "2015-04-15 14:16:38 -0700",
      "file_uri": "/v3/files/puppetlabs-apt-0.0.1.tar.gz",
      "file_size": 12291
    }
  ],
  "feedback_score": 88,
  "homepage_url": "https://github.com/puppetlabs/puppetlabs-apt",
  "issues_url": "https://tickets.puppetlabs.com/browse/MODULES"
}

Also interesting, it will install puppetlabs-apt 4.1.0 when you don't pass a version number.

Comment by Eric Putnam [ 2017/10/05 ]

due to an issue with uri encoding/escaping shenanigans (specifically around the :module_group parameter), the pmt is unable to get the second page of releases from the forge.

Here's a commit we looked at: https://github.com/puppetlabs/puppet/commit/9357163e93b80bd27db072860b59d606435d6560#diff-40bfd58bbeef98e0cdbe69d6a84d17e5

We want to:
1. Fix the URI problem
2. Make sure that releases are being returned in order by release date in the future

Comment by Paula Muir [ 2017/10/06 ]

Currently this issue is blocking Postgresql release for Puppetconf.

Link to failing Jenkins job

Comment by David Mallon [ 2017/10/06 ]

Jesse Scott Hi Jesse, this is turning into a major blocking issue for Modules getting our releases out for PuppetConf so Hailee and Eric are free to work with you to try to get a fix for this pushed through asap

Comment by Josh Cooper [ 2017/10/09 ]

It would be helpful to run an older (4.10.1) and newer (5.3.2) puppet with the --http_debug option to see how the agent/PMT is encoding HTTP parameters differently when there is more than 20 released versions of a module.

Comment by Ethan Brown [ 2017/10/11 ]

PUP-1890 was the ticket that changed things in Puppet (to fix encoding issues). Part of the changes around forge requests were due to PE-5115 (particularly the commit at https://github.com/puppetlabs/puppetlabs-puppet_enterprise/commit/4597d2f)

In an ideal world, the PE setting would have been space separated as base pe_only and Puppet code would have handled properly escaping the request (to base%20pe_only). I presume the Puppet code at the time was flawed, which made it necessary to manually pre-encode the value with a {} for space (though it likely should have used %20 as {} has fallen out of favor).

A subsequent fix went in to address Forge related issues in https://github.com/puppetlabs/puppet/pull/5964/files rather than changing the PE setting to base pe_only, as this was necessary for backwards compatibility.

This new problem is related, but not quite the same. The JSON payload returned by the Forge includes links that are already escaped, and likely are being encoded again. The suggestion from Josh Cooper will help us to make that determination.

Comment by Jesse Scott [ 2017/10/17 ]

It is definitely an issue with double encoding the URI for the subsequent pages. I've got a puppet fix mostly worked up which I will PR tomorrow.

We can also mitigate the issue by changing the default ordering from the Forge API so that the latest release is always on the first page of results. Since there is a param available for requesting the results in a specific order, I feel like it's reasonable to change the default since clients should already be requesting things in a specific order if it's important for their app. That Forge change can also go out tomorrow (see PF-1431).

Comment by David Mallon [ 2017/10/18 ]

cool thanks Jesse Scott - let us know when you have a fix in and we can run a quick test to verify

Comment by Jesse Scott [ 2017/10/18 ]

Opened https://github.com/puppetlabs/puppet/pull/6287

Comment by Jesse Scott [ 2017/10/18 ]

That PR also updates the debug log output to more accurately reflect the URI being requested.

Comment by Ethan Brown [ 2017/10/24 ]

Merged to 4.10.x in https://github.com/puppetlabs/puppet/commit/b1461040f9da211ae2dea7049cfb0725854ce595

Comment by Kenn Hussey [ 2017/10/26 ]

Hailee Kenney please add release notes for this issue, if applicable. Thanks!

Comment by Hailee Kenney [ 2017/10/26 ]

Hey Kenn Hussey, apologies for the confusion, but this ticket was assigned to me when I was investigating this issue but I wasn't actually involved with the fix. Ethan Brown or Jesse Scott would have a better idea on release notes than I do.

Comment by Ethan Brown [ 2017/10/27 ]

Has run through CI and passed tests.

Jesse Scott and I performed some manual debugging across various versions of Puppet to validate old / new behavior.

We used puppet module install at the command line to install puppetlabs-stdlib with a version of 4.4.0. Prior to the code landing, installation would fail with Puppet 4.10.8 and 5.3.2. After the patch, both scenarios worked.

Generated at Mon Dec 09 07:08:17 PST 2019 using JIRA 7.7.1#77002-sha1:e75ca93d5574d9409c0630b81c894d9065296414.