Add 15.10 support
[puppet-modules/puppetlabs-apt.git] / CHANGELOG.md
1 ##2015-09-29 - Supported Release 2.2.0
2 ###Summary
3
4 This release includes a few bugfixes.
5
6 ####Features
7 - Adds an `ensure` parameter for user control of proxy presence.
8 - Adds ability to set `notify_update` to `apt::conf` (MODULES-2269).
9 - Apt pins no longer trigger an `apt-get update` run.
10 - Adds support for creating pins from main class.
11
12 ####Bugfixes
13 - Updates to use the official Debian mirrors.
14 - Fixes path to `preferences` and `preferences.d`
15 - Fixes pinning for backports (MODULES-2446).
16 - Fixes the name/extension of the preferences files.
17
18 ##2015-07-28 - Supported Release 2.1.1
19 ###Summary
20
21 This release includes a few bugfixes.
22
23 ####Bugfixes
24 - Fix incorrect use of anchoring (MODULES-2190)
25 - Use correct comment type for apt.conf files
26 - Test fixes
27 - Documentation fixes
28
29 ##2015-06-16 - Supported Release 2.1.0
30 ###Summary
31
32 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.
33
34 ####Features
35 - Add API compatibility to `apt::key` and `apt::source`
36 - Added `apt_reboot_required` fact
37
38 ####Bugfixes
39 - Fix compatibility with Puppet versions 3.0-3.4
40 - Work around future parser bug PUP-4133
41
42 ##2015-04-28 - Supported Release 2.0.1
43 ###Summary
44
45 This bug fixes a few compatibility issues that came up with the 2.0.0 release, and includes test and documentation updates.
46
47 ####Bugfixes
48 - Fix incompatibility with keyrings containing multiple keys
49 - Fix bugs preventing the module from working with Puppet < 3.5.0
50
51 ##2015-04-07 - Supported Release 2.0.0
52 ###Summary
53
54 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.
55
56 ####Backwards-incompatible changes
57
58 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.
59
60 #####`apt_key`
61 - `keyserver_options` parameter renamed to `options`
62
63 #####`apt::backports`
64 - 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)
65
66 #####`apt::builddep`
67 - This define was removed. Functionality can be matched passing 'build-dep' to `install_options` in the package resource. [Example](examples/builddep.pp)
68
69 #####`apt::debian::testing`
70 - This class was removed. Manually add an `apt::source` instead. [Example](examples/debian_testing.pp)
71
72 #####`apt::debian::unstable`
73 - This class was removed. Manually add an `apt::source` instead. [Example](examples/debian_unstable.pp)
74
75 #####`apt::force`
76 - 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.
77
78 #####`apt::hold`
79 - This define was removed. Simply use an `apt::pin` with `priority => 1001` for the same functionality.
80
81 #####`apt`
82 - `always_apt_update` - This parameter was removed. Use `update => { 'frequency' => 'always' }` instead.
83 - `apt_update_frequency` - This parameter was removed. Use `update => { 'frequency' => <frequency> }` instead.
84 - `disable_keys` - This parameter was removed. See this [example](examples/disable_keys.pp) if you need this functionality.
85 - `proxy_host` - This parameter was removed. Use `proxy => { 'host' => <host> }` instead.
86 - `proxy_port` - This parameter was removed. Use `proxy => { 'port' => <port> }` instead.
87 - `purge_sources_list` - This parameter was removed. Use `purge => { 'sources.list' => <bool> }` instead.
88 - `purge_sources_list_d` - This parameter was removed. Use `purge => { 'sources.list.d' => <bool> }` instead.
89 - `purge_preferences` - This parameter was removed. Use `purge => { 'preferences' => <bool> }` instead.
90 - `purge_preferences_d` - This parameter was removed. Use `purge => { 'preferences.d' => <bool> }` instead.
91 - `update_timeout` - This parameter was removed. Use `update => { 'timeout' => <timeout> }` instead.
92 - `update_tries` - This parameter was removed. Use `update => { 'tries' => <tries> }` instead.
93
94 #####`apt::key`
95 - `key` - This parameter was renamed to `id`.
96 - `key_content` - This parameter was renamed to `content`.
97 - `key_source` - This parameter was renamed to `source`.
98 - `key_server` - This parameter was renamed to `server`.
99 - `key_options` - This parameter was renamed to `options`.
100
101 #####`apt::release`
102 - This class was removed. See this [example](examples/release.pp) for how to achieve this functionality.
103
104 #####`apt::source`
105 - `include_src` - This parameter was removed. Use `include => { 'src' => <bool> }` instead. ***NOTE*** This now defaults to false.
106 - `include_deb` - This parameter was removed. Use `include => { 'deb' => <bool> }` instead.
107 - `required_packages` - This parameter was removed. Use package resources for these packages if needed.
108 - `key` - This can either be a key id or a hash including key options. If using a hash, `key => { 'id' => <id> }` must be specified.
109 - `key_server` - This parameter was removed. Use `key => { 'server' => <server> }` instead.
110 - `key_content` - This parameter was removed. Use `key => { 'content' => <content> }` instead.
111 - `key_source` - This parameter was removed. Use `key => { 'source' => <source> }` instead.
112 - `trusted_source` - This parameter was renamed to `allow_unsigned`.
113
114 #####`apt::unattended_upgrades`
115 - 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).
116
117 ####Changes to default behavior
118 - By default purge unmanaged files in 'sources.list', 'sources.list.d', 'preferences', and 'preferences.d'.
119 - 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.
120 - `apt::source` will no longer include the `src` entries by default. 
121 - `pin` in `apt::source` now defaults to `undef` instead of `false`
122
123 ####Features
124 - Added the ability to pass hashes of `apt::key`s, `apt::ppa`s, and `apt::setting`s to `apt`.
125 - Added 'https' key to `proxy` hash to allow disabling `https_proxy` for the `apt::ppa` environment.
126 - Added `apt::setting` define to abstract away configuration.
127 - Added the ability to pass hashes to `pin` and `key` in `apt::backports` and `apt::source`.
128
129 ####Bugfixes
130 - Fixes for strict variables.
131
132 ##2015-03-17 - Supported Release 1.8.0
133 ###Summary
134
135 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.
136
137 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.
138
139 ####Changes to default behavior
140 - The apt module will now throw warnings if you don't use full fingerprints for `apt_key`s
141
142 ####Features
143 - Use gpg to check keys to work around https://bugs.launchpad.net/ubuntu/+source/gnupg2/+bug/1409117 (MODULES-1675)
144 - Add 'oldstable' to the default update origins for wheezy
145 - Add utopic, vivid, and cumulus compatibility
146 - Add support for full fingerprints
147 - New parameter for `apt::source`
148   - `trusted_source`
149 - New parameters for `apt::ppa`
150   - `package_name`
151   - `package_manage`
152 - New parameter for `apt::unattended_upgrades`
153   - `legacy_origin`
154 - Separate `apt::pin` from `apt::backports` to allow pin by release instead of origin
155
156 ####Bugfixes
157 - Cleanup lint and future parser issues
158 - Fix to support username and passwords again for `apt_key` (MODULES-1119)
159 - Fix issue where `apt::force` `$install_check` didn't work with non-English locales (MODULES-1231)
160 - Allow 5 digit ports in `apt_key`
161 - Fix for `ensure => absent` in `apt_key` (MODULES-1661)
162 - Fix `apt_has_updates` not parsing `apt-check` output correctly
163 - Fix inconsistent headers across files (MODULES-1200)
164 - Clean up formatting for 50unattended-upgrades.erb
165
166 ##2014-10-28 - Supported Release 1.7.0
167 ###Summary
168
169 This release includes several new features, documentation and test improvements, and a few bug fixes.
170
171 ####Features
172 - Updated unit and acceptance tests
173 - Update module to work with Linux Mint
174 - Documentation updates
175 - Future parser / strict variables support
176 - Improved support for long GPG keys
177 - New parameters!
178   - Added `apt_update_frequency` to apt
179   - Added `cfg_files` and `cfg_missing` parameters to apt::force
180   - Added `randomsleep` to apt::unattended_upgrades
181 - Added `apt_update_last_success` fact
182 - Refactored facts for performance improvements
183
184 ####Bugfixes
185 - Update apt::builddep to require Exec['apt_update'] instead of notifying it
186 - Clean up lint errors
187
188 ##2014-08-20 - Supported Release 1.6.0
189 ###Summary
190
191 ####Features
192 - Allow URL or domain name for key_server parameter
193 - Allow custom comment for sources list
194 - Enable auto-update for Debian squeeze LTS
195 - Add facts showing available updates
196 - Test refactoring
197
198 ####Bugfixes
199 - Allow dashes in URL or domain for key_server parameter
200
201 ##2014-08-13 - Supported Release 1.5.3
202 ###Summary
203
204 This is a bugfix releases.  It addresses a bad regex, failures with unicode
205 characters, and issues with the $proxy_host handling in apt::ppa.
206
207 ####Features
208 - Synced files from Modulesync
209
210 ####Bugfixes
211 - Fix regex to follow APT requirements in apt::pin
212 - Fix for unicode characters
213 - Fix inconsistent $proxy_host handling in apt and apt::ppa
214 - Fix typo in README
215 - Fix broken acceptance tests
216
217 ##2014-07-15 - Supported Release 1.5.2
218 ###Summary
219
220 This release merely updates metadata.json so the module can be uninstalled and
221 upgraded via the puppet module command.
222
223 ##2014-07-10 - Supported Release 1.5.1
224 ###Summary
225
226 This release has added tests to ensure graceful failure on OSX.
227
228 ##2014-06-04 - Release 1.5.0
229 ###Summary
230
231 This release adds support for Ubuntu 14.04.  It also includes many new features 
232 and important bugfixes.  One huge change is that apt::key was replaced with
233 apt_key, which allows you to use puppet resource apt_key to inventory keys on
234 your system.
235
236 Special thanks to daenney, our intrepid unofficial apt maintainer!
237
238 ####Features
239 - Add support for Ubuntu Trusty!
240 - Add apt::hold define
241 - Generate valid *.pref files in apt::pin
242 - Made pin_priority configurable for apt::backports
243 - Add apt_key type and provider
244 - Rename "${apt_conf_d}/proxy" to "${apt_conf_d}/01proxy"
245 - apt::key rewritten to use apt_key type
246 - Add support for update_tries to apt::update
247
248 ####Bugfixes
249 - Typo fixes
250 - Fix unattended upgrades
251 - Removed bogus line when using purge_preferences
252 - Fix apt::force to upgrade allow packages to be upgraded to the pacakge from the specified release
253
254 ##2014-03-04 - Supported Release 1.4.2
255 ###Summary
256
257 This is a supported release. This release tidies up 1.4.1 and re-enables
258 support for Ubuntu 10.04
259
260 ####Features
261
262 ####Bugfixes
263 - Fix apt:ppa to include the -y Ubuntu 10.04 requires.
264 - Documentation changes.
265 - Test fixups.
266
267 ####Known Bugs
268
269 * No known issues.
270
271
272
273 ##2014-02-13 1.4.1
274 ###Summary
275 This is a bugfix release.
276
277 ####Bugfixes
278 - Fix apt::force unable to upgrade packages from releases other than its original
279 - Removed a few refeneces to aptitude instead of apt-get for portability
280 - Removed call to getparam() due to stdlib dependency
281 - Correct apt::source template when architecture is provided
282 - Retry package installs if apt is locked
283 - Use root to exec in apt::ppa
284 - Updated tests and converted acceptance tests to beaker
285
286 ##2013-10-08 - Release 1.4.0
287
288 ###Summary
289
290 Minor bugfix and allow the timeout to be adjusted.
291
292 ####Features
293 - Add an `updates_timeout` to apt::params
294
295 ####Bugfixes
296 - Ensure apt::ppa can read a ppa removed by hand.
297
298
299 ##2013-10-08 - Release 1.3.0
300 ###Summary
301
302 This major feature in this release is the new apt::unattended_upgrades class,
303 allowing you to handle Ubuntu's unattended feature.  This allows you to select
304 specific packages to automatically upgrade without any further user
305 involvement.
306
307 In addition we extend our Wheezy support, add proxy support to apt:ppa and do
308 various cleanups and tweaks.
309
310 ####Features
311 - Add apt::unattended_upgrades support for Ubuntu.
312 - Add wheezy backports support.
313 - Use the geoDNS http.debian.net instead of the main debian ftp server.
314 - Add `options` parameter to apt::ppa in order to pass options to apt-add-repository command.
315 - Add proxy support for apt::ppa (uses proxy_host and proxy_port from apt).
316
317 ####Bugfixes
318 - Fix regsubst() calls to quote single letters (for future parser).
319 - Fix lint warnings and other misc cleanup.
320
321
322 ##2013-07-03 - Release 1.2.0
323
324 ####Features
325 - Add geppetto `.project` natures
326 - Add GH auto-release
327 - Add `apt::key::key_options` parameter
328 - Add complex pin support using distribution properties for `apt::pin` via new properties:
329   - `apt::pin::codename`
330   - `apt::pin::release_version`
331   - `apt::pin::component`
332   - `apt::pin::originator`
333   - `apt::pin::label`
334 - Add source architecture support to `apt::source::architecture`
335
336 ####Bugfixes
337 - Use apt-get instead of aptitude in apt::force
338 - Update default backports location
339 - Add dependency for required packages before apt-get update
340
341
342 ##2013-06-02 - Release 1.1.1
343 ###Summary
344
345 This is a bug fix release that resolves a number of issues:
346
347 * By changing template variable usage, we remove the deprecation warnings
348   for Puppet 3.2.x
349 * Fixed proxy file removal, when proxy absent
350
351 Some documentation, style and whitespaces changes were also merged. This
352 release also introduced proper rspec-puppet unit testing on Travis-CI to help
353 reduce regression.
354
355 Thanks to all the community contributors below that made this patch possible.
356
357 #### Detail Changes
358
359 * fix minor comment type (Chris Rutter)
360 * whitespace fixes (Michael Moll)
361 * Update travis config file (William Van Hevelingen)
362 * Build all branches on travis (William Van Hevelingen)
363 * Standardize travis.yml on pattern introduced in stdlib (William Van Hevelingen)
364 * Updated content to conform to README best practices template (Lauren Rother)
365 * Fix apt::release example in readme (Brian Galey)
366 * add @ to variables in template (Peter Hoeg)
367 * Remove deprecation warnings for pin.pref.erb as well (Ken Barber)
368 * Update travis.yml to latest versions of puppet (Ken Barber)
369 * Fix proxy file removal (Scott Barber)
370 * Add spec test for removing proxy configuration (Dean Reilly)
371 * Fix apt::key listing longer than 8 chars (Benjamin Knofe)
372
373
374
375
376 ## Release 1.1.0
377 ###Summary
378
379 This release includes Ubuntu 12.10 (Quantal) support for PPAs.
380
381 ---
382
383 ##2012-05-25 - Puppet Labs <info@puppetlabs.com> - Release 0.0.4
384 ###Summary
385
386  * Fix ppa list filename when there is a period in the PPA name
387  * Add .pref extension to apt preferences files
388  * Allow preferences to be purged
389  * Extend pin support
390
391
392 ##2012-05-04 - Puppet Labs <info@puppetlabs.com> - Release 0.0.3
393 ###Summary
394  
395  * only invoke apt-get update once
396  * only install python-software-properties if a ppa is added
397  * support 'ensure => absent' for all defined types
398  * add apt::conf
399  * add apt::backports
400  * fixed Modulefile for module tool dependency resolution
401  * configure proxy before doing apt-get update
402  * use apt-get update instead of aptitude for apt::ppa
403  * add support to pin release
404
405
406 ##2012-03-26 - Puppet Labs <info@puppetlabs.com> - Release 0.0.2
407 ###Summary
408
409 * 41cedbb (#13261) Add real examples to smoke tests.
410 * d159a78 (#13261) Add key.pp smoke test
411 * 7116c7a (#13261) Replace foo source with puppetlabs source
412 * 1ead0bf Ignore pkg directory.
413 * 9c13872 (#13289) Fix some more style violations
414 * 0ea4ffa (#13289) Change test scaffolding to use a module & manifest dir fixture path
415 * a758247 (#13289) Clean up style violations and fix corresponding tests
416 * 99c3fd3 (#13289) Add puppet lint tests to Rakefile
417 * 5148cbf (#13125) Apt keys should be case insensitive
418 * b9607a4 Convert apt::key to use anchors
419
420
421 ##2012-03-07 - Puppet Labs <info@puppetlabs.com> - Release 0.0.1
422 ###Summary
423
424 * d4fec56 Modify apt::source release parameter test
425 * 1132a07 (#12917) Add contributors to README
426 * 8cdaf85 (#12823) Add apt::key defined type and modify apt::source to use it
427 * 7c0d10b (#12809) $release should use $lsbdistcodename and fall back to manual input
428 * be2cc3e (#12522) Adjust spec test for splitting purge
429 * 7dc60ae (#12522) Split purge option to spare sources.list
430 * 9059c4e Fix source specs to test all key permutations
431 * 8acb202 Add test for python-software-properties package
432 * a4af11f Check if python-software-properties is defined before attempting to define it.
433 * 1dcbf3d Add tests for required_packages change
434 * f3735d2 Allow duplicate $required_packages
435 * 74c8371 (#12430) Add tests for changes to apt module
436 * 97ebb2d Test two sources with the same key
437 * 1160bcd (#12526) Add ability to reverse apt { disable_keys => true }
438 * 2842d73 Add Modulefile to puppet-apt
439 * c657742 Allow the use of the same key in multiple sources
440 * 8c27963 (#12522) Adding purge option to apt class
441 * 997c9fd (#12529) Add unit test for apt proxy settings
442 * 50f3cca (#12529) Add parameter to support setting a proxy for apt
443 * d522877 (#12094) Replace chained .with_* with a hash
444 * 8cf1bd0 (#12094) Remove deprecated spec.opts file
445 * 2d688f4 (#12094) Add rspec-puppet tests for apt
446 * 0fb5f78 (#12094) Replace name with path in file resources
447 * f759bc0 (#11953) Apt::force passes $version to aptitude
448 * f71db53 (#11413) Add spec test for apt::force to verify changes to unless
449 * 2f5d317 (#11413) Update dpkg query used by apt::force
450 * cf6caa1 (#10451) Add test coverage to apt::ppa
451 * 0dd697d include_src parameter in example; Whitespace cleanup
452 * b662eb8 fix typos in "repositories"
453 * 1be7457 Fix (#10451) - apt::ppa fails to "apt-get update" when new PPA source is added
454 * 864302a Set the pin priority before adding the source (Fix #10449)
455 * 1de4e0a Refactored as per mlitteken
456 * 1af9a13 Added some crazy bash madness to check if the ppa is installed already. Otherwise the manifest tries to add it on every run!
457 * 52ca73e (#8720) Replace Apt::Ppa with Apt::Builddep
458 * 5c05fa0 added builddep command.
459 * a11af50 added the ability to specify the content of a key
460 * c42db0f Fixes ppa test.
461 * 77d2b0d reformatted whitespace to match recommended style of 2 space indentation.
462 * 27ebdfc ignore swap files.
463 * 377d58a added smoke tests for module.
464 * 18f614b reformatted apt::ppa according to recommended style.
465 * d8a1e4e Created a params class to hold global data.
466 * 636ae85 Added two params for apt class
467 * 148fc73 Update LICENSE.
468 * ed2d19e Support ability to add more than one PPA
469 * 420d537 Add call to apt-update after add-apt-repository in apt::ppa
470 * 945be77 Add package definition for python-software-properties
471 * 71fc425 Abs paths for all commands
472 * 9d51cd1 Adding LICENSE
473 * 71796e3 Heading fix in README
474 * 87777d8 Typo in README
475 * f848bac First commit