1 ## Supported Release 4.1.0
4 This release removes Data in Modules due to current compatibility issues and reinstates the params.pp file. Also includes a couple of bug fixes.
7 - (MODULES-4973) Data in Modules which was introduced in the last release has now been reverted due to compatibility issues.
10 - Now apt_key only sends the auth basic header when userinfo can be parsed from the URL.
11 - Reverted the removal of Evolving Web's attribution in NOTICE file.
12 - Test added to ensure empty string allowed for $release in apt::source.
15 ## Supported Release 3.0.0 and 4.0.0
18 This 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
20 If 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.
22 If 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.
26 Data 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.
27 EPP templating: Uses the Puppet language as a base for templates to create simpler and safer templates. No need for Ruby anymore!
28 The $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.
29 Data 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.
32 - Fix apt::source epp template regression introduced in 3.0.0 for the architecture parameter
34 ## Supported Release 2.4.0
36 A release that includes only a couple of additional features, but includes several cleanups and bugfixes around existing issues.
39 - Tests updated to check for idempotency.
40 - (MODULES-4224) Implementation of beaker-module_install_helper.
41 - Deprecation warnings are now handled by the deprecation function in stdlib.
44 - Now http and https sources fixed for apt_key and can take a userinfo.
46 - Notify_update param now defaults to true to avoid validation errors.
47 - Implement retry on tests which pull key from a key server which sometimes times out (transient error).
48 - String comparison error now comphensated for in update.pp.
49 - (MODULES-4104) Removal of the port number from repository location in order to get the host name of the repository.
50 - Puppet lint warnings addressed.
51 - A few small readme issues addressed.
53 ## Supported Release 2.3.0
55 A release containing many bugfixes with additional features.
58 - Apt_updates facts now use /usr/bin/apt-get.
59 - Addition of notify update to apt::source.
60 - Update to newest modulesync_configs.
61 - Installs software-properties-common for Xenial.
63 - Add ability to specify a hash of apt::conf defines.
66 - A clean up of spec/defines/key_compat_specs, also now runs under STRICT_VARIABLES.
67 - Apt::setting expects priority to be an integer, set defaults accordingly.
68 - Fixed version check for Ubuntu on 16.04.
69 - Now uses hkps.pool.sks-keyservers.net instead of pgp.mit.edu.
70 - Updates and fixes to tests. General cleanup.
71 - Fixed regexp for $ensure params.
72 - Apt/params: Remove unused LSB facts.
73 - 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.
74 - 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.
76 ##Supported Release 2.2.2
79 Several bug fixes and the addition of support updates to Debian 8 and Ubuntu Wily.
82 - Small fixes to descriptions within the readme and the addition of some examples.
83 - Updates to run on Ubuntu Wily.
84 - Fixed apt_key tempfile race condition.
85 - Run stages limitation added to the documentation.
86 - Remove unneeded whitespace in source.list template.
87 - Handle PPA names that contain a plus character.
88 - Update to current msync configs.
89 - Avoid duplicate package resources when package_manage => true.
90 - Avoid multiple package resource declarations.
91 - Ensure PPAs in tests have valid form.
92 - Look for correct sources.list.d file for apt::ppa.
93 - Debian 8 support addiiton to metadata.
95 ##Supported Release 2.2.1
98 Small release for support of newer PE versions. This increments the version of PE in the metadata.json file.
100 ##2015-09-29 - Supported Release 2.2.0
103 This release includes a few bugfixes.
106 - Adds an `ensure` parameter for user control of proxy presence.
107 - Adds ability to set `notify_update` to `apt::conf` (MODULES-2269).
108 - Apt pins no longer trigger an `apt-get update` run.
109 - Adds support for creating pins from main class.
112 - Updates to use the official Debian mirrors.
113 - Fixes path to `preferences` and `preferences.d`
114 - Fixes pinning for backports (MODULES-2446).
115 - Fixes the name/extension of the preferences files.
117 ##2015-07-28 - Supported Release 2.1.1
120 This release includes a few bugfixes.
123 - Fix incorrect use of anchoring (MODULES-2190)
124 - Use correct comment type for apt.conf files
126 - Documentation fixes
128 ##2015-06-16 - Supported Release 2.1.0
131 This 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.
134 - Add API compatibility to `apt::key` and `apt::source`
135 - Added `apt_reboot_required` fact
138 - Fix compatibility with Puppet versions 3.0-3.4
139 - Work around future parser bug PUP-4133
141 ##2015-04-28 - Supported Release 2.0.1
144 This bug fixes a few compatibility issues that came up with the 2.0.0 release, and includes test and documentation updates.
147 - Fix incompatibility with keyrings containing multiple keys
148 - Fix bugs preventing the module from working with Puppet < 3.5.0
150 ##2015-04-07 - Supported Release 2.0.0
153 This 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.
155 ####Backwards-incompatible changes
157 As 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.
160 - `keyserver_options` parameter renamed to `options`
162 #####`apt::backports`
163 - 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)
166 - This define was removed. Functionality can be matched passing 'build-dep' to `install_options` in the package resource. [Example](examples/builddep.pp)
168 #####`apt::debian::testing`
169 - This class was removed. Manually add an `apt::source` instead. [Example](examples/debian_testing.pp)
171 #####`apt::debian::unstable`
172 - This class was removed. Manually add an `apt::source` instead. [Example](examples/debian_unstable.pp)
175 - 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.
178 - This define was removed. Simply use an `apt::pin` with `priority => 1001` for the same functionality.
181 - `always_apt_update` - This parameter was removed. Use `update => { 'frequency' => 'always' }` instead.
182 - `apt_update_frequency` - This parameter was removed. Use `update => { 'frequency' => <frequency> }` instead.
183 - `disable_keys` - This parameter was removed. See this [example](examples/disable_keys.pp) if you need this functionality.
184 - `proxy_host` - This parameter was removed. Use `proxy => { 'host' => <host> }` instead.
185 - `proxy_port` - This parameter was removed. Use `proxy => { 'port' => <port> }` instead.
186 - `purge_sources_list` - This parameter was removed. Use `purge => { 'sources.list' => <bool> }` instead.
187 - `purge_sources_list_d` - This parameter was removed. Use `purge => { 'sources.list.d' => <bool> }` instead.
188 - `purge_preferences` - This parameter was removed. Use `purge => { 'preferences' => <bool> }` instead.
189 - `purge_preferences_d` - This parameter was removed. Use `purge => { 'preferences.d' => <bool> }` instead.
190 - `update_timeout` - This parameter was removed. Use `update => { 'timeout' => <timeout> }` instead.
191 - `update_tries` - This parameter was removed. Use `update => { 'tries' => <tries> }` instead.
194 - `key` - This parameter was renamed to `id`.
195 - `key_content` - This parameter was renamed to `content`.
196 - `key_source` - This parameter was renamed to `source`.
197 - `key_server` - This parameter was renamed to `server`.
198 - `key_options` - This parameter was renamed to `options`.
201 - This class was removed. See this [example](examples/release.pp) for how to achieve this functionality.
204 - `include_src` - This parameter was removed. Use `include => { 'src' => <bool> }` instead. ***NOTE*** This now defaults to false.
205 - `include_deb` - This parameter was removed. Use `include => { 'deb' => <bool> }` instead.
206 - `required_packages` - This parameter was removed. Use package resources for these packages if needed.
207 - `key` - This can either be a key id or a hash including key options. If using a hash, `key => { 'id' => <id> }` must be specified.
208 - `key_server` - This parameter was removed. Use `key => { 'server' => <server> }` instead.
209 - `key_content` - This parameter was removed. Use `key => { 'content' => <content> }` instead.
210 - `key_source` - This parameter was removed. Use `key => { 'source' => <source> }` instead.
211 - `trusted_source` - This parameter was renamed to `allow_unsigned`.
213 #####`apt::unattended_upgrades`
214 - 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).
216 ####Changes to default behavior
217 - By default purge unmanaged files in 'sources.list', 'sources.list.d', 'preferences', and 'preferences.d'.
218 - 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.
219 - `apt::source` will no longer include the `src` entries by default.
220 - `pin` in `apt::source` now defaults to `undef` instead of `false`
223 - Added the ability to pass hashes of `apt::key`s, `apt::ppa`s, and `apt::setting`s to `apt`.
224 - Added 'https' key to `proxy` hash to allow disabling `https_proxy` for the `apt::ppa` environment.
225 - Added `apt::setting` define to abstract away configuration.
226 - Added the ability to pass hashes to `pin` and `key` in `apt::backports` and `apt::source`.
229 - Fixes for strict variables.
231 ##2015-03-17 - Supported Release 1.8.0
234 This 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.
236 This 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.
238 ####Changes to default behavior
239 - The apt module will now throw warnings if you don't use full fingerprints for `apt_key`s
242 - Use gpg to check keys to work around https://bugs.launchpad.net/ubuntu/+source/gnupg2/+bug/1409117 (MODULES-1675)
243 - Add 'oldstable' to the default update origins for wheezy
244 - Add utopic, vivid, and cumulus compatibility
245 - Add support for full fingerprints
246 - New parameter for `apt::source`
248 - New parameters for `apt::ppa`
251 - New parameter for `apt::unattended_upgrades`
253 - Separate `apt::pin` from `apt::backports` to allow pin by release instead of origin
256 - Cleanup lint and future parser issues
257 - Fix to support username and passwords again for `apt_key` (MODULES-1119)
258 - Fix issue where `apt::force` `$install_check` didn't work with non-English locales (MODULES-1231)
259 - Allow 5 digit ports in `apt_key`
260 - Fix for `ensure => absent` in `apt_key` (MODULES-1661)
261 - Fix `apt_has_updates` not parsing `apt-check` output correctly
262 - Fix inconsistent headers across files (MODULES-1200)
263 - Clean up formatting for 50unattended-upgrades.erb
265 ##2014-10-28 - Supported Release 1.7.0
268 This release includes several new features, documentation and test improvements, and a few bug fixes.
271 - Updated unit and acceptance tests
272 - Update module to work with Linux Mint
273 - Documentation updates
274 - Future parser / strict variables support
275 - Improved support for long GPG keys
277 - Added `apt_update_frequency` to apt
278 - Added `cfg_files` and `cfg_missing` parameters to apt::force
279 - Added `randomsleep` to apt::unattended_upgrades
280 - Added `apt_update_last_success` fact
281 - Refactored facts for performance improvements
284 - Update apt::builddep to require Exec['apt_update'] instead of notifying it
285 - Clean up lint errors
287 ##2014-08-20 - Supported Release 1.6.0
291 - Allow URL or domain name for key_server parameter
292 - Allow custom comment for sources list
293 - Enable auto-update for Debian squeeze LTS
294 - Add facts showing available updates
298 - Allow dashes in URL or domain for key_server parameter
300 ##2014-08-13 - Supported Release 1.5.3
303 This is a bugfix releases. It addresses a bad regex, failures with unicode
304 characters, and issues with the $proxy_host handling in apt::ppa.
307 - Synced files from Modulesync
310 - Fix regex to follow APT requirements in apt::pin
311 - Fix for unicode characters
312 - Fix inconsistent $proxy_host handling in apt and apt::ppa
314 - Fix broken acceptance tests
316 ##2014-07-15 - Supported Release 1.5.2
319 This release merely updates metadata.json so the module can be uninstalled and
320 upgraded via the puppet module command.
322 ##2014-07-10 - Supported Release 1.5.1
325 This release has added tests to ensure graceful failure on OSX.
327 ##2014-06-04 - Release 1.5.0
330 This release adds support for Ubuntu 14.04. It also includes many new features
331 and important bugfixes. One huge change is that apt::key was replaced with
332 apt_key, which allows you to use puppet resource apt_key to inventory keys on
335 Special thanks to daenney, our intrepid unofficial apt maintainer!
338 - Add support for Ubuntu Trusty!
339 - Add apt::hold define
340 - Generate valid *.pref files in apt::pin
341 - Made pin_priority configurable for apt::backports
342 - Add apt_key type and provider
343 - Rename "${apt_conf_d}/proxy" to "${apt_conf_d}/01proxy"
344 - apt::key rewritten to use apt_key type
345 - Add support for update_tries to apt::update
349 - Fix unattended upgrades
350 - Removed bogus line when using purge_preferences
351 - Fix apt::force to upgrade allow packages to be upgraded to the pacakge from the specified release
353 ##2014-03-04 - Supported Release 1.4.2
356 This is a supported release. This release tidies up 1.4.1 and re-enables
357 support for Ubuntu 10.04
362 - Fix apt:ppa to include the -y Ubuntu 10.04 requires.
363 - Documentation changes.
374 This is a bugfix release.
377 - Fix apt::force unable to upgrade packages from releases other than its original
378 - Removed a few refeneces to aptitude instead of apt-get for portability
379 - Removed call to getparam() due to stdlib dependency
380 - Correct apt::source template when architecture is provided
381 - Retry package installs if apt is locked
382 - Use root to exec in apt::ppa
383 - Updated tests and converted acceptance tests to beaker
385 ##2013-10-08 - Release 1.4.0
389 Minor bugfix and allow the timeout to be adjusted.
392 - Add an `updates_timeout` to apt::params
395 - Ensure apt::ppa can read a ppa removed by hand.
398 ##2013-10-08 - Release 1.3.0
401 This major feature in this release is the new apt::unattended_upgrades class,
402 allowing you to handle Ubuntu's unattended feature. This allows you to select
403 specific packages to automatically upgrade without any further user
406 In addition we extend our Wheezy support, add proxy support to apt:ppa and do
407 various cleanups and tweaks.
410 - Add apt::unattended_upgrades support for Ubuntu.
411 - Add wheezy backports support.
412 - Use the geoDNS http.debian.net instead of the main debian ftp server.
413 - Add `options` parameter to apt::ppa in order to pass options to apt-add-repository command.
414 - Add proxy support for apt::ppa (uses proxy_host and proxy_port from apt).
417 - Fix regsubst() calls to quote single letters (for future parser).
418 - Fix lint warnings and other misc cleanup.
421 ##2013-07-03 - Release 1.2.0
424 - Add geppetto `.project` natures
425 - Add GH auto-release
426 - Add `apt::key::key_options` parameter
427 - Add complex pin support using distribution properties for `apt::pin` via new properties:
428 - `apt::pin::codename`
429 - `apt::pin::release_version`
430 - `apt::pin::component`
431 - `apt::pin::originator`
433 - Add source architecture support to `apt::source::architecture`
436 - Use apt-get instead of aptitude in apt::force
437 - Update default backports location
438 - Add dependency for required packages before apt-get update
441 ##2013-06-02 - Release 1.1.1
444 This is a bug fix release that resolves a number of issues:
446 * By changing template variable usage, we remove the deprecation warnings
448 * Fixed proxy file removal, when proxy absent
450 Some documentation, style and whitespaces changes were also merged. This
451 release also introduced proper rspec-puppet unit testing on Travis-CI to help
454 Thanks to all the community contributors below that made this patch possible.
458 * fix minor comment type (Chris Rutter)
459 * whitespace fixes (Michael Moll)
460 * Update travis config file (William Van Hevelingen)
461 * Build all branches on travis (William Van Hevelingen)
462 * Standardize travis.yml on pattern introduced in stdlib (William Van Hevelingen)
463 * Updated content to conform to README best practices template (Lauren Rother)
464 * Fix apt::release example in readme (Brian Galey)
465 * add @ to variables in template (Peter Hoeg)
466 * Remove deprecation warnings for pin.pref.erb as well (Ken Barber)
467 * Update travis.yml to latest versions of puppet (Ken Barber)
468 * Fix proxy file removal (Scott Barber)
469 * Add spec test for removing proxy configuration (Dean Reilly)
470 * Fix apt::key listing longer than 8 chars (Benjamin Knofe)
478 This release includes Ubuntu 12.10 (Quantal) support for PPAs.
482 ##2012-05-25 - Puppet Labs <info@puppetlabs.com> - Release 0.0.4
485 * Fix ppa list filename when there is a period in the PPA name
486 * Add .pref extension to apt preferences files
487 * Allow preferences to be purged
491 ##2012-05-04 - Puppet Labs <info@puppetlabs.com> - Release 0.0.3
494 * only invoke apt-get update once
495 * only install python-software-properties if a ppa is added
496 * support 'ensure => absent' for all defined types
499 * fixed Modulefile for module tool dependency resolution
500 * configure proxy before doing apt-get update
501 * use apt-get update instead of aptitude for apt::ppa
502 * add support to pin release
505 ##2012-03-26 - Puppet Labs <info@puppetlabs.com> - Release 0.0.2
508 * 41cedbb (#13261) Add real examples to smoke tests.
509 * d159a78 (#13261) Add key.pp smoke test
510 * 7116c7a (#13261) Replace foo source with puppetlabs source
511 * 1ead0bf Ignore pkg directory.
512 * 9c13872 (#13289) Fix some more style violations
513 * 0ea4ffa (#13289) Change test scaffolding to use a module & manifest dir fixture path
514 * a758247 (#13289) Clean up style violations and fix corresponding tests
515 * 99c3fd3 (#13289) Add puppet lint tests to Rakefile
516 * 5148cbf (#13125) Apt keys should be case insensitive
517 * b9607a4 Convert apt::key to use anchors
520 ##2012-03-07 - Puppet Labs <info@puppetlabs.com> - Release 0.0.1
523 * d4fec56 Modify apt::source release parameter test
524 * 1132a07 (#12917) Add contributors to README
525 * 8cdaf85 (#12823) Add apt::key defined type and modify apt::source to use it
526 * 7c0d10b (#12809) $release should use $lsbdistcodename and fall back to manual input
527 * be2cc3e (#12522) Adjust spec test for splitting purge
528 * 7dc60ae (#12522) Split purge option to spare sources.list
529 * 9059c4e Fix source specs to test all key permutations
530 * 8acb202 Add test for python-software-properties package
531 * a4af11f Check if python-software-properties is defined before attempting to define it.
532 * 1dcbf3d Add tests for required_packages change
533 * f3735d2 Allow duplicate $required_packages
534 * 74c8371 (#12430) Add tests for changes to apt module
535 * 97ebb2d Test two sources with the same key
536 * 1160bcd (#12526) Add ability to reverse apt { disable_keys => true }
537 * 2842d73 Add Modulefile to puppet-apt
538 * c657742 Allow the use of the same key in multiple sources
539 * 8c27963 (#12522) Adding purge option to apt class
540 * 997c9fd (#12529) Add unit test for apt proxy settings
541 * 50f3cca (#12529) Add parameter to support setting a proxy for apt
542 * d522877 (#12094) Replace chained .with_* with a hash
543 * 8cf1bd0 (#12094) Remove deprecated spec.opts file
544 * 2d688f4 (#12094) Add rspec-puppet tests for apt
545 * 0fb5f78 (#12094) Replace name with path in file resources
546 * f759bc0 (#11953) Apt::force passes $version to aptitude
547 * f71db53 (#11413) Add spec test for apt::force to verify changes to unless
548 * 2f5d317 (#11413) Update dpkg query used by apt::force
549 * cf6caa1 (#10451) Add test coverage to apt::ppa
550 * 0dd697d include_src parameter in example; Whitespace cleanup
551 * b662eb8 fix typos in "repositories"
552 * 1be7457 Fix (#10451) - apt::ppa fails to "apt-get update" when new PPA source is added
553 * 864302a Set the pin priority before adding the source (Fix #10449)
554 * 1de4e0a Refactored as per mlitteken
555 * 1af9a13 Added some crazy bash madness to check if the ppa is installed already. Otherwise the manifest tries to add it on every run!
556 * 52ca73e (#8720) Replace Apt::Ppa with Apt::Builddep
557 * 5c05fa0 added builddep command.
558 * a11af50 added the ability to specify the content of a key
559 * c42db0f Fixes ppa test.
560 * 77d2b0d reformatted whitespace to match recommended style of 2 space indentation.
561 * 27ebdfc ignore swap files.
562 * 377d58a added smoke tests for module.
563 * 18f614b reformatted apt::ppa according to recommended style.
564 * d8a1e4e Created a params class to hold global data.
565 * 636ae85 Added two params for apt class
566 * 148fc73 Update LICENSE.
567 * ed2d19e Support ability to add more than one PPA
568 * 420d537 Add call to apt-update after add-apt-repository in apt::ppa
569 * 945be77 Add package definition for python-software-properties
570 * 71fc425 Abs paths for all commands
571 * 9d51cd1 Adding LICENSE
572 * 71796e3 Heading fix in README
573 * 87777d8 Typo in README
574 * f848bac First commit