digital-forensics-labs/SecGen
1
0
Fork 0
mirror of https://github.com/cliffe/SecGen.git synced 2026-02-21 11:18:06 +00:00
Code Issues Packages Projects Releases Wiki Activity

removed apt module

Browse Source
This commit is contained in:
ts
2019-01-19 16:04:06 +00:00
parent 8c5b5f8670
commit acf645c749
96 changed files with 0 additions and 11082 deletions
Download Patch File Download Diff File Expand all files Collapse all files

758
modules/utilities/unix/package_management/apt/CHANGELOG.md
View File

@@ -1,758 +0,0 @@
# Change log
All 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/) and this project adheres to [Semantic Versioning](http://semver.org).
## [6.2.1](https://github.com/puppetlabs/puppetlabs-apt/tree/6.2.1) (2018-11-20)
[Full Changelog](https://github.com/puppetlabs/puppetlabs-apt/compare/6.2.0...6.2.1)
### Fixed
- \(MODULES-8272\) - Revert "Autorequire dirmngr in apt\_key types" [\#825](https://github.com/puppetlabs/puppetlabs-apt/pull/825) ([eimlav](https://github.com/eimlav))
## [6.2.0](https://github.com/puppetlabs/puppetlabs-apt/tree/6.2.0) (2018-11-19)
[Full Changelog](https://github.com/puppetlabs/puppetlabs-apt/compare/6.1.1...6.2.0)
### Added
- \(MODULES-8081\): add support for hkps:// protocol in apt::key [\#815](https://github.com/puppetlabs/puppetlabs-apt/pull/815) ([simondeziel](https://github.com/simondeziel))
### Fixed
- Apt-key fixes to properly work on Debian 9 [\#822](https://github.com/puppetlabs/puppetlabs-apt/pull/822) ([ekohl](https://github.com/ekohl))
- \(maint\) - Update Link to REFERENCE.md [\#811](https://github.com/puppetlabs/puppetlabs-apt/pull/811) ([pmcmaw](https://github.com/pmcmaw))
## [6.1.1](https://github.com/puppetlabs/puppetlabs-apt/tree/6.1.1) (2018-10-01)
[Full Changelog](https://github.com/puppetlabs/puppetlabs-apt/compare/6.1.0...6.1.1)
### Fixed
- Revert "\(MODULES-6408\) - Fix dirmngr install failing" [\#808](https://github.com/puppetlabs/puppetlabs-apt/pull/808) ([eimlav](https://github.com/eimlav))
## [6.1.0](https://github.com/puppetlabs/puppetlabs-apt/tree/6.1.0) (2018-09-28)
[Full Changelog](https://github.com/puppetlabs/puppetlabs-apt/compare/6.0.0...6.1.0)
### Added
- pdksync - \(FM-7392\) - Puppet 6 Testing Changes [\#800](https://github.com/puppetlabs/puppetlabs-apt/pull/800) ([pmcmaw](https://github.com/pmcmaw))
- pdksync - \(MODULES-6805\) metadata.json shows support for puppet 6 [\#798](https://github.com/puppetlabs/puppetlabs-apt/pull/798) ([tphoney](https://github.com/tphoney))
- \(MODULES-3307\) - Auto update expired keys [\#795](https://github.com/puppetlabs/puppetlabs-apt/pull/795) ([eimlav](https://github.com/eimlav))
- \(FM-7316\) - Implementation of the i18n process [\#789](https://github.com/puppetlabs/puppetlabs-apt/pull/789) ([david22swan](https://github.com/david22swan))
- Introduce an Apt::Proxy type to validate the hash [\#773](https://github.com/puppetlabs/puppetlabs-apt/pull/773) ([ekohl](https://github.com/ekohl))
### Fixed
- \(MODULES-6408\) - Fix dirmngr install failing [\#801](https://github.com/puppetlabs/puppetlabs-apt/pull/801) ([eimlav](https://github.com/eimlav))
- \(MODULES-1630\) - Expanding source list fix to cover all needed versions [\#788](https://github.com/puppetlabs/puppetlabs-apt/pull/788) ([david22swan](https://github.com/david22swan))
## [6.0.0](https://github.com/puppetlabs/puppetlabs-apt/tree/6.0.0) (2018-08-24)
[Full Changelog](https://github.com/puppetlabs/puppetlabs-apt/compare/5.0.1...6.0.0)
### Changed
- \(MODULES-7668\) Remove support for Puppet 4.7 [\#780](https://github.com/puppetlabs/puppetlabs-apt/pull/780) ([jarretlavallee](https://github.com/jarretlavallee))
### Added
- Check existence of gpg key in apt:ppa [\#774](https://github.com/puppetlabs/puppetlabs-apt/pull/774) ([wenzhengjiang](https://github.com/wenzhengjiang))
- Make sure PPA source file is absent when apt-add-repository fails [\#768](https://github.com/puppetlabs/puppetlabs-apt/pull/768) ([wenzhengjiang](https://github.com/wenzhengjiang))
## 5.0.1
[Full Changelog](https://github.com/puppetlabs/puppetlabs-apt/compare/5.0.0...5.0.1)
### Fixed
- \(MODULES-7540\) - add apt-transport-https with https [\#775](https://github.com/puppetlabs/puppetlabs-apt/pull/775) ([tphoney](https://github.com/tphoney))
## [5.0.0](https://github.com/puppetlabs/puppetlabs-apt/tree/5.0.0) (2018-07-18)
[Full Changelog](https://github.com/puppetlabs/puppetlabs-apt/compare/4.5.1...5.0.0)
### Changed
- \[FM-6956\] Removal of unsupported Debian 7 from apt [\#760](https://github.com/puppetlabs/puppetlabs-apt/pull/760) ([david22swan](https://github.com/david22swan))
### Added
- \(MODULES-7467\) Update apt to support Ubuntu 18.04 [\#769](https://github.com/puppetlabs/puppetlabs-apt/pull/769) ([david22swan](https://github.com/david22swan))
- Support managing login configurations in /etc/apt/auth.conf [\#752](https://github.com/puppetlabs/puppetlabs-apt/pull/752) ([antaflos](https://github.com/antaflos))
### Fixed
- \(MODULES-7327\) - Update README with supported OS [\#767](https://github.com/puppetlabs/puppetlabs-apt/pull/767) ([pmcmaw](https://github.com/pmcmaw))
- \(bugfix\) Dont run ftp tests in travis [\#766](https://github.com/puppetlabs/puppetlabs-apt/pull/766) ([tphoney](https://github.com/tphoney))
- \(maint\) make apt testing more stable, cleanup [\#764](https://github.com/puppetlabs/puppetlabs-apt/pull/764) ([tphoney](https://github.com/tphoney))
- Remove .length from variable $pin\_release in app [\#754](https://github.com/puppetlabs/puppetlabs-apt/pull/754) ([paladox](https://github.com/paladox))
- Replace UTF-8 whitespace in comment [\#748](https://github.com/puppetlabs/puppetlabs-apt/pull/748) ([bernhardschmidt](https://github.com/bernhardschmidt))
- Fix "E: Unable to locate package -y" [\#747](https://github.com/puppetlabs/puppetlabs-apt/pull/747) ([aboks](https://github.com/aboks))
- Fix automatic coercion warning [\#743](https://github.com/puppetlabs/puppetlabs-apt/pull/743) ([smortex](https://github.com/smortex))
## Supported Release [4.5.1]
### Summary
This release fixes CVE-2018-6508 which is a potential arbitrary code execution via tasks.
### Fixed
- Fix init task for arbitrary remote code
## Supported Release [4.5.0]
### Summary
This release uses the PDK convert functionality which in return makes the module PDK compliant. It also includes a roll up of maintenance changes.
### Added
- PDK convert apt ([MODULES-6452](https://tickets.puppet.com/browse/MODULES-6452)).
- Testing on Travis using rvm 2.4.1.
- Modulesync updates.
### Fixed
- Changes to address additional Rubocop failures.
- (maint) Addressing puppet-lint doc warnings.
### Removed
- `gem update bundler` command in .travis.yml due to ([MODULES-6339](https://tickets.puppet.com/browse/MODULES-6339)).
## Supported Release [4.4.1]
### Summary
This release is to update the formatting of the module, Rubocop having been run for all ruby files and been set to run automatically on all future commits.
### Changed
- Rubocop has been implemented.
## Supported Release [4.4.0]
### Summary
This release is a rollup of new features and fixes.
#### Added
- Install `apt-transport-https` if using Debian 7, 8, 9 or Ubuntu 14.04, 16.04.
- Adds a boolean option `direct` to proxy settings to bypass `https_proxy` if not set.
- Adds facter facts for `dist-upgrade` apt updates.
#### Changed
- Update class is now private.
- Some tidyup of ruby code from Rubocop.
- Fixed circular dependency for package dirmngr.
- Debian updates are no longer treated as security updates.
- Legacy functions have been removed.
- Updates to tests.
#### Fixed
- [(MODULES-4265)](https://tickets.puppetlabs.com/browse/MODULES-4265) Detect security updates from multiple sources.
## Supported Release [4.3.0]
### Summary
This release is adding Tasks to the apt module.
#### Added
- Add a task that allows apt-get update and upgrade
## Supported Release [4.2.0]
### Summary
This release is primarily to fix an error around GPG keys in Debian 9, but includes some other small features and fixes as well.
#### Added
- `apt_package_security_updates` fact
- The ability to modify the loglevel of `Exec['apt_update'}`
- Puppet 5 support
#### Changed
- Ubuntu 16.04 now uses `software-priorities-common`
#### Removed
- Debian 6, Ubuntu 10.04 and 12.04 support. Existing compatibility remains intact but bugs will not be prioritized for these OSes.
#### Fixed
- **[(MODULES-4686)](https://tickets.puppetlabs.com/browse/MODULES-4686) an error that was causing GPG keyserver imports to fail on Debian 9**
## Supported Release 4.1.0
### Summary
This release removes Data in Modules due to current compatibility issues and reinstates the params.pp file. Also includes a couple of bug fixes.
#### Features
- (MODULES-4973) Data in Modules which was introduced in the last release has now been reverted due to compatibility issues.
#### Bugfixes
- Now apt_key only sends the auth basic header when userinfo can be parsed from the URL.
- Reverted the removal of Evolving Web's attribution in NOTICE file.
- Test added to ensure empty string allowed for $release in apt::source.
## Supported Release 3.0.0 and 4.0.0
### Summary
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
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.
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.
#### Changes
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.
EPP templating: Uses the Puppet language as a base for templates to create simpler and safer templates. No need for Ruby anymore!
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.
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.
#### Bugfixes
- Fix apt::source epp template regression introduced in 3.0.0 for the architecture parameter
## Supported Release 2.4.0
### Summary
A release that includes only a couple of additional features, but includes several cleanups and bugfixes around existing issues.
#### Features
- Tests updated to check for idempotency.
- (MODULES-4224) Implementation of beaker-module_install_helper.
- Deprecation warnings are now handled by the deprecation function in stdlib.
#### Bugfixes
- Now http and https sources fixed for apt_key and can take a userinfo.
- GPG key update.
- Notify_update param now defaults to true to avoid validation errors.
- Implement retry on tests which pull key from a key server which sometimes times out (transient error).
- String comparison error now comphensated for in update.pp.
- (MODULES-4104) Removal of the port number from repository location in order to get the host name of the repository.
- Puppet lint warnings addressed.
- A few small readme issues addressed.
## Supported Release 2.3.0
### Summary
A release containing many bugfixes with additional features.
#### Features
- Apt_updates facts now use /usr/bin/apt-get.
- Addition of notify update to apt::source.
- Update to newest modulesync_configs.
- Installs software-properties-common for Xenial.
- Modulesync updates.
- Add ability to specify a hash of apt::conf defines.
#### Bugfixes
- A clean up of spec/defines/key_compat_specs, also now runs under STRICT_VARIABLES.
- Apt::setting expects priority to be an integer, set defaults accordingly.
- Fixed version check for Ubuntu on 16.04.
- Now uses hkps.pool.sks-keyservers.net instead of pgp.mit.edu.
- Updates and fixes to tests. General cleanup.
- Fixed regexp for $ensure params.
- Apt/params: Remove unused LSB facts.
- 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.
- 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.
## Supported Release 2.2.2
### Summary
Several bug fixes and the addition of support updates to Debian 8 and Ubuntu Wily.
#### Bugfixes
- Small fixes to descriptions within the readme and the addition of some examples.
- Updates to run on Ubuntu Wily.
- Fixed apt_key tempfile race condition.
- Run stages limitation added to the documentation.
- Remove unneeded whitespace in source.list template.
- Handle PPA names that contain a plus character.
- Update to current msync configs.
- Avoid duplicate package resources when package_manage => true.
- Avoid multiple package resource declarations.
- Ensure PPAs in tests have valid form.
- Look for correct sources.list.d file for apt::ppa.
- Debian 8 support addiiton to metadata.
## Supported Release 2.2.1
### Summary
Small release for support of newer PE versions. This increments the version of PE in the metadata.json file.
## 2015-09-29 - Supported Release 2.2.0
### Summary
This release includes a few bugfixes.
#### Features
- Adds an `ensure` parameter for user control of proxy presence.
- Adds ability to set `notify_update` to `apt::conf` (MODULES-2269).
- Apt pins no longer trigger an `apt-get update` run.
- Adds support for creating pins from main class.
#### Bugfixes
- Updates to use the official Debian mirrors.
- Fixes path to `preferences` and `preferences.d`
- Fixes pinning for backports (MODULES-2446).
- Fixes the name/extension of the preferences files.
## 2015-07-28 - Supported Release 2.1.1
### Summary
This release includes a few bugfixes.
#### Bugfixes
- Fix incorrect use of anchoring (MODULES-2190)
- Use correct comment type for apt.conf files
- Test fixes
- Documentation fixes
## 2015-06-16 - Supported Release 2.1.0
### Summary
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.
#### Features
- Add API compatibility to `apt::key` and `apt::source`
- Added `apt_reboot_required` fact
#### Bugfixes
- Fix compatibility with Puppet versions 3.0-3.4
- Work around future parser bug PUP-4133
## 2015-04-28 - Supported Release 2.0.1
### Summary
This bug fixes a few compatibility issues that came up with the 2.0.0 release, and includes test and documentation updates.
#### Bugfixes
- Fix incompatibility with keyrings containing multiple keys
- Fix bugs preventing the module from working with Puppet < 3.5.0
## 2015-04-07 - Supported Release 2.0.0
### Summary
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.
#### Backwards-incompatible changes
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.
##### `apt_key`
- `keyserver_options` parameter renamed to `options`
##### `apt::backports`
- 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)
##### `apt::builddep`
- This define was removed. Functionality can be matched passing 'build-dep' to `install_options` in the package resource. [Example](examples/builddep.pp)
##### `apt::debian::testing`
- This class was removed. Manually add an `apt::source` instead. [Example](examples/debian_testing.pp)
##### `apt::debian::unstable`
- This class was removed. Manually add an `apt::source` instead. [Example](examples/debian_unstable.pp)
##### `apt::force`
- 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.
##### `apt::hold`
- This define was removed. Simply use an `apt::pin` with `priority => 1001` for the same functionality.
##### `apt`
- `always_apt_update` - This parameter was removed. Use `update => { 'frequency' => 'always' }` instead.
- `apt_update_frequency` - This parameter was removed. Use `update => { 'frequency' => <frequency> }` instead.
- `disable_keys` - This parameter was removed. See this [example](examples/disable_keys.pp) if you need this functionality.
- `proxy_host` - This parameter was removed. Use `proxy => { 'host' => <host> }` instead.
- `proxy_port` - This parameter was removed. Use `proxy => { 'port' => <port> }` instead.
- `purge_sources_list` - This parameter was removed. Use `purge => { 'sources.list' => <bool> }` instead.
- `purge_sources_list_d` - This parameter was removed. Use `purge => { 'sources.list.d' => <bool> }` instead.
- `purge_preferences` - This parameter was removed. Use `purge => { 'preferences' => <bool> }` instead.
- `purge_preferences_d` - This parameter was removed. Use `purge => { 'preferences.d' => <bool> }` instead.
- `update_timeout` - This parameter was removed. Use `update => { 'timeout' => <timeout> }` instead.
- `update_tries` - This parameter was removed. Use `update => { 'tries' => <tries> }` instead.
##### `apt::key`
- `key` - This parameter was renamed to `id`.
- `key_content` - This parameter was renamed to `content`.
- `key_source` - This parameter was renamed to `source`.
- `key_server` - This parameter was renamed to `server`.
- `key_options` - This parameter was renamed to `options`.
##### `apt::release`
- This class was removed. See this [example](examples/release.pp) for how to achieve this functionality.
##### `apt::source`
- `include_src` - This parameter was removed. Use `include => { 'src' => <bool> }` instead. ***NOTE*** This now defaults to false.
- `include_deb` - This parameter was removed. Use `include => { 'deb' => <bool> }` instead.
- `required_packages` - This parameter was removed. Use package resources for these packages if needed.
- `key` - This can either be a key id or a hash including key options. If using a hash, `key => { 'id' => <id> }` must be specified.
- `key_server` - This parameter was removed. Use `key => { 'server' => <server> }` instead.
- `key_content` - This parameter was removed. Use `key => { 'content' => <content> }` instead.
- `key_source` - This parameter was removed. Use `key => { 'source' => <source> }` instead.
- `trusted_source` - This parameter was renamed to `allow_unsigned`.
##### `apt::unattended_upgrades`
- 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).
#### Changes to default behavior
- By default purge unmanaged files in 'sources.list', 'sources.list.d', 'preferences', and 'preferences.d'.
- 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.
- `apt::source` will no longer include the `src` entries by default.
- `pin` in `apt::source` now defaults to `undef` instead of `false`
#### Features
- Added the ability to pass hashes of `apt::key`s, `apt::ppa`s, and `apt::setting`s to `apt`.
- Added 'https' key to `proxy` hash to allow disabling `https_proxy` for the `apt::ppa` environment.
- Added `apt::setting` define to abstract away configuration.
- Added the ability to pass hashes to `pin` and `key` in `apt::backports` and `apt::source`.
#### Bugfixes
- Fixes for strict variables.
## 2015-03-17 - Supported Release 1.8.0
### Summary
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.
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.
#### Changes to default behavior
- The apt module will now throw warnings if you don't use full fingerprints for `apt_key`s
#### Features
- Use gpg to check keys to work around https://bugs.launchpad.net/ubuntu/+source/gnupg2/+bug/1409117 (MODULES-1675)
- Add 'oldstable' to the default update origins for wheezy
- Add utopic, vivid, and cumulus compatibility
- Add support for full fingerprints
- New parameter for `apt::source`
- `trusted_source`
- New parameters for `apt::ppa`
- `package_name`
- `package_manage`
- New parameter for `apt::unattended_upgrades`
- `legacy_origin`
- Separate `apt::pin` from `apt::backports` to allow pin by release instead of origin
#### Bugfixes
- Cleanup lint and future parser issues
- Fix to support username and passwords again for `apt_key` (MODULES-1119)
- Fix issue where `apt::force` `$install_check` didn't work with non-English locales (MODULES-1231)
- Allow 5 digit ports in `apt_key`
- Fix for `ensure => absent` in `apt_key` (MODULES-1661)
- Fix `apt_has_updates` not parsing `apt-check` output correctly
- Fix inconsistent headers across files (MODULES-1200)
- Clean up formatting for 50unattended-upgrades.erb
## 2014-10-28 - Supported Release 1.7.0
### Summary
This release includes several new features, documentation and test improvements, and a few bug fixes.
#### Features
- Updated unit and acceptance tests
- Update module to work with Linux Mint
- Documentation updates
- Future parser / strict variables support
- Improved support for long GPG keys
- New parameters!
- Added `apt_update_frequency` to apt
- Added `cfg_files` and `cfg_missing` parameters to apt::force
- Added `randomsleep` to apt::unattended_upgrades
- Added `apt_update_last_success` fact
- Refactored facts for performance improvements
#### Bugfixes
- Update apt::builddep to require Exec['apt_update'] instead of notifying it
- Clean up lint errors
## 2014-08-20 - Supported Release 1.6.0
### Summary
#### Features
- Allow URL or domain name for key_server parameter
- Allow custom comment for sources list
- Enable auto-update for Debian squeeze LTS
- Add facts showing available updates
- Test refactoring
#### Bugfixes
- Allow dashes in URL or domain for key_server parameter
## 2014-08-13 - Supported Release 1.5.3
### Summary
This is a bugfix releases. It addresses a bad regex, failures with unicode
characters, and issues with the $proxy_host handling in apt::ppa.
#### Features
- Synced files from Modulesync
#### Bugfixes
- Fix regex to follow APT requirements in apt::pin
- Fix for unicode characters
- Fix inconsistent $proxy_host handling in apt and apt::ppa
- Fix typo in README
- Fix broken acceptance tests
## 2014-07-15 - Supported Release 1.5.2
### Summary
This release merely updates metadata.json so the module can be uninstalled and
upgraded via the puppet module command.
## 2014-07-10 - Supported Release 1.5.1
### Summary
This release has added tests to ensure graceful failure on OSX.
## 2014-06-04 - Release 1.5.0
### Summary
This release adds support for Ubuntu 14.04. It also includes many new features
and important bugfixes. One huge change is that apt::key was replaced with
apt_key, which allows you to use puppet resource apt_key to inventory keys on
your system.
Special thanks to daenney, our intrepid unofficial apt maintainer!
#### Features
- Add support for Ubuntu Trusty!
- Add apt::hold define
- Generate valid *.pref files in apt::pin
- Made pin_priority configurable for apt::backports
- Add apt_key type and provider
- Rename "${apt_conf_d}/proxy" to "${apt_conf_d}/01proxy"
- apt::key rewritten to use apt_key type
- Add support for update_tries to apt::update
#### Bugfixes
- Typo fixes
- Fix unattended upgrades
- Removed bogus line when using purge_preferences
- Fix apt::force to upgrade allow packages to be upgraded to the pacakge from the specified release
## 2014-03-04 - Supported Release 1.4.2
### Summary
This is a supported release. This release tidies up 1.4.1 and re-enables
support for Ubuntu 10.04
#### Features
#### Bugfixes
- Fix apt:ppa to include the -y Ubuntu 10.04 requires.
- Documentation changes.
- Test fixups.
#### Known Bugs
* No known issues.
## 2014-02-13 1.4.1
### Summary
This is a bugfix release.
#### Bugfixes
- Fix apt::force unable to upgrade packages from releases other than its original
- Removed a few refeneces to aptitude instead of apt-get for portability
- Removed call to getparam() due to stdlib dependency
- Correct apt::source template when architecture is provided
- Retry package installs if apt is locked
- Use root to exec in apt::ppa
- Updated tests and converted acceptance tests to beaker
## 2013-10-08 - Release 1.4.0
### Summary
Minor bugfix and allow the timeout to be adjusted.
#### Features
- Add an `updates_timeout` to apt::params
#### Bugfixes
- Ensure apt::ppa can read a ppa removed by hand.
## 2013-10-08 - Release 1.3.0
### Summary
This major feature in this release is the new apt::unattended_upgrades class,
allowing you to handle Ubuntu's unattended feature. This allows you to select
specific packages to automatically upgrade without any further user
involvement.
In addition we extend our Wheezy support, add proxy support to apt:ppa and do
various cleanups and tweaks.
#### Features
- Add apt::unattended_upgrades support for Ubuntu.
- Add wheezy backports support.
- Use the geoDNS http.debian.net instead of the main debian ftp server.
- Add `options` parameter to apt::ppa in order to pass options to apt-add-repository command.
- Add proxy support for apt::ppa (uses proxy_host and proxy_port from apt).
#### Bugfixes
- Fix regsubst() calls to quote single letters (for future parser).
- Fix lint warnings and other misc cleanup.
## 2013-07-03 - Release 1.2.0
#### Features
- Add geppetto `.project` natures
- Add GH auto-release
- Add `apt::key::key_options` parameter
- Add complex pin support using distribution properties for `apt::pin` via new properties:
- `apt::pin::codename`
- `apt::pin::release_version`
- `apt::pin::component`
- `apt::pin::originator`
- `apt::pin::label`
- Add source architecture support to `apt::source::architecture`
#### Bugfixes
- Use apt-get instead of aptitude in apt::force
- Update default backports location
- Add dependency for required packages before apt-get update
## 2013-06-02 - Release 1.1.1
### Summary
This is a bug fix release that resolves a number of issues:
* By changing template variable usage, we remove the deprecation warnings
for Puppet 3.2.x
* Fixed proxy file removal, when proxy absent
Some documentation, style and whitespaces changes were also merged. This
release also introduced proper rspec-puppet unit testing on Travis-CI to help
reduce regression.
Thanks to all the community contributors below that made this patch possible.
#### Detail Changes
* fix minor comment type (Chris Rutter)
* whitespace fixes (Michael Moll)
* Update travis config file (William Van Hevelingen)
* Build all branches on travis (William Van Hevelingen)
* Standardize travis.yml on pattern introduced in stdlib (William Van Hevelingen)
* Updated content to conform to README best practices template (Lauren Rother)
* Fix apt::release example in readme (Brian Galey)
* add @ to variables in template (Peter Hoeg)
* Remove deprecation warnings for pin.pref.erb as well (Ken Barber)
* Update travis.yml to latest versions of puppet (Ken Barber)
* Fix proxy file removal (Scott Barber)
* Add spec test for removing proxy configuration (Dean Reilly)
* Fix apt::key listing longer than 8 chars (Benjamin Knofe)
## Release 1.1.0
### Summary
This release includes Ubuntu 12.10 (Quantal) support for PPAs.
---
## 2012-05-25 - Puppet Labs <info@puppetlabs.com> - Release 0.0.4
### Summary
* Fix ppa list filename when there is a period in the PPA name
* Add .pref extension to apt preferences files
* Allow preferences to be purged
* Extend pin support
## 2012-05-04 - Puppet Labs <info@puppetlabs.com> - Release 0.0.3
### Summary
* only invoke apt-get update once
* only install python-software-properties if a ppa is added
* support 'ensure => absent' for all defined types
* add apt::conf
* add apt::backports
* fixed Modulefile for module tool dependency resolution
* configure proxy before doing apt-get update
* use apt-get update instead of aptitude for apt::ppa
* add support to pin release
## 2012-03-26 - Puppet Labs <info@puppetlabs.com> - Release 0.0.2
### Summary
* 41cedbb (#13261) Add real examples to smoke tests.
* d159a78 (#13261) Add key.pp smoke test
* 7116c7a (#13261) Replace foo source with puppetlabs source
* 1ead0bf Ignore pkg directory.
* 9c13872 (#13289) Fix some more style violations
* 0ea4ffa (#13289) Change test scaffolding to use a module & manifest dir fixture path
* a758247 (#13289) Clean up style violations and fix corresponding tests
* 99c3fd3 (#13289) Add puppet lint tests to Rakefile
* 5148cbf (#13125) Apt keys should be case insensitive
* b9607a4 Convert apt::key to use anchors
## 2012-03-07 - Puppet Labs <info@puppetlabs.com> - Release 0.0.1
### Summary
* d4fec56 Modify apt::source release parameter test
* 1132a07 (#12917) Add contributors to README
* 8cdaf85 (#12823) Add apt::key defined type and modify apt::source to use it
* 7c0d10b (#12809) $release should use $lsbdistcodename and fall back to manual input
* be2cc3e (#12522) Adjust spec test for splitting purge
* 7dc60ae (#12522) Split purge option to spare sources.list
* 9059c4e Fix source specs to test all key permutations
* 8acb202 Add test for python-software-properties package
* a4af11f Check if python-software-properties is defined before attempting to define it.
* 1dcbf3d Add tests for required_packages change
* f3735d2 Allow duplicate $required_packages
* 74c8371 (#12430) Add tests for changes to apt module
* 97ebb2d Test two sources with the same key
* 1160bcd (#12526) Add ability to reverse apt { disable_keys => true }
* 2842d73 Add Modulefile to puppet-apt
* c657742 Allow the use of the same key in multiple sources
* 8c27963 (#12522) Adding purge option to apt class
* 997c9fd (#12529) Add unit test for apt proxy settings
* 50f3cca (#12529) Add parameter to support setting a proxy for apt
* d522877 (#12094) Replace chained .with_* with a hash
* 8cf1bd0 (#12094) Remove deprecated spec.opts file
* 2d688f4 (#12094) Add rspec-puppet tests for apt
* 0fb5f78 (#12094) Replace name with path in file resources
* f759bc0 (#11953) Apt::force passes $version to aptitude
* f71db53 (#11413) Add spec test for apt::force to verify changes to unless
* 2f5d317 (#11413) Update dpkg query used by apt::force
* cf6caa1 (#10451) Add test coverage to apt::ppa
* 0dd697d include_src parameter in example; Whitespace cleanup
* b662eb8 fix typos in "repositories"
* 1be7457 Fix (#10451) - apt::ppa fails to "apt-get update" when new PPA source is added
* 864302a Set the pin priority before adding the source (Fix #10449)
* 1de4e0a Refactored as per mlitteken
* 1af9a13 Added some crazy bash madness to check if the ppa is installed already. Otherwise the manifest tries to add it on every run!
* 52ca73e (#8720) Replace Apt::Ppa with Apt::Builddep
* 5c05fa0 added builddep command.
* a11af50 added the ability to specify the content of a key
* c42db0f Fixes ppa test.
* 77d2b0d reformatted whitespace to match recommended style of 2 space indentation.
* 27ebdfc ignore swap files.
* 377d58a added smoke tests for module.
* 18f614b reformatted apt::ppa according to recommended style.
* d8a1e4e Created a params class to hold global data.
* 636ae85 Added two params for apt class
* 148fc73 Update LICENSE.
* ed2d19e Support ability to add more than one PPA
* 420d537 Add call to apt-update after add-apt-repository in apt::ppa
* 945be77 Add package definition for python-software-properties
* 71fc425 Abs paths for all commands
* 9d51cd1 Adding LICENSE
* 71796e3 Heading fix in README
* 87777d8 Typo in README
* f848bac First commit
[5.0.1]:https://github.com/puppetlabs/puppetlabs-apt/compare/5.0.0...5.0.1
[5.0.0]:https://github.com/puppetlabs/puppetlabs-apt/compare/4.5.1...5.0.0
[4.5.1]:https://github.com/puppetlabs/puppetlabs-apt/compare/4.5.0...4.5.1
[4.5.0]:https://github.com/puppetlabs/puppetlabs-apt/compare/4.4.1...4.5.0
[4.4.1]:https://github.com/puppetlabs/puppetlabs-apt/compare/4.4.0...4.4.1
[4.4.0]:https://github.com/puppetlabs/puppetlabs-apt/compare/4.3.0...4.4.0
[4.3.0]:https://github.com/puppetlabs/puppetlabs-apt/compare/4.2.0...4.3.0
[4.2.0]:https://github.com/puppetlabs/puppetlabs-apt/compare/4.1.0...4.2.0
\* *This Changelog was automatically generated by [github_changelog_generator](https://github.com/skywinder/Github-Changelog-Generator)*

271
modules/utilities/unix/package_management/apt/CONTRIBUTING.md
View File

@@ -1,271 +0,0 @@
# Contributing to Puppet modules
So you want to contribute to a Puppet module: Great! Below are some instructions to get you started doing
that very thing while setting expectations around code quality as well as a few tips for making the
process as easy as possible.
### Table of Contents
1. [Getting Started](#getting-started)
1. [Commit Checklist](#commit-checklist)
1. [Submission](#submission)
1. [More about commits](#more-about-commits)
1. [Testing](#testing)
- [Running Tests](#running-tests)
- [Writing Tests](#writing-tests)
1. [Get Help](#get-help)
## Getting Started
- Fork the module repository on GitHub and clone to your workspace
- Make your changes!
## Commit Checklist
### The Basics
- [x] my commit is a single logical unit of work
- [x] I have checked for unnecessary whitespace with "git diff --check"
- [x] my commit does not include commented out code or unneeded files
### The Content
- [x] my commit includes tests for the bug I fixed or feature I added
- [x] my commit includes appropriate documentation changes if it is introducing a new feature or changing existing functionality
- [x] my code passes existing test suites
### The Commit Message
- [x] the first line of my commit message includes:
- [x] an issue number (if applicable), e.g. "(MODULES-xxxx) This is the first line"
- [x] a short description (50 characters is the soft limit, excluding ticket number(s))
- [x] the body of my commit message:
- [x] is meaningful
- [x] uses the imperative, present tense: "change", not "changed" or "changes"
- [x] includes motivation for the change, and contrasts its implementation with the previous behavior
## Submission
### Pre-requisites
- Make sure you have a [GitHub account](https://github.com/join)
- [Create a ticket](https://tickets.puppet.com/secure/CreateIssue!default.jspa), or [watch the ticket](https://tickets.puppet.com/browse/) you are patching for.
### Push and PR
- Push your changes to your fork
- [Open a Pull Request](https://help.github.com/articles/creating-a-pull-request-from-a-fork/) against the repository in the puppetlabs organization
## More about commits
1. Make separate commits for logically separate changes.
Please break your commits down into logically consistent units
which include new or changed tests relevant to the rest of the
change. The goal of doing this is to make the diff easier to
read for whoever is reviewing your code. In general, the easier
your diff is to read, the more likely someone will be happy to
review it and get it into the code base.
If you are going to refactor a piece of code, please do so as a
separate commit from your feature or bug fix changes.
We also really appreciate changes that include tests to make
sure the bug is not re-introduced, and that the feature is not
accidentally broken.
Describe the technical detail of the change(s). If your
description starts to get too long, that is a good sign that you
probably need to split up your commit into more finely grained
pieces.
Commits which plainly describe the things which help
reviewers check the patch and future developers understand the
code are much more likely to be merged in with a minimum of
bike-shedding or requested changes. Ideally, the commit message
would include information, and be in a form suitable for
inclusion in the release notes for the version of Puppet that
includes them.
Please also check that you are not introducing any trailing
whitespace or other "whitespace errors". You can do this by
running "git diff --check" on your changes before you commit.
2. Sending your patches
To submit your changes via a GitHub pull request, we _highly_
recommend that you have them on a topic branch, instead of
directly on "master".
It makes things much easier to keep track of, especially if
you decide to work on another thing before your first change
is merged in.
GitHub has some pretty good
[general documentation](http://help.github.com/) on using
their site. They also have documentation on
[creating pull requests](https://help.github.com/articles/creating-a-pull-request-from-a-fork/).
In general, after pushing your topic branch up to your
repository on GitHub, you can switch to the branch in the
GitHub UI and click "Pull Request" towards the top of the page
in order to open a pull request.
3. Update the related JIRA issue.
If there is a JIRA issue associated with the change you
submitted, then you should update the ticket to include the
location of your branch, along with any other commentary you
may wish to make.
# Testing
## Getting Started
Our Puppet modules provide [`Gemfile`](./Gemfile)s, which can tell a Ruby package manager such as [bundler](http://bundler.io/) what Ruby packages,
or Gems, are required to build, develop, and test this software.
Please make sure you have [bundler installed](http://bundler.io/#getting-started) on your system, and then use it to
install all dependencies needed for this project in the project root by running
```shell
% bundle install --path .bundle/gems
Fetching gem metadata from https://rubygems.org/........
Fetching gem metadata from https://rubygems.org/..
Using rake (10.1.0)
Using builder (3.2.2)
-- 8><-- many more --><8 --
Using rspec-system-puppet (2.2.0)
Using serverspec (0.6.3)
Using rspec-system-serverspec (1.0.0)
Using bundler (1.3.5)
Your bundle is complete!
Use `bundle show [gemname]` to see where a bundled gem is installed.
```
NOTE: some systems may require you to run this command with sudo.
If you already have those gems installed, make sure they are up-to-date:
```shell
% bundle update
```
## Running Tests
With all dependencies in place and up-to-date, run the tests:
### Unit Tests
```shell
% bundle exec rake spec
```
This executes all the [rspec tests](http://rspec-puppet.com/) in the directories defined [here](https://github.com/puppetlabs/puppetlabs_spec_helper/blob/699d9fbca1d2489bff1736bb254bb7b7edb32c74/lib/puppetlabs_spec_helper/rake_tasks.rb#L17) and so on.
rspec tests may have the same kind of dependencies as the module they are testing. Although the module defines these dependencies in its [metadata.json](./metadata.json),
rspec tests define them in [.fixtures.yml](./fixtures.yml).
### Acceptance Tests
Some Puppet modules also come with acceptance tests, which use [beaker][]. These tests spin up a virtual machine under
[VirtualBox](https://www.virtualbox.org/), controlled with [Vagrant](http://www.vagrantup.com/), to simulate scripted test
scenarios. In order to run these, you need both Virtualbox and Vagrant installed on your system.
Run the tests by issuing the following command
```shell
% bundle exec rake spec_clean
% bundle exec rspec spec/acceptance
```
This will now download a pre-fabricated image configured in the [default node-set](./spec/acceptance/nodesets/default.yml),
install Puppet, copy this module, and install its dependencies per [spec/spec_helper_acceptance.rb](./spec/spec_helper_acceptance.rb)
and then run all the tests under [spec/acceptance](./spec/acceptance).
## Writing Tests
### Unit Tests
When writing unit tests for Puppet, [rspec-puppet][] is your best friend. It provides tons of helper methods for testing your manifests against a
catalog (e.g. contain_file, contain_package, with_params, etc). It would be ridiculous to try and top rspec-puppet's [documentation][rspec-puppet_docs]
but here's a tiny sample:
Sample manifest:
```puppet
file { "a test file":
ensure => present,
path => "/etc/sample",
}
```
Sample test:
```ruby
it 'does a thing' do
expect(subject).to contain_file("a test file").with({:path => "/etc/sample"})
end
```
### Acceptance Tests
Writing acceptance tests for Puppet involves [beaker][] and its cousin [beaker-rspec][]. A common pattern for acceptance tests is to create a test manifest, apply it
twice to check for idempotency or errors, then run expectations.
```ruby
it 'does an end-to-end thing' do
pp = <<-EOF
file { 'a test file':
ensure => present,
path => "/etc/sample",
content => "test string",
}
apply_manifest(pp, :catch_failures => true)
apply_manifest(pp, :catch_changes => true)
end
describe file("/etc/sample") do
it { is_expected.to contain "test string" }
end
```
# If you have commit access to the repository
Even if you have commit access to the repository, you still need to go through the process above, and have someone else review and merge
in your changes. The rule is that **all changes must be reviewed by a project developer that did not write the code to ensure that
all changes go through a code review process.**
The record of someone performing the merge is the record that they performed the code review. Again, this should be someone other than the author of the topic branch.
# Get Help
### On the web
* [Puppet help messageboard](http://puppet.com/community/get-help)
* [Writing tests](https://docs.puppet.com/guides/module_guides/bgtm.html#step-three-module-testing)
* [General GitHub documentation](http://help.github.com/)
* [GitHub pull request documentation](http://help.github.com/send-pull-requests/)
### On chat
* Slack (slack.puppet.com) #forge-modules, #puppet-dev, #windows, #voxpupuli
* IRC (freenode) #puppet-dev, #voxpupuli
[rspec-puppet]: http://rspec-puppet.com/
[rspec-puppet_docs]: http://rspec-puppet.com/documentation/
[beaker]: https://github.com/puppetlabs/beaker
[beaker-rspec]: https://github.com/puppetlabs/beaker-rspec

76
modules/utilities/unix/package_management/apt/Gemfile
View File

@@ -1,76 +0,0 @@
source ENV['GEM_SOURCE'] || 'https://rubygems.org'
def location_for(place_or_version, fake_version = nil)
git_url_regex = %r{\A(?<url>(https?|git)[:@][^#]*)(#(?<branch>.*))?}
file_url_regex = %r{\Afile:\/\/(?<path>.*)}
if place_or_version && (git_url = place_or_version.match(git_url_regex))
[fake_version, { git: git_url[:url], branch: git_url[:branch], require: false }].compact
elsif place_or_version && (file_url = place_or_version.match(file_url_regex))
['>= 0', { path: File.expand_path(file_url[:path]), require: false }]
else
[place_or_version, { require: false }]
end
end
ruby_version_segments = Gem::Version.new(RUBY_VERSION.dup).segments
minor_version = ruby_version_segments[0..1].join('.')
group :development do
gem "fast_gettext", '1.1.0', require: false if Gem::Version.new(RUBY_VERSION.dup) < Gem::Version.new('2.1.0')
gem "fast_gettext", require: false if Gem::Version.new(RUBY_VERSION.dup) >= Gem::Version.new('2.1.0')
gem "json_pure", '<= 2.0.1', require: false if Gem::Version.new(RUBY_VERSION.dup) < Gem::Version.new('2.0.0')
gem "json", '= 1.8.1', require: false if Gem::Version.new(RUBY_VERSION.dup) == Gem::Version.new('2.1.9')
gem "json", '<= 2.0.4', require: false if Gem::Version.new(RUBY_VERSION.dup) == Gem::Version.new('2.4.4')
gem "puppet-module-posix-default-r#{minor_version}", require: false, platforms: [:ruby]
gem "puppet-module-posix-dev-r#{minor_version}", require: false, platforms: [:ruby]
gem "puppet-module-win-default-r#{minor_version}", require: false, platforms: [:mswin, :mingw, :x64_mingw]
gem "puppet-module-win-dev-r#{minor_version}", require: false, platforms: [:mswin, :mingw, :x64_mingw]
gem "github_changelog_generator", require: false, git: 'https://github.com/skywinder/github-changelog-generator', ref: '20ee04ba1234e9e83eb2ffb5056e23d641c7a018' if Gem::Version.new(RUBY_VERSION.dup) >= Gem::Version.new('2.2.2')
gem "puppet-lint-i18n", require: false
end
group :system_tests do
gem "puppet-module-posix-system-r#{minor_version}", require: false, platforms: [:ruby]
gem "puppet-module-win-system-r#{minor_version}", require: false, platforms: [:mswin, :mingw, :x64_mingw]
end
puppet_version = ENV['PUPPET_GEM_VERSION']
facter_version = ENV['FACTER_GEM_VERSION']
hiera_version = ENV['HIERA_GEM_VERSION']
gems = {}
gems['puppet'] = location_for(puppet_version)
# If facter or hiera versions have been specified via the environment
# variables
gems['facter'] = location_for(facter_version) if facter_version
gems['hiera'] = location_for(hiera_version) if hiera_version
if Gem.win_platform? && puppet_version =~ %r{^(file:///|git://)}
# If we're using a Puppet gem on Windows which handles its own win32-xxx gem
# dependencies (>= 3.5.0), set the maximum versions (see PUP-6445).
gems['win32-dir'] = ['<= 0.4.9', require: false]
gems['win32-eventlog'] = ['<= 0.6.5', require: false]
gems['win32-process'] = ['<= 0.7.5', require: false]
gems['win32-security'] = ['<= 0.2.5', require: false]
gems['win32-service'] = ['0.8.8', require: false]
end
gems.each do |gem_name, gem_params|
gem gem_name, *gem_params
end
# Evaluate Gemfile.local and ~/.gemfile if they exist
extra_gemfiles = [
"#{__FILE__}.local",
File.join(Dir.home, '.gemfile'),
]
extra_gemfiles.each do |gemfile|
if File.file?(gemfile) && File.readable?(gemfile)
eval(File.read(gemfile), binding)
end
end
# vim: syntax=ruby

692
modules/utilities/unix/package_management/apt/HISTORY.md
View File

@@ -1,692 +0,0 @@
## 5.0.1
[Full Changelog](https://github.com/puppetlabs/puppetlabs-apt/compare/5.0.0...5.0.1)
### Fixed
- \(MODULES-7540\) - add apt-transport-https with https [\#775](https://github.com/puppetlabs/puppetlabs-apt/pull/775) ([tphoney](https://github.com/tphoney))
## [5.0.0](https://github.com/puppetlabs/puppetlabs-apt/tree/5.0.0) (2018-07-18)
[Full Changelog](https://github.com/puppetlabs/puppetlabs-apt/compare/4.5.1...5.0.0)
### Changed
- \[FM-6956\] Removal of unsupported Debian 7 from apt [\#760](https://github.com/puppetlabs/puppetlabs-apt/pull/760) ([david22swan](https://github.com/david22swan))
### Added
- \(MODULES-7467\) Update apt to support Ubuntu 18.04 [\#769](https://github.com/puppetlabs/puppetlabs-apt/pull/769) ([david22swan](https://github.com/david22swan))
- Support managing login configurations in /etc/apt/auth.conf [\#752](https://github.com/puppetlabs/puppetlabs-apt/pull/752) ([antaflos](https://github.com/antaflos))
### Fixed
- \(MODULES-7327\) - Update README with supported OS [\#767](https://github.com/puppetlabs/puppetlabs-apt/pull/767) ([pmcmaw](https://github.com/pmcmaw))
- \(bugfix\) Dont run ftp tests in travis [\#766](https://github.com/puppetlabs/puppetlabs-apt/pull/766) ([tphoney](https://github.com/tphoney))
- \(maint\) make apt testing more stable, cleanup [\#764](https://github.com/puppetlabs/puppetlabs-apt/pull/764) ([tphoney](https://github.com/tphoney))
- Remove .length from variable $pin\_release in app [\#754](https://github.com/puppetlabs/puppetlabs-apt/pull/754) ([paladox](https://github.com/paladox))
- Replace UTF-8 whitespace in comment [\#748](https://github.com/puppetlabs/puppetlabs-apt/pull/748) ([bernhardschmidt](https://github.com/bernhardschmidt))
- Fix "E: Unable to locate package -y" [\#747](https://github.com/puppetlabs/puppetlabs-apt/pull/747) ([aboks](https://github.com/aboks))
- Fix automatic coercion warning [\#743](https://github.com/puppetlabs/puppetlabs-apt/pull/743) ([smortex](https://github.com/smortex))
## Supported Release [4.5.1]
### Summary
This release fixes CVE-2018-6508 which is a potential arbitrary code execution via tasks.
### Fixed
- Fix init task for arbitrary remote code
## Supported Release [4.5.0]
### Summary
This release uses the PDK convert functionality which in return makes the module PDK compliant. It also includes a roll up of maintenance changes.
### Added
- PDK convert apt ([MODULES-6452](https://tickets.puppet.com/browse/MODULES-6452)).
- Testing on Travis using rvm 2.4.1.
- Modulesync updates.
### Fixed
- Changes to address additional Rubocop failures.
- (maint) Addressing puppet-lint doc warnings.
### Removed
- `gem update bundler` command in .travis.yml due to ([MODULES-6339](https://tickets.puppet.com/browse/MODULES-6339)).
## Supported Release [4.4.1]
### Summary
This release is to update the formatting of the module, Rubocop having been run for all ruby files and been set to run automatically on all future commits.
### Changed
- Rubocop has been implemented.
## Supported Release [4.4.0]
### Summary
This release is a rollup of new features and fixes.
#### Added
- Install `apt-transport-https` if using Debian 7, 8, 9 or Ubuntu 14.04, 16.04.
- Adds a boolean option `direct` to proxy settings to bypass `https_proxy` if not set.
- Adds facter facts for `dist-upgrade` apt updates.
#### Changed
- Update class is now private.
- Some tidyup of ruby code from Rubocop.
- Fixed circular dependency for package dirmngr.
- Debian updates are no longer treated as security updates.
- Legacy functions have been removed.
- Updates to tests.
#### Fixed
- [(MODULES-4265)](https://tickets.puppetlabs.com/browse/MODULES-4265) Detect security updates from multiple sources.
## Supported Release [4.3.0]
### Summary
This release is adding Tasks to the apt module.
#### Added
- Add a task that allows apt-get update and upgrade
## Supported Release [4.2.0]
### Summary
This release is primarily to fix an error around GPG keys in Debian 9, but includes some other small features and fixes as well.
#### Added
- `apt_package_security_updates` fact
- The ability to modify the loglevel of `Exec['apt_update'}`
- Puppet 5 support
#### Changed
- Ubuntu 16.04 now uses `software-priorities-common`
#### Removed
- Debian 6, Ubuntu 10.04 and 12.04 support. Existing compatibility remains intact but bugs will not be prioritized for these OSes.
#### Fixed
- **[(MODULES-4686)](https://tickets.puppetlabs.com/browse/MODULES-4686) an error that was causing GPG keyserver imports to fail on Debian 9**
## Supported Release 4.1.0
### Summary
This release removes Data in Modules due to current compatibility issues and reinstates the params.pp file. Also includes a couple of bug fixes.
#### Features
- (MODULES-4973) Data in Modules which was introduced in the last release has now been reverted due to compatibility issues.
#### Bugfixes
- Now apt_key only sends the auth basic header when userinfo can be parsed from the URL.
- Reverted the removal of Evolving Web's attribution in NOTICE file.
- Test added to ensure empty string allowed for $release in apt::source.
## Supported Release 3.0.0 and 4.0.0
### Summary
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
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.
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.
#### Changes
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.
EPP templating: Uses the Puppet language as a base for templates to create simpler and safer templates. No need for Ruby anymore!
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.
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.
#### Bugfixes
- Fix apt::source epp template regression introduced in 3.0.0 for the architecture parameter
## Supported Release 2.4.0
### Summary
A release that includes only a couple of additional features, but includes several cleanups and bugfixes around existing issues.
#### Features
- Tests updated to check for idempotency.
- (MODULES-4224) Implementation of beaker-module_install_helper.
- Deprecation warnings are now handled by the deprecation function in stdlib.
#### Bugfixes
- Now http and https sources fixed for apt_key and can take a userinfo.
- GPG key update.
- Notify_update param now defaults to true to avoid validation errors.
- Implement retry on tests which pull key from a key server which sometimes times out (transient error).
- String comparison error now comphensated for in update.pp.
- (MODULES-4104) Removal of the port number from repository location in order to get the host name of the repository.
- Puppet lint warnings addressed.
- A few small readme issues addressed.
## Supported Release 2.3.0
### Summary
A release containing many bugfixes with additional features.
#### Features
- Apt_updates facts now use /usr/bin/apt-get.
- Addition of notify update to apt::source.
- Update to newest modulesync_configs.
- Installs software-properties-common for Xenial.
- Modulesync updates.
- Add ability to specify a hash of apt::conf defines.
#### Bugfixes
- A clean up of spec/defines/key_compat_specs, also now runs under STRICT_VARIABLES.
- Apt::setting expects priority to be an integer, set defaults accordingly.
- Fixed version check for Ubuntu on 16.04.
- Now uses hkps.pool.sks-keyservers.net instead of pgp.mit.edu.
- Updates and fixes to tests. General cleanup.
- Fixed regexp for $ensure params.
- Apt/params: Remove unused LSB facts.
- 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.
- 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.
## Supported Release 2.2.2
### Summary
Several bug fixes and the addition of support updates to Debian 8 and Ubuntu Wily.
#### Bugfixes
- Small fixes to descriptions within the readme and the addition of some examples.
- Updates to run on Ubuntu Wily.
- Fixed apt_key tempfile race condition.
- Run stages limitation added to the documentation.
- Remove unneeded whitespace in source.list template.
- Handle PPA names that contain a plus character.
- Update to current msync configs.
- Avoid duplicate package resources when package_manage => true.
- Avoid multiple package resource declarations.
- Ensure PPAs in tests have valid form.
- Look for correct sources.list.d file for apt::ppa.
- Debian 8 support addiiton to metadata.
## Supported Release 2.2.1
### Summary
Small release for support of newer PE versions. This increments the version of PE in the metadata.json file.
## 2015-09-29 - Supported Release 2.2.0
### Summary
This release includes a few bugfixes.
#### Features
- Adds an `ensure` parameter for user control of proxy presence.
- Adds ability to set `notify_update` to `apt::conf` (MODULES-2269).
- Apt pins no longer trigger an `apt-get update` run.
- Adds support for creating pins from main class.
#### Bugfixes
- Updates to use the official Debian mirrors.
- Fixes path to `preferences` and `preferences.d`
- Fixes pinning for backports (MODULES-2446).
- Fixes the name/extension of the preferences files.
## 2015-07-28 - Supported Release 2.1.1
### Summary
This release includes a few bugfixes.
#### Bugfixes
- Fix incorrect use of anchoring (MODULES-2190)
- Use correct comment type for apt.conf files
- Test fixes
- Documentation fixes
## 2015-06-16 - Supported Release 2.1.0
### Summary
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.
#### Features
- Add API compatibility to `apt::key` and `apt::source`
- Added `apt_reboot_required` fact
#### Bugfixes
- Fix compatibility with Puppet versions 3.0-3.4
- Work around future parser bug PUP-4133
## 2015-04-28 - Supported Release 2.0.1
### Summary
This bug fixes a few compatibility issues that came up with the 2.0.0 release, and includes test and documentation updates.
#### Bugfixes
- Fix incompatibility with keyrings containing multiple keys
- Fix bugs preventing the module from working with Puppet < 3.5.0
## 2015-04-07 - Supported Release 2.0.0
### Summary
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.
#### Backwards-incompatible changes
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.
##### `apt_key`
- `keyserver_options` parameter renamed to `options`
##### `apt::backports`
- 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)
##### `apt::builddep`
- This define was removed. Functionality can be matched passing 'build-dep' to `install_options` in the package resource. [Example](examples/builddep.pp)
##### `apt::debian::testing`
- This class was removed. Manually add an `apt::source` instead. [Example](examples/debian_testing.pp)
##### `apt::debian::unstable`
- This class was removed. Manually add an `apt::source` instead. [Example](examples/debian_unstable.pp)
##### `apt::force`
- 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.
##### `apt::hold`
- This define was removed. Simply use an `apt::pin` with `priority => 1001` for the same functionality.
##### `apt`
- `always_apt_update` - This parameter was removed. Use `update => { 'frequency' => 'always' }` instead.
- `apt_update_frequency` - This parameter was removed. Use `update => { 'frequency' => <frequency> }` instead.
- `disable_keys` - This parameter was removed. See this [example](examples/disable_keys.pp) if you need this functionality.
- `proxy_host` - This parameter was removed. Use `proxy => { 'host' => <host> }` instead.
- `proxy_port` - This parameter was removed. Use `proxy => { 'port' => <port> }` instead.
- `purge_sources_list` - This parameter was removed. Use `purge => { 'sources.list' => <bool> }` instead.
- `purge_sources_list_d` - This parameter was removed. Use `purge => { 'sources.list.d' => <bool> }` instead.
- `purge_preferences` - This parameter was removed. Use `purge => { 'preferences' => <bool> }` instead.
- `purge_preferences_d` - This parameter was removed. Use `purge => { 'preferences.d' => <bool> }` instead.
- `update_timeout` - This parameter was removed. Use `update => { 'timeout' => <timeout> }` instead.
- `update_tries` - This parameter was removed. Use `update => { 'tries' => <tries> }` instead.
##### `apt::key`
- `key` - This parameter was renamed to `id`.
- `key_content` - This parameter was renamed to `content`.
- `key_source` - This parameter was renamed to `source`.
- `key_server` - This parameter was renamed to `server`.
- `key_options` - This parameter was renamed to `options`.
##### `apt::release`
- This class was removed. See this [example](examples/release.pp) for how to achieve this functionality.
##### `apt::source`
- `include_src` - This parameter was removed. Use `include => { 'src' => <bool> }` instead. ***NOTE*** This now defaults to false.
- `include_deb` - This parameter was removed. Use `include => { 'deb' => <bool> }` instead.
- `required_packages` - This parameter was removed. Use package resources for these packages if needed.
- `key` - This can either be a key id or a hash including key options. If using a hash, `key => { 'id' => <id> }` must be specified.
- `key_server` - This parameter was removed. Use `key => { 'server' => <server> }` instead.
- `key_content` - This parameter was removed. Use `key => { 'content' => <content> }` instead.
- `key_source` - This parameter was removed. Use `key => { 'source' => <source> }` instead.
- `trusted_source` - This parameter was renamed to `allow_unsigned`.
##### `apt::unattended_upgrades`
- 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).
#### Changes to default behavior
- By default purge unmanaged files in 'sources.list', 'sources.list.d', 'preferences', and 'preferences.d'.
- 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.
- `apt::source` will no longer include the `src` entries by default.
- `pin` in `apt::source` now defaults to `undef` instead of `false`
#### Features
- Added the ability to pass hashes of `apt::key`s, `apt::ppa`s, and `apt::setting`s to `apt`.
- Added 'https' key to `proxy` hash to allow disabling `https_proxy` for the `apt::ppa` environment.
- Added `apt::setting` define to abstract away configuration.
- Added the ability to pass hashes to `pin` and `key` in `apt::backports` and `apt::source`.
#### Bugfixes
- Fixes for strict variables.
## 2015-03-17 - Supported Release 1.8.0
### Summary
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.
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.
#### Changes to default behavior
- The apt module will now throw warnings if you don't use full fingerprints for `apt_key`s
#### Features
- Use gpg to check keys to work around https://bugs.launchpad.net/ubuntu/+source/gnupg2/+bug/1409117 (MODULES-1675)
- Add 'oldstable' to the default update origins for wheezy
- Add utopic, vivid, and cumulus compatibility
- Add support for full fingerprints
- New parameter for `apt::source`
- `trusted_source`
- New parameters for `apt::ppa`
- `package_name`
- `package_manage`
- New parameter for `apt::unattended_upgrades`
- `legacy_origin`
- Separate `apt::pin` from `apt::backports` to allow pin by release instead of origin
#### Bugfixes
- Cleanup lint and future parser issues
- Fix to support username and passwords again for `apt_key` (MODULES-1119)
- Fix issue where `apt::force` `$install_check` didn't work with non-English locales (MODULES-1231)
- Allow 5 digit ports in `apt_key`
- Fix for `ensure => absent` in `apt_key` (MODULES-1661)
- Fix `apt_has_updates` not parsing `apt-check` output correctly
- Fix inconsistent headers across files (MODULES-1200)
- Clean up formatting for 50unattended-upgrades.erb
## 2014-10-28 - Supported Release 1.7.0
### Summary
This release includes several new features, documentation and test improvements, and a few bug fixes.
#### Features
- Updated unit and acceptance tests
- Update module to work with Linux Mint
- Documentation updates
- Future parser / strict variables support
- Improved support for long GPG keys
- New parameters!
- Added `apt_update_frequency` to apt
- Added `cfg_files` and `cfg_missing` parameters to apt::force
- Added `randomsleep` to apt::unattended_upgrades
- Added `apt_update_last_success` fact
- Refactored facts for performance improvements
#### Bugfixes
- Update apt::builddep to require Exec['apt_update'] instead of notifying it
- Clean up lint errors
## 2014-08-20 - Supported Release 1.6.0
### Summary
#### Features
- Allow URL or domain name for key_server parameter
- Allow custom comment for sources list
- Enable auto-update for Debian squeeze LTS
- Add facts showing available updates
- Test refactoring
#### Bugfixes
- Allow dashes in URL or domain for key_server parameter
## 2014-08-13 - Supported Release 1.5.3
### Summary
This is a bugfix releases. It addresses a bad regex, failures with unicode
characters, and issues with the $proxy_host handling in apt::ppa.
#### Features
- Synced files from Modulesync
#### Bugfixes
- Fix regex to follow APT requirements in apt::pin
- Fix for unicode characters
- Fix inconsistent $proxy_host handling in apt and apt::ppa
- Fix typo in README
- Fix broken acceptance tests
## 2014-07-15 - Supported Release 1.5.2
### Summary
This release merely updates metadata.json so the module can be uninstalled and
upgraded via the puppet module command.
## 2014-07-10 - Supported Release 1.5.1
### Summary
This release has added tests to ensure graceful failure on OSX.
## 2014-06-04 - Release 1.5.0
### Summary
This release adds support for Ubuntu 14.04. It also includes many new features
and important bugfixes. One huge change is that apt::key was replaced with
apt_key, which allows you to use puppet resource apt_key to inventory keys on
your system.
Special thanks to daenney, our intrepid unofficial apt maintainer!
#### Features
- Add support for Ubuntu Trusty!
- Add apt::hold define
- Generate valid *.pref files in apt::pin
- Made pin_priority configurable for apt::backports
- Add apt_key type and provider
- Rename "${apt_conf_d}/proxy" to "${apt_conf_d}/01proxy"
- apt::key rewritten to use apt_key type
- Add support for update_tries to apt::update
#### Bugfixes
- Typo fixes
- Fix unattended upgrades
- Removed bogus line when using purge_preferences
- Fix apt::force to upgrade allow packages to be upgraded to the pacakge from the specified release
## 2014-03-04 - Supported Release 1.4.2
### Summary
This is a supported release. This release tidies up 1.4.1 and re-enables
support for Ubuntu 10.04
#### Features
#### Bugfixes
- Fix apt:ppa to include the -y Ubuntu 10.04 requires.
- Documentation changes.
- Test fixups.
#### Known Bugs
* No known issues.
## 2014-02-13 1.4.1
### Summary
This is a bugfix release.
#### Bugfixes
- Fix apt::force unable to upgrade packages from releases other than its original
- Removed a few refeneces to aptitude instead of apt-get for portability
- Removed call to getparam() due to stdlib dependency
- Correct apt::source template when architecture is provided
- Retry package installs if apt is locked
- Use root to exec in apt::ppa
- Updated tests and converted acceptance tests to beaker
## 2013-10-08 - Release 1.4.0
### Summary
Minor bugfix and allow the timeout to be adjusted.
#### Features
- Add an `updates_timeout` to apt::params
#### Bugfixes
- Ensure apt::ppa can read a ppa removed by hand.
## 2013-10-08 - Release 1.3.0
### Summary
This major feature in this release is the new apt::unattended_upgrades class,
allowing you to handle Ubuntu's unattended feature. This allows you to select
specific packages to automatically upgrade without any further user
involvement.
In addition we extend our Wheezy support, add proxy support to apt:ppa and do
various cleanups and tweaks.
#### Features
- Add apt::unattended_upgrades support for Ubuntu.
- Add wheezy backports support.
- Use the geoDNS http.debian.net instead of the main debian ftp server.
- Add `options` parameter to apt::ppa in order to pass options to apt-add-repository command.
- Add proxy support for apt::ppa (uses proxy_host and proxy_port from apt).
#### Bugfixes
- Fix regsubst() calls to quote single letters (for future parser).
- Fix lint warnings and other misc cleanup.
## 2013-07-03 - Release 1.2.0
#### Features
- Add geppetto `.project` natures
- Add GH auto-release
- Add `apt::key::key_options` parameter
- Add complex pin support using distribution properties for `apt::pin` via new properties:
- `apt::pin::codename`
- `apt::pin::release_version`
- `apt::pin::component`
- `apt::pin::originator`
- `apt::pin::label`
- Add source architecture support to `apt::source::architecture`
#### Bugfixes
- Use apt-get instead of aptitude in apt::force
- Update default backports location
- Add dependency for required packages before apt-get update
## 2013-06-02 - Release 1.1.1
### Summary
This is a bug fix release that resolves a number of issues:
* By changing template variable usage, we remove the deprecation warnings
for Puppet 3.2.x
* Fixed proxy file removal, when proxy absent
Some documentation, style and whitespaces changes were also merged. This
release also introduced proper rspec-puppet unit testing on Travis-CI to help
reduce regression.
Thanks to all the community contributors below that made this patch possible.
#### Detail Changes
* fix minor comment type (Chris Rutter)
* whitespace fixes (Michael Moll)
* Update travis config file (William Van Hevelingen)
* Build all branches on travis (William Van Hevelingen)
* Standardize travis.yml on pattern introduced in stdlib (William Van Hevelingen)
* Updated content to conform to README best practices template (Lauren Rother)
* Fix apt::release example in readme (Brian Galey)
* add @ to variables in template (Peter Hoeg)
* Remove deprecation warnings for pin.pref.erb as well (Ken Barber)
* Update travis.yml to latest versions of puppet (Ken Barber)
* Fix proxy file removal (Scott Barber)
* Add spec test for removing proxy configuration (Dean Reilly)
* Fix apt::key listing longer than 8 chars (Benjamin Knofe)
## Release 1.1.0
### Summary
This release includes Ubuntu 12.10 (Quantal) support for PPAs.
---
## 2012-05-25 - Puppet Labs <info@puppetlabs.com> - Release 0.0.4
### Summary
* Fix ppa list filename when there is a period in the PPA name
* Add .pref extension to apt preferences files
* Allow preferences to be purged
* Extend pin support
## 2012-05-04 - Puppet Labs <info@puppetlabs.com> - Release 0.0.3
### Summary
* only invoke apt-get update once
* only install python-software-properties if a ppa is added
* support 'ensure => absent' for all defined types
* add apt::conf
* add apt::backports
* fixed Modulefile for module tool dependency resolution
* configure proxy before doing apt-get update
* use apt-get update instead of aptitude for apt::ppa
* add support to pin release
## 2012-03-26 - Puppet Labs <info@puppetlabs.com> - Release 0.0.2
### Summary
* 41cedbb (#13261) Add real examples to smoke tests.
* d159a78 (#13261) Add key.pp smoke test
* 7116c7a (#13261) Replace foo source with puppetlabs source
* 1ead0bf Ignore pkg directory.
* 9c13872 (#13289) Fix some more style violations
* 0ea4ffa (#13289) Change test scaffolding to use a module & manifest dir fixture path
* a758247 (#13289) Clean up style violations and fix corresponding tests
* 99c3fd3 (#13289) Add puppet lint tests to Rakefile
* 5148cbf (#13125) Apt keys should be case insensitive
* b9607a4 Convert apt::key to use anchors
## 2012-03-07 - Puppet Labs <info@puppetlabs.com> - Release 0.0.1
### Summary
* d4fec56 Modify apt::source release parameter test
* 1132a07 (#12917) Add contributors to README
* 8cdaf85 (#12823) Add apt::key defined type and modify apt::source to use it
* 7c0d10b (#12809) $release should use $lsbdistcodename and fall back to manual input
* be2cc3e (#12522) Adjust spec test for splitting purge
* 7dc60ae (#12522) Split purge option to spare sources.list
* 9059c4e Fix source specs to test all key permutations
* 8acb202 Add test for python-software-properties package
* a4af11f Check if python-software-properties is defined before attempting to define it.
* 1dcbf3d Add tests for required_packages change
* f3735d2 Allow duplicate $required_packages
* 74c8371 (#12430) Add tests for changes to apt module
* 97ebb2d Test two sources with the same key
* 1160bcd (#12526) Add ability to reverse apt { disable_keys => true }
* 2842d73 Add Modulefile to puppet-apt
* c657742 Allow the use of the same key in multiple sources
* 8c27963 (#12522) Adding purge option to apt class
* 997c9fd (#12529) Add unit test for apt proxy settings
* 50f3cca (#12529) Add parameter to support setting a proxy for apt
* d522877 (#12094) Replace chained .with_* with a hash
* 8cf1bd0 (#12094) Remove deprecated spec.opts file
* 2d688f4 (#12094) Add rspec-puppet tests for apt
* 0fb5f78 (#12094) Replace name with path in file resources
* f759bc0 (#11953) Apt::force passes $version to aptitude
* f71db53 (#11413) Add spec test for apt::force to verify changes to unless
* 2f5d317 (#11413) Update dpkg query used by apt::force
* cf6caa1 (#10451) Add test coverage to apt::ppa
* 0dd697d include_src parameter in example; Whitespace cleanup
* b662eb8 fix typos in "repositories"
* 1be7457 Fix (#10451) - apt::ppa fails to "apt-get update" when new PPA source is added
* 864302a Set the pin priority before adding the source (Fix #10449)
* 1de4e0a Refactored as per mlitteken
* 1af9a13 Added some crazy bash madness to check if the ppa is installed already. Otherwise the manifest tries to add it on every run!
* 52ca73e (#8720) Replace Apt::Ppa with Apt::Builddep
* 5c05fa0 added builddep command.
* a11af50 added the ability to specify the content of a key
* c42db0f Fixes ppa test.
* 77d2b0d reformatted whitespace to match recommended style of 2 space indentation.
* 27ebdfc ignore swap files.
* 377d58a added smoke tests for module.
* 18f614b reformatted apt::ppa according to recommended style.
* d8a1e4e Created a params class to hold global data.
* 636ae85 Added two params for apt class
* 148fc73 Update LICENSE.
* ed2d19e Support ability to add more than one PPA
* 420d537 Add call to apt-update after add-apt-repository in apt::ppa
* 945be77 Add package definition for python-software-properties
* 71fc425 Abs paths for all commands
* 9d51cd1 Adding LICENSE
* 71796e3 Heading fix in README
* 87777d8 Typo in README
* f848bac First commit
[5.0.1]:https://github.com/puppetlabs/puppetlabs-apt/compare/5.0.0...5.0.1
[5.0.0]:https://github.com/puppetlabs/puppetlabs-apt/compare/4.5.1...5.0.0
[4.5.1]:https://github.com/puppetlabs/puppetlabs-apt/compare/4.5.0...4.5.1
[4.5.0]:https://github.com/puppetlabs/puppetlabs-apt/compare/4.4.1...4.5.0
[4.4.1]:https://github.com/puppetlabs/puppetlabs-apt/compare/4.4.0...4.4.1
[4.4.0]:https://github.com/puppetlabs/puppetlabs-apt/compare/4.3.0...4.4.0
[4.3.0]:https://github.com/puppetlabs/puppetlabs-apt/compare/4.2.0...4.3.0
[4.2.0]:https://github.com/puppetlabs/puppetlabs-apt/compare/4.1.0...4.2.0

202
modules/utilities/unix/package_management/apt/LICENSE
View File

@@ -1,202 +0,0 @@
Apache License
Version 2.0, January 2004
http://www.apache.org/licenses/
TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
1. Definitions.
"License" shall mean the terms and conditions for use, reproduction,
and distribution as defined by Sections 1 through 9 of this document.
"Licensor" shall mean the copyright owner or entity authorized by
the copyright owner that is granting the License.
"Legal Entity" shall mean the union of the acting entity and all
other entities that control, are controlled by, or are under common
control with that entity. For the purposes of this definition,
"control" means (i) the power, direct or indirect, to cause the
direction or management of such entity, whether by contract or
otherwise, or (ii) ownership of fifty percent (50%) or more of the
outstanding shares, or (iii) beneficial ownership of such entity.
"You" (or "Your") shall mean an individual or Legal Entity
exercising permissions granted by this License.
"Source" form shall mean the preferred form for making modifications,
including but not limited to software source code, documentation
source, and configuration files.
"Object" form shall mean any form resulting from mechanical
transformation or translation of a Source form, including but
not limited to compiled object code, generated documentation,
and conversions to other media types.
"Work" shall mean the work of authorship, whether in Source or
Object form, made available under the License, as indicated by a
copyright notice that is included in or attached to the work
(an example is provided in the Appendix below).
"Derivative Works" shall mean any work, whether in Source or Object
form, that is based on (or derived from) the Work and for which the
editorial revisions, annotations, elaborations, or other modifications
represent, as a whole, an original work of authorship. For the purposes
of this License, Derivative Works shall not include works that remain
separable from, or merely link (or bind by name) to the interfaces of,
the Work and Derivative Works thereof.
"Contribution" shall mean any work of authorship, including
the original version of the Work and any modifications or additions
to that Work or Derivative Works thereof, that is intentionally
submitted to Licensor for inclusion in the Work by the copyright owner
or by an individual or Legal Entity authorized to submit on behalf of
the copyright owner. For the purposes of this definition, "submitted"
means any form of electronic, verbal, or written communication sent
to the Licensor or its representatives, including but not limited to
communication on electronic mailing lists, source code control systems,
and issue tracking systems that are managed by, or on behalf of, the
Licensor for the purpose of discussing and improving the Work, but
excluding communication that is conspicuously marked or otherwise
designated in writing by the copyright owner as "Not a Contribution."
"Contributor" shall mean Licensor and any individual or Legal Entity
on behalf of whom a Contribution has been received by Licensor and
subsequently incorporated within the Work.
2. Grant of Copyright License. Subject to the terms and conditions of
this License, each Contributor hereby grants to You a perpetual,
worldwide, non-exclusive, no-charge, royalty-free, irrevocable
copyright license to reproduce, prepare Derivative Works of,
publicly display, publicly perform, sublicense, and distribute the
Work and such Derivative Works in Source or Object form.
3. Grant of Patent License. Subject to the terms and conditions of
this License, each Contributor hereby grants to You a perpetual,
worldwide, non-exclusive, no-charge, royalty-free, irrevocable
(except as stated in this section) patent license to make, have made,
use, offer to sell, sell, import, and otherwise transfer the Work,
where such license applies only to those patent claims licensable
by such Contributor that are necessarily infringed by their
Contribution(s) alone or by combination of their Contribution(s)
with the Work to which such Contribution(s) was submitted. If You
institute patent litigation against any entity (including a
cross-claim or counterclaim in a lawsuit) alleging that the Work
or a Contribution incorporated within the Work constitutes direct
or contributory patent infringement, then any patent licenses
granted to You under this License for that Work shall terminate
as of the date such litigation is filed.
4. Redistribution. You may reproduce and distribute copies of the
Work or Derivative Works thereof in any medium, with or without
modifications, and in Source or Object form, provided that You
meet the following conditions:
(a) You must give any other recipients of the Work or
Derivative Works a copy of this License; and
(b) You must cause any modified files to carry prominent notices
stating that You changed the files; and
(c) You must retain, in the Source form of any Derivative Works
that You distribute, all copyright, patent, trademark, and
attribution notices from the Source form of the Work,
excluding those notices that do not pertain to any part of
the Derivative Works; and
(d) If the Work includes a "NOTICE" text file as part of its
distribution, then any Derivative Works that You distribute must
include a readable copy of the attribution notices contained
within such NOTICE file, excluding those notices that do not
pertain to any part of the Derivative Works, in at least one
of the following places: within a NOTICE text file distributed
as part of the Derivative Works; within the Source form or
documentation, if provided along with the Derivative Works; or,
within a display generated by the Derivative Works, if and
wherever such third-party notices normally appear. The contents
of the NOTICE file are for informational purposes only and
do not modify the License. You may add Your own attribution
notices within Derivative Works that You distribute, alongside
or as an addendum to the NOTICE text from the Work, provided
that such additional attribution notices cannot be construed
as modifying the License.
You may add Your own copyright statement to Your modifications and
may provide additional or different license terms and conditions
for use, reproduction, or distribution of Your modifications, or
for any such Derivative Works as a whole, provided Your use,
reproduction, and distribution of the Work otherwise complies with
the conditions stated in this License.
5. Submission of Contributions. Unless You explicitly state otherwise,
any Contribution intentionally submitted for inclusion in the Work
by You to the Licensor shall be under the terms and conditions of
this License, without any additional terms or conditions.
Notwithstanding the above, nothing herein shall supersede or modify
the terms of any separate license agreement you may have executed
with Licensor regarding such Contributions.
6. Trademarks. This License does not grant permission to use the trade
names, trademarks, service marks, or product names of the Licensor,
except as required for reasonable and customary use in describing the
origin of the Work and reproducing the content of the NOTICE file.
7. Disclaimer of Warranty. Unless required by applicable law or
agreed to in writing, Licensor provides the Work (and each
Contributor provides its Contributions) on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
implied, including, without limitation, any warranties or conditions
of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
PARTICULAR PURPOSE. You are solely responsible for determining the
appropriateness of using or redistributing the Work and assume any
risks associated with Your exercise of permissions under this License.
8. Limitation of Liability. In no event and under no legal theory,
whether in tort (including negligence), contract, or otherwise,
unless required by applicable law (such as deliberate and grossly
negligent acts) or agreed to in writing, shall any Contributor be
liable to You for damages, including any direct, indirect, special,
incidental, or consequential damages of any character arising as a
result of this License or out of the use or inability to use the
Work (including but not limited to damages for loss of goodwill,
work stoppage, computer failure or malfunction, or any and all
other commercial damages or losses), even if such Contributor
has been advised of the possibility of such damages.
9. Accepting Warranty or Additional Liability. While redistributing
the Work or Derivative Works thereof, You may choose to offer,
and charge a fee for, acceptance of support, warranty, indemnity,
or other liability obligations and/or rights consistent with this
License. However, in accepting such obligations, You may act only
on Your own behalf and on Your sole responsibility, not on behalf
of any other Contributor, and only if You agree to indemnify,
defend, and hold each Contributor harmless for any liability
incurred by, or claims asserted against, such Contributor by reason
of your accepting any such warranty or additional liability.
END OF TERMS AND CONDITIONS
APPENDIX: How to apply the Apache License to your work.
To apply the Apache License to your work, attach the following
boilerplate notice, with the fields enclosed by brackets "[]"
replaced with your own identifying information. (Don't include
the brackets!) The text should be enclosed in the appropriate
comment syntax for the file format. We also recommend that a
file or class name and description of purpose be included on the
same "printed page" as the copyright notice for easier
identification within third-party archives.
Copyright [yyyy] [name of copyright owner]
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

6
modules/utilities/unix/package_management/apt/MAINTAINERS.md
View File

@@ -1,6 +0,0 @@
## Maintenance
Maintainers:
- Puppet Forge Modules Team `forge-modules |at| puppet |dot| com`
Tickets: https://tickets.puppet.com/browse/MODULES. Make sure to set component to `apt`.

37
modules/utilities/unix/package_management/apt/NOTICE
View File

@@ -1,37 +0,0 @@
Puppet Module - puppetlabs-apt
Copyright 2017 Puppet, Inc.
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
Copyright (c) 2011 Evolving Web Inc.
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in
all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
THE SOFTWARE.

295
modules/utilities/unix/package_management/apt/README.md
View File

@@ -1,295 +0,0 @@
# apt
#### Table of Contents
1. [Module Description - What the module does and why it is useful](#module-description)
1. [Setup - The basics of getting started with apt](#setup)
* [What apt affects](#what-apt-affects)
* [Beginning with apt](#beginning-with-apt)
1. [Usage - Configuration options and additional functionality](#usage)
* [Add GPG keys](#add-gpg-keys)
* [Prioritize backports](#prioritize-backports)
* [Update the list of packages](#update-the-list-of-packages)
* [Pin a specific release](#pin-a-specific-release)
* [Add a Personal Package Archive repository](#add-a-personal-package-archive-repository)
* [Configure Apt from Hiera](#configure-apt-from-hiera)
* [Replace the default sources.list file](#replace-the-default-sourceslist-file)
1. [Reference - An under-the-hood peek at what the module is doing and how](#reference)
1. [Limitations - OS compatibility, etc.](#limitations)
1. [Development - Guide for contributing to the module](#development)
## Module Description
The apt module lets you use Puppet to manage APT (Advanced Package Tool) sources, keys, and other configuration options.
APT 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.
**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.
## Setup
### What apt affects
* Your system's `preferences` file and `preferences.d` directory
* Your system's `sources.list` file and `sources.list.d` directory
* System repositories
* Authentication keys
**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`.
### Beginning with apt
To use the apt module with default parameters, declare the `apt` class.
```puppet
include apt
```
**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.
## Usage
### Add GPG keys
**Warning:** Using short key IDs presents a serious security issue, potentially leaving you open to collision attacks. We recommend you always use full fingerprints to identify your GPG keys. This module allows short keys, but issues a security warning if you use them.
Declare the `apt::key` defined type:
```puppet
apt::key { 'puppetlabs':
id => '6F6B15509CF8E59E6E469F327F438280EF8D349F',
server => 'pgp.mit.edu',
options => 'http-proxy="http://proxyuser:proxypass@example.org:3128"',
}
```
### Prioritize backports
```puppet
class { 'apt::backports':
pin => 500,
}
```
By 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.
If 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.
### Update the list of packages
By 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':
```puppet
class { 'apt':
update => {
frequency => 'daily',
},
}
```
When `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:
```puppet
class { 'apt':
update => {
frequency => 'daily',
loglevel => 'debug',
},
}
```
### Pin a specific release
```puppet
apt::pin { 'karmic': priority => 700 }
apt::pin { 'karmic-updates': priority => 700 }
apt::pin { 'karmic-security': priority => 700 }
```
You can also specify more complex pins using distribution properties:
```puppet
apt::pin { 'stable':
priority => -10,
originator => 'Debian',
release_version => '3.0',
component => 'main',
label => 'Debian'
}
```
To pin multiple packages, pass them to the `packages` parameter as an array or a space-delimited string.
### Add a Personal Package Archive (PPA) repository
```puppet
apt::ppa { 'ppa:drizzle-developers/ppa': }
```
### Add an Apt source to `/etc/apt/sources.list.d/`
```puppet
apt::source { 'debian_unstable':
comment => 'This is the iWeb Debian unstable mirror',
location => 'http://debian.mirror.iweb.ca/debian/',
release => 'unstable',
repos => 'main contrib non-free',
pin => '-10',
key => {
'id' => 'A1BD8E9D78F7FE5C3E65D8AF8B48AD6246925553',
'server' => 'subkeys.pgp.net',
},
include => {
'src' => true,
'deb' => true,
},
}
```
To use the Puppet Apt repository as a source:
```puppet
apt::source { 'puppetlabs':
location => 'http://apt.puppetlabs.com',
repos => 'main',
key => {
'id' => '6F6B15509CF8E59E6E469F327F438280EF8D349F',
'server' => 'pgp.mit.edu',
},
}
```
### Configure Apt from Hiera
Instead of specifying your sources directly as resources, you can instead just include the `apt` class, which will pick up the values automatically from hiera.
```yaml
apt::sources:
'debian_unstable':
comment: 'This is the iWeb Debian unstable mirror'
location: 'http://debian.mirror.iweb.ca/debian/'
release: 'unstable'
repos: 'main contrib non-free'
pin: '-10'
key:
id: 'A1BD8E9D78F7FE5C3E65D8AF8B48AD6246925553'
server: 'subkeys.pgp.net'
include:
src: true
deb: true
'puppetlabs':
location: 'http://apt.puppetlabs.com'
repos: 'main'
key:
id: '6F6B15509CF8E59E6E469F327F438280EF8D349F'
server: 'pgp.mit.edu'
```
### Replace the default `sources.list` file
The 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.
```puppet
apt::source { "archive.ubuntu.com-${lsbdistcodename}":
location => 'http://archive.ubuntu.com/ubuntu',
key => '630239CC130E1A7FD81A27B140976EAF437D05B5',
repos => 'main universe multiverse restricted',
}
apt::source { "archive.ubuntu.com-${lsbdistcodename}-security":
location => 'http://archive.ubuntu.com/ubuntu',
key => '630239CC130E1A7FD81A27B140976EAF437D05B5',
repos => 'main universe multiverse restricted',
release => "${lsbdistcodename}-security"
}
apt::source { "archive.ubuntu.com-${lsbdistcodename}-updates":
location => 'http://archive.ubuntu.com/ubuntu',
key => '630239CC130E1A7FD81A27B140976EAF437D05B5',
repos => 'main universe multiverse restricted',
release => "${lsbdistcodename}-updates"
}
apt::source { "archive.ubuntu.com-${lsbdistcodename}-backports":
location => 'http://archive.ubuntu.com/ubuntu',
key => '630239CC130E1A7FD81A27B140976EAF437D05B5',
repos => 'main universe multiverse restricted',
release => "${lsbdistcodename}-backports"
}
```
### Manage login configuration settings for an APT source or proxy in `/etc/apt/auth.conf`
Starting with APT version 1.5, you can define login configuration settings, such as
username and password, for APT sources or proxies that require authentication
in the `/etc/apt/auth.conf` file. This is preferable to embedding login
information directly in `source.list` entries, which are usually world-readable.
The `/etc/apt/auth.conf` file follows the format of netrc (used by ftp or
curl) and has restrictive file permissions. See [here](https://manpages.debian.org/testing/apt/apt_auth.conf.5.en.html) for details.
Use the optional `apt::auth_conf_entries` parameter to specify an array of hashes containing login configuration settings. These hashes may only contain the `machine`, `login` and `password` keys.
```puppet
class { 'apt':
auth_conf_entries => [
{
'machine' => 'apt-proxy.example.net',
'login' => 'proxylogin',
'password' => 'proxypassword',
},
{
'machine' => 'apt.example.com/ubuntu',
'login' => 'reader',
'password' => 'supersecret',
},
],
}
```
## Reference
### Facts
* `apt_updates`: The number of installed packages with available updates from `upgrade`.
* `apt_dist_updates`: The number of installed packages with available updates from `dist-upgrade`.
* `apt_security_updates`: The number of installed packages with available security updates from `upgrade`.
* `apt_security_dist_updates`: The number of installed packages with available security updates from `dist-upgrade`.
* `apt_package_updates`: The names of all installed packages with available updates from `upgrade`. In Facter 2.0 and later this data is formatted as an array; in earlier versions it is a comma-delimited string.
* `apt_package_dist_updates`: The names of all installed packages with available updates from `dist-upgrade`. In Facter 2.0 and later this data is formatted as an array; in earlier versions it is a comma-delimited string.
* `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).
* `apt_reboot_required`: Determines if a reboot is necessary after updates have been installed.
### More Information
See [REFERENCE.md](https://github.com/puppetlabs/puppetlabs-apt/blob/master/REFERENCE.md) for all other reference documentation.
## Limitations
This module is not designed to be split across [run stages](https://docs.puppetlabs.com/puppet/latest/reference/lang_run_stages.html).
For an extensive list of supported operating systems, see [metadata.json](https://github.com/puppetlabs/puppetlabs-apt/blob/master/metadata.json)
### Adding new sources or PPAs
If 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']`, as well as 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). Before running the command below, ensure that all packages have the provider set to apt.
```puppet
Class['apt::update'] -> Package <| provider == 'apt' |>
```
## Development
Puppet 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.
For more information, see our [module contribution guide.](https://docs.puppetlabs.com/forge/contributing.html)
To see who's already involved, see the [list of contributors.](https://github.com/puppetlabs/puppetlabs-apt/graphs/contributors)

865
modules/utilities/unix/package_management/apt/REFERENCE.md
View File

@@ -1,865 +0,0 @@
# Reference
<!-- DO NOT EDIT: This document was generated by Puppet Strings -->
## Table of Contents
**Classes**
_Public Classes_
* [`apt`](#apt): Main class, includes all other classes.
* [`apt::backports`](#aptbackports): Manages backports.
_Private Classes_
* `apt::params`: Provides defaults for the Apt module parameters.
* `apt::update`: Updates the list of available packages using apt-get update.
**Defined types**
* [`apt::conf`](#aptconf): Specifies a custom Apt configuration file.
* [`apt::key`](#aptkey): Manages the GPG keys that Apt uses to authenticate packages.
* [`apt::pin`](#aptpin): Manages Apt pins. Does not trigger an apt-get update run.
* [`apt::ppa`](#aptppa): Manages PPA repositories using `add-apt-repository`. Not supported on Debian.
* [`apt::setting`](#aptsetting): Manages Apt configuration files.
* [`apt::source`](#aptsource): Manages the Apt sources in /etc/apt/sources.list.d/.
**Resource types**
_Public Resource types_
_Private Resource types_
* `apt_key`: This type provides Puppet with the capabilities to manage GPG keys needed
by apt to perform package validation. Apt has it's own GPG keyring that can
be manipulated through the `apt-key` command.
**Tasks**
* [`init`](#init): Allows you to perform apt functions
## Classes
### apt
Main class, includes all other classes.
* **See also**
https://docs.puppetlabs.com/references/latest/function.html#createresources
for the create resource function
#### Parameters
The following parameters are available in the `apt` class.
##### `provider`
Data type: `String`
Specifies the provider that should be used by apt::update.
Default value: $apt::params::provider
##### `keyserver`
Data type: `String`
Specifies a keyserver to provide the GPG key. Valid options: a string containing a domain name or a full URL (http://, https://,
hkp:// or hkps://). The hkps:// protocol is currently only supported on Ubuntu 18.04.
Default value: $apt::params::keyserver
##### `ppa_options`
Data type: `Optional[String]`
Supplies options to be passed to the `add-apt-repository` command.
Default value: $apt::params::ppa_options
##### `ppa_package`
Data type: `Optional[String]`
Names the package that provides the `apt-add-repository` command.
Default value: $apt::params::ppa_package
##### `backports`
Data type: `Optional[Hash]`
Specifies some of the default parameters used by apt::backports. Valid options: a hash made up from the following keys:
Options:
* **:location** `String`: See apt::backports for documentation.
* **:repos** `String`: See apt::backports for documentation.
* **:key** `String`: See apt::backports for documentation.
Default value: $apt::params::backports
##### `confs`
Data type: `Hash`
Creates new `apt::conf` resources. Valid options: a hash to be passed to the create_resources function linked above.
Default value: $apt::params::confs
##### `update`
Data type: `Hash`
Configures various update settings. Valid options: a hash made up from the following keys:
Options:
* **:frequency** `String`: 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'.
* **:loglevel** `Integer`: Specifies the log level of logs outputted to the console. Default: undef.
* **:timeout** `Integer`: Specifies how long to wait for the update to complete before canceling it. Valid options: an integer, in seconds. Default: undef.
* **:tries** `Integer`: Specifies how many times to retry the update after receiving a DNS or HTTP error. Default: undef.
Default value: $apt::params::update
##### `purge`
Data type: `Hash`
Specifies whether to purge any existing settings that aren't managed by Puppet. Valid options: a hash made up from the following keys:
Options:
* **:sources.list** `Boolean`: Specifies whether to purge any unmanaged entries from sources.list. Default false.
* **:sources.list.d** `Boolean`: Specifies whether to purge any unmanaged entries from sources.list.d. Default false.
* **:preferences** `Boolean`: Specifies whether to purge any unmanaged entries from preferences. Default false.
* **:preferences.d.** `Boolean`: Specifies whether to purge any unmanaged entries from preferences.d. Default false.
Default value: $apt::params::purge
##### `proxy`
Data type: `Apt::Proxy`
Configures Apt to connect to a proxy server. Valid options: a hash matching the locally defined type apt::proxy.
Default value: $apt::params::proxy
##### `sources`
Data type: `Hash`
Creates new `apt::source` resources. Valid options: a hash to be passed to the create_resources function linked above.
Default value: $apt::params::sources
##### `keys`
Data type: `Hash`
Creates new `apt::key` resources. Valid options: a hash to be passed to the create_resources function linked above.
Default value: $apt::params::keys
##### `ppas`
Data type: `Hash`
Creates new `apt::ppa` resources. Valid options: a hash to be passed to the create_resources function linked above.
Default value: $apt::params::ppas
##### `pins`
Data type: `Hash`
Creates new `apt::pin` resources. Valid options: a hash to be passed to the create_resources function linked above.
Default value: $apt::params::pins
##### `settings`
Data type: `Hash`
Creates new `apt::setting` resources. Valid options: a hash to be passed to the create_resources function linked above.
Default value: $apt::params::settings
##### `auth_conf_entries`
Data type: `Array[Apt::Auth_conf_entry]`
An optional array of login configuration settings (hashes) that are recorded in the file /etc/apt/auth.conf. This file has a netrc-like
format (similar to what curl uses) and contains the login configuration for APT sources and proxies that require authentication. See
https://manpages.debian.org/testing/apt/apt_auth.conf.5.en.html for details. If specified each hash must contain the keys machine, login and
password and no others.
Default value: $apt::params::auth_conf_entries
##### `root`
Data type: `String`
Specifies root directory of Apt executable.
Default value: $apt::params::root
##### `sources_list`
Data type: `String`
Specifies the path of the sources_list file to use.
Default value: $apt::params::sources_list
##### `sources_list_d`
Data type: `String`
Specifies the path of the sources_list.d file to use.
Default value: $apt::params::sources_list_d
##### `conf_d`
Data type: `String`
Specifies the path of the conf.d file to use.
Default value: $apt::params::conf_d
##### `preferences`
Data type: `String`
Specifies the path of the preferences file to use.
Default value: $apt::params::preferences
##### `preferences_d`
Data type: `String`
Specifies the path of the preferences.d file to use.
Default value: $apt::params::preferences_d
##### `config_files`
Data type: `Hash`
A hash made up of the various configuration files used by Apt.
Default value: $apt::params::config_files
##### `update_defaults`
Data type: `Hash`
Default value: $apt::params::update_defaults
##### `purge_defaults`
Data type: `Hash`
Default value: $apt::params::purge_defaults
##### `proxy_defaults`
Data type: `Hash`
Default value: $apt::params::proxy_defaults
##### `include_defaults`
Data type: `Hash`
Default value: $apt::params::include_defaults
##### `source_key_defaults`
Data type: `Hash`
Default value: $apt::params::source_key_defaults
### apt::backports
Manages backports.
#### Examples
##### Set up a backport for linuxmint qiana
```puppet
apt::backports { 'qiana':
location => 'http://us.archive.ubuntu.com/ubuntu',
release => 'trusty-backports',
repos => 'main universe multiverse restricted',
key => {
id => '630239CC130E1A7FD81A27B140976EAF437D05B5',
server => 'hkps.pool.sks-keyservers.net',
},
}
```
#### Parameters
The following parameters are available in the `apt::backports` class.
##### `location`
Data type: `Optional[String]`
Specifies an Apt repository containing the backports to manage. Valid options: a string containing a URL. Default value for Debian and
Ubuntu varies:
- Debian: 'http://deb.debian.org/debian'
- Ubuntu: 'http://archive.ubuntu.com/ubuntu'
Default value: `undef`
##### `release`
Data type: `Optional[String]`
Specifies a distribution of the Apt repository containing the backports to manage. 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.
Default value: `undef`
##### `repos`
Data type: `Optional[String]`
Specifies a component of the Apt repository containing the backports to manage. Used in populating the `source.list` configuration file.
Default value for Debian and Ubuntu varies:
- Debian: 'main contrib non-free'
- Ubuntu: 'main universe multiverse restricted'
Default value: `undef`
##### `key`
Data type: `Optional[Variant[String, Hash]]`
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. Default value
for Debian and Ubuntu varies:
- Debian: 'A1BD8E9D78F7FE5C3E65D8AF8B48AD6246925553'
- Ubuntu: '630239CC130E1A7FD81A27B140976EAF437D05B5'
Default value: `undef`
##### `pin`
Data type: `Optional[Variant[Integer, String, Hash]]`
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 value: 200
## Defined types
### apt::conf
Specifies a custom Apt configuration file.
#### Parameters
The following parameters are available in the `apt::conf` defined type.
##### `content`
Data type: `Optional[String]`
Required unless `ensure` is set to 'absent'. Directly supplies content for the configuration file.
Default value: `undef`
##### `ensure`
Data type: `Enum['present', 'absent']`
Specifies whether the configuration file should exist. Valid options: 'present' and 'absent'.
Default value: present
##### `priority`
Data type: `Variant[String, Integer]`
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 or an integer.
Default value: 50
##### `notify_update`
Data type: `Optional[Boolean]`
Specifies whether to trigger an `apt-get update` run.
Default value: `undef`
### apt::key
Manages the GPG keys that Apt uses to authenticate packages.
* **Note** The apt::key defined type makes use of the apt_key type, but includes extra functionality to help prevent duplicate keys.
#### Examples
##### Declare Apt key for apt.puppetlabs.com source
```puppet
apt::key { 'puppetlabs':
id => '6F6B15509CF8E59E6E469F327F438280EF8D349F',
server => 'hkps.pool.sks-keyservers.net',
options => 'http-proxy="http://proxyuser:proxypass@example.org:3128"',
}
```
#### Parameters
The following parameters are available in the `apt::key` defined type.
##### `id`
Data type: `Pattern[/\A(0x)?[0-9a-fA-F]{8}\Z/, /\A(0x)?[0-9a-fA-F]{16}\Z/, /\A(0x)?[0-9a-fA-F]{40}\Z/]`
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 value: $title
##### `ensure`
Data type: `Enum['present', 'absent', 'refreshed']`
Specifies whether the key should exist. Valid options: 'present', 'absent' or 'refreshed'. Using 'refreshed' will make keys auto
update when they have expired (assuming a new key exists on the key server).
Default value: present
##### `content`
Data type: `Optional[String]`
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.
Default value: `undef`
##### `source`
Data type: `Optional[Pattern[/\Ahttps?:\/\//, /\Aftp:\/\//, /\A\/\w+/]]`
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 value: `undef`
##### `server`
Data type: `Pattern[/\A((hkp|hkps|http|https):\/\/)?([a-z\d])([a-z\d-]{0,61}\.)+[a-z\d]+(:\d{2,5})?$/]`
Specifies a keyserver to provide the GPG key. Valid options: a string containing a domain name or a full URL (http://, https://,
hkp:// or hkps://). The hkps:// protocol is currently only supported on Ubuntu 18.04.
Default value: $::apt::keyserver
##### `options`
Data type: `Optional[String]`
Passes additional options to `apt-key adv --keyserver-options`.
Default value: `undef`
### apt::pin
Manages Apt pins. Does not trigger an apt-get update run.
* **See also**
http://linux.die.net/man/5/apt_preferences
for context on these parameters
#### Parameters
The following parameters are available in the `apt::pin` defined type.
##### `ensure`
Data type: `Optional[Enum['file', 'present', 'absent']]`
Specifies whether the pin should exist. Valid options: 'file', 'present', and 'absent'.
Default value: present
##### `explanation`
Data type: `Optional[String]`
Supplies a comment to explain the pin. Default: "${caller_module_name}: ${name}".
Default value: `undef`
##### `order`
Data type: `Variant[Integer]`
Determines the order in which Apt processes the pin file. Files with lower order numbers are loaded first.
Default value: 50
##### `packages`
Data type: `Variant[String, Array]`
Specifies which package(s) to pin.
Default value: '*'
##### `priority`
Data type: `Variant[Numeric, String]`
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 value: 0
##### `release`
Data type: `Optional[String]`
Tells APT to prefer packages that support the specified release. Typical values include 'stable', 'testing', and 'unstable'.
Default value: ''
##### `release_version`
Data type: `Optional[String]`
Tells APT to prefer packages that support the specified operating system release version (such as Debian release version 7).
Default value: ''
##### `component`
Data type: `Optional[String]`
Names the licensing component associated with the packages in the directory tree of the Release file.
Default value: ''
##### `originator`
Data type: `Optional[String]`
Names the originator of the packages in the directory tree of the Release file.
Default value: ''
##### `label`
Data type: `Optional[String]`
Names the label of the packages in the directory tree of the Release file.
Default value: ''
##### `origin`
Data type: `Optional[String]`
Default value: ''
##### `version`
Data type: `Optional[String]`
Default value: ''
##### `codename`
Data type: `Optional[String]`
Default value: ''
### apt::ppa
Manages PPA repositories using `add-apt-repository`. Not supported on Debian.
#### Examples
##### Example declaration of an Apt PPA
```puppet
apt::ppa{ 'ppa:openstack-ppa/bleeding-edge': }
```
#### Parameters
The following parameters are available in the `apt::ppa` defined type.
##### `ensure`
Data type: `String`
Specifies whether the PPA should exist. Valid options: 'present' and 'absent'.
Default value: 'present'
##### `options`
Data type: `Optional[String]`
Supplies options to be passed to the `add-apt-repository` command. Default: '-y'.
Default value: $::apt::ppa_options
##### `release`
Data type: `Optional[String]`
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 value: $facts['lsbdistcodename']
##### `package_name`
Data type: `Optional[String]`
Names the package that provides the `apt-add-repository` command. Default: 'software-properties-common'.
Default value: $::apt::ppa_package
##### `package_manage`
Data type: `Boolean`
Specifies whether Puppet should manage the package that provides `apt-add-repository`.
Default value: `false`
### apt::setting
Manages Apt configuration files.
* **See also**
https://docs.puppetlabs.com/references/latest/type.html#file-attributes
for more information on source and content parameters
#### Parameters
The following parameters are available in the `apt::setting` defined type.
##### `priority`
Data type: `Variant[String, Integer, Array]`
Determines the order in which Apt processes the configuration file. Files with higher priority numbers are loaded first.
Default value: 50
##### `ensure`
Data type: `Optional[Enum['file', 'present', 'absent']]`
Specifies whether the file should exist. Valid options: 'present', 'absent', and 'file'.
Default value: file
##### `source`
Data type: `Optional[String]`
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 link above for Puppet's native file type source attribute.
Default value: `undef`
##### `content`
Data type: `Optional[String]`
Required, unless `source` is set. Directly supplies content for the configuration file. Cannot be used in combination with `source`. Valid
options: see link above for Puppet's native file type content attribute.
Default value: `undef`
##### `notify_update`
Data type: `Boolean`
Specifies whether to trigger an `apt-get update` run.
Default value: `true`
### apt::source
Manages the Apt sources in /etc/apt/sources.list.d/.
#### Examples
##### Install the puppetlabs apt source
```puppet
apt::source { 'puppetlabs':
location => 'http://apt.puppetlabs.com',
repos => 'main',
key => {
id => '6F6B15509CF8E59E6E469F327F438280EF8D349F',
server => 'hkps.pool.sks-keyservers.net',
},
}
```
#### Parameters
The following parameters are available in the `apt::source` defined type.
##### `location`
Data type: `Optional[String]`
Required, unless ensure is set to 'absent'. Specifies an Apt repository. Valid options: a string containing a repository URL.
Default value: `undef`
##### `comment`
Data type: `String`
Supplies a comment for adding to the Apt source file.
Default value: $name
##### `ensure`
Data type: `String`
Specifies whether the Apt source file should exist. Valid options: 'present' and 'absent'.
Default value: present
##### `release`
Data type: `Optional[String]`
Specifies a distribution of the Apt repository.
Default value: `undef`
##### `repos`
Data type: `String`
Specifies a component of the Apt repository.
Default value: 'main'
##### `include`
Data type: `Optional[Variant[Hash]]`
Configures include options. Valid options: a hash of available keys.
Options:
* **:deb** `Boolean`: Specifies whether to request the distribution's compiled binaries. Default true.
* **:src** `Boolean`: Specifies whether to request the distribution's uncompiled source code. Default false.
Default value: {}
##### `key`
Data type: `Optional[Variant[String, Hash]]`
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 value: `undef`
##### `pin`
Data type: `Optional[Variant[Hash, Numeric, String]]`
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 value: `undef`
##### `architecture`
Data type: `Optional[String]`
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).
Default value: `undef`
##### `allow_unsigned`
Data type: `Boolean`
Specifies whether to authenticate packages from this release, even if the Release file is not signed or the signature can't be checked.
Default value: `false`
##### `notify_update`
Data type: `Boolean`
Specifies whether to trigger an `apt-get update` run.
Default value: `true`
## Resource types
## Tasks
### init
Allows you to perform apt functions
**Supports noop?** false
#### Parameters
##### `action`
Data type: `Enum[update, upgrade]`
Action to perform

76
modules/utilities/unix/package_management/apt/Rakefile
View File

@@ -1,76 +0,0 @@
require 'puppetlabs_spec_helper/rake_tasks'
require 'puppet-syntax/tasks/puppet-syntax'
require 'puppet_blacksmith/rake_tasks' if Bundler.rubygems.find_name('puppet-blacksmith').any?
require 'github_changelog_generator/task' if Bundler.rubygems.find_name('github_changelog_generator').any?
require 'puppet_pot_generator/rake_tasks'
def changelog_user
return unless Rake.application.top_level_tasks.include? "changelog"
returnVal = nil || JSON.load(File.read('metadata.json'))['author']
raise "unable to find the changelog_user in .sync.yml, or the author in metadata.json" if returnVal.nil?
puts "GitHubChangelogGenerator user:#{returnVal}"
returnVal
end
def changelog_project
return unless Rake.application.top_level_tasks.include? "changelog"
returnVal = nil || JSON.load(File.read('metadata.json'))['name']
raise "unable to find the changelog_project in .sync.yml or the name in metadata.json" if returnVal.nil?
puts "GitHubChangelogGenerator project:#{returnVal}"
returnVal
end
def changelog_future_release
return unless Rake.application.top_level_tasks.include? "changelog"
returnVal = JSON.load(File.read('metadata.json'))['version']
raise "unable to find the future_release (version) in metadata.json" if returnVal.nil?
puts "GitHubChangelogGenerator future_release:#{returnVal}"
returnVal
end
PuppetLint.configuration.send('disable_relative')
if Bundler.rubygems.find_name('github_changelog_generator').any?
GitHubChangelogGenerator::RakeTask.new :changelog do |config|
raise "Set CHANGELOG_GITHUB_TOKEN environment variable eg 'export CHANGELOG_GITHUB_TOKEN=valid_token_here'" if Rake.application.top_level_tasks.include? "changelog" and ENV['CHANGELOG_GITHUB_TOKEN'].nil?
config.user = "#{changelog_user}"
config.project = "#{changelog_project}"
config.future_release = "#{changelog_future_release}"
config.exclude_labels = ['maintenance']
config.header = "# Change log\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/) and this project adheres to [Semantic Versioning](http://semver.org)."
config.add_pr_wo_labels = true
config.issues = false
config.merge_prefix = "### UNCATEGORIZED PRS; GO LABEL THEM"
config.configure_sections = {
"Changed" => {
"prefix" => "### Changed",
"labels" => ["backwards-incompatible"],
},
"Added" => {
"prefix" => "### Added",
"labels" => ["feature", "enhancement"],
},
"Fixed" => {
"prefix" => "### Fixed",
"labels" => ["bugfix"],
},
}
end
else
desc 'Generate a Changelog from GitHub'
task :changelog do
raise <<EOM
The changelog tasks depends on unreleased features of the github_changelog_generator gem.
Please manually add it to your .sync.yml for now, and run `pdk update`:
---
Gemfile:
optional:
':development':
- gem: 'github_changelog_generator'
git: 'https://github.com/skywinder/github-changelog-generator'
ref: '20ee04ba1234e9e83eb2ffb5056e23d641c7a018'
condition: "Gem::Version.new(RUBY_VERSION.dup) >= Gem::Version.new('2.2.2')"
EOM
end
end

0
modules/utilities/unix/package_management/apt/apt.pp
View File

95
modules/utilities/unix/package_management/apt/checksums.json
View File

@@ -1,95 +0,0 @@
{
"CHANGELOG.md": "8f21776d8c5e02e57d3d766f4b147779",
"CONTRIBUTING.md": "4d17f3c942e7c93d1577cc4438a231e4",
"Gemfile": "e35aeaf9f7e4200bbd4ef8fbbde3a3f2",
"HISTORY.md": "0e80b98698dacc680a1af56fd0566b3b",
"LICENSE": "3b83ef96387f14655fc854ddc3c6bd57",
"MAINTAINERS.md": "35674b233c6d12c0f56ee8afbdae29e4",
"NOTICE": "9533d13591355591f69619be28e9cfce",
"README.md": "efbda6fa2ce592c2fa0797e7770efebc",
"REFERENCE.md": "3ca7451673e2263a8180d1e2e548f799",
"Rakefile": "5a645b196705e2e8d973114d1552e5ef",
"examples/backports.pp": "af57ea62ed1b73f540858e00327e6517",
"examples/builddep.pp": "eddb8b7d7c0ef7383d85a74c1cd0de3f",
"examples/debian_testing.pp": "2e50a41180e2afeac2de15ade05ddaa1",
"examples/debian_unstable.pp": "82890803cc4423443db8f40353e16262",
"examples/disable_keys.pp": "3d4e7ac49946d961ff51a719ee713293",
"examples/fancy_progress.pp": "9a55d4ea52be4ebd670befff7ca3b87f",
"examples/force.pp": "f71857eba704a0eb3d8d6b146e80da6d",
"examples/hold.pp": "5e58e0a30d6407a05691d96c7647ae14",
"examples/key.pp": "d85507365bd2753e14e04c344c2f7703",
"examples/pin.pp": "4b4c3612d75a19dba8eb7227070fa4ab",
"examples/ppa.pp": "b902cce8159128b5e8b21bed540743ff",
"examples/release.pp": "2bc960babf8c4dd24b7ffa4220a601f8",
"examples/source.pp": "c79817e129305f86a495f7558de3d3ec",
"examples/unattended_upgrades.pp": "e7a797388ef03077f110f4f268f5ecd1",
"lib/facter/apt_reboot_required.rb": "e7dbcd3849c380cdd08dbc866079c211",
"lib/facter/apt_update_last_success.rb": "f259aac4abdf82c1c6f13e0031bf551a",
"lib/facter/apt_updates.rb": "11be6c6ace6c11cef55127564ecc6d91",
"lib/puppet/provider/apt_key/apt_key.rb": "ef3a893338f628f974bb59c36c7756c7",
"lib/puppet/type/apt_key.rb": "16b9fc7bbea65c1cd626b65cf3ea7167",
"locales/config.yaml": "bda37c45d7414bd4e2a6e1c01044e2e6",
"locales/ja/puppetlabs-apt.po": "2ba4d5f45b3cccb958b78322f03e4de4",
"locales/puppetlabs-apt.pot": "ce6a37eaa3865b2d36b4d4cb549a326f",
"manifests/backports.pp": "0940aab318d22cdd25ad400719a3018f",
"manifests/conf.pp": "b1ce82c9f2e16f6580a49cf1d81aa5c6",
"manifests/init.pp": "7de676f9d915be704c708d127401d968",
"manifests/key.pp": "84d2dd089a58a315ab248be5458ef13f",
"manifests/params.pp": "b654f48b63388ce4d44c779d2a2be538",
"manifests/pin.pp": "23fc805f31b56eb52466487f7ceb065a",
"manifests/ppa.pp": "b2a686c6ed43b1dcc1def3b1c3d6a79c",
"manifests/setting.pp": "6715dbb5fb795415294d55f45577ec85",
"manifests/source.pp": "cefa3f51c0729d754f7e6d87c4e6c305",
"manifests/update.pp": "93ef29d0da40610a36205821229d3304",
"metadata.json": "f947710909662cde3c3458e5c590a676",
"readmes/README_ja_JP.md": "6953301a20c101027391201f6875f7f8",
"spec/acceptance/01_apt_class_spec.rb": "b63ac7a092085ee607aa74c55963004f",
"spec/acceptance/apt_key_provider_spec.rb": "700d5fd0c839e2c4d12546d64519d1d3",
"spec/acceptance/apt_spec.rb": "5ac45a8bd80652788fccf40d504b2aa7",
"spec/acceptance/init_task_spec.rb": "0a9d390d5e801bf0ac5be96a3d90c2b4",
"spec/acceptance/locales_spec.rb": "e4fa6212ade520e17377b812fc8970cb",
"spec/acceptance/nodesets/centos-7-x64.yml": "a713f3abd3657f0ae2878829badd23cd",
"spec/acceptance/nodesets/debian-8-x64.yml": "d2d2977900989f30086ad251a14a1f39",
"spec/acceptance/nodesets/default.yml": "b42da5a1ea0c964567ba7495574b8808",
"spec/acceptance/nodesets/docker/centos-7.yml": "8a3892807bdd62306ae4774f41ba11ae",
"spec/acceptance/nodesets/docker/debian-8.yml": "ac8e871d1068c96de5e85a89daaec6df",
"spec/acceptance/nodesets/docker/ubuntu-14.04.yml": "dc42ee922a96908d85b8f0f08203ce58",
"spec/classes/apt_backports_spec.rb": "8b68574926585ba042934d936fa42281",
"spec/classes/apt_spec.rb": "bdca7b975f8a85f7ec045f999af40fc1",
"spec/classes/apt_update_spec.rb": "6b0e1dcc4bc46e089037a6aebcf9316c",
"spec/default_facts.yml": "b1ca07fac7dcb249d641d8b63239ef7c",
"spec/defines/conf_spec.rb": "81dab32425ed53d0cb48a63c6f2c8ab3",
"spec/defines/key_compat_spec.rb": "e49cadca852b67fac314f16daabca9f5",
"spec/defines/key_spec.rb": "a17ddcb8d18d572d5983258d190ecb69",
"spec/defines/pin_spec.rb": "44513118fde2543e2677addea6f82ff5",
"spec/defines/ppa_spec.rb": "252fa211f18e31d3abaa98ae741e2fb6",
"spec/defines/setting_spec.rb": "cd32f17ce45e39efbbb9c58a17297f84",
"spec/defines/source_compat_spec.rb": "caa5f2b48a0988bbac8f26c824c3e073",
"spec/defines/source_spec.rb": "8f9fd9c40c7315611653f2363a89371b",
"spec/spec_helper.rb": "a5bb4d308d370243a5795477c3a6632e",
"spec/spec_helper_acceptance.rb": "22560818f1a7399b339c42a7c308e2fa",
"spec/unit/facter/apt_dist_has_updates_spec.rb": "6b85d39d586e7654ad2f0ee3af5a2787",
"spec/unit/facter/apt_dist_package_security_updates_spec.rb": "ad738e3a1193b1b3e0052a9130f283c8",
"spec/unit/facter/apt_dist_package_updates_spec.rb": "063821fc13e3b217a853577b6a94a224",
"spec/unit/facter/apt_dist_security_updates_spec.rb": "393a47f50ff6c43aa6ba80d7848cd96a",
"spec/unit/facter/apt_dist_updates_spec.rb": "f96e477aa5c6fd913c2352dba8f40b53",
"spec/unit/facter/apt_has_updates_spec.rb": "cdc8486f14c4c3f35df0c38c2cc72c83",
"spec/unit/facter/apt_package_security_updates_spec.rb": "395761ebec3cd3b3c2ad4dfc7990adc8",
"spec/unit/facter/apt_package_updates_spec.rb": "62708ded28f92c049a38ededa61a7d77",
"spec/unit/facter/apt_reboot_required_spec.rb": "80e860984fc538bede7a2c24625ee234",
"spec/unit/facter/apt_security_updates_spec.rb": "a6d6985e4dcce5839119618d91726c64",
"spec/unit/facter/apt_update_last_success_spec.rb": "0e6cf8b5bec4d91ccfe4b83d088a5b10",
"spec/unit/facter/apt_updates_spec.rb": "6d3fb0763e8133b014838f504ce26f08",
"spec/unit/puppet/type/apt_key_spec.rb": "cba6c11a7a75d2a4c6260f8cbec6692b",
"tasks/init.json": "f6aed51e207a15340d5258d1fab47a69",
"tasks/init.rb": "e65e10bc5d44188a64a03078ae6ceebd",
"templates/15update-stamp.epp": "b9de0ac9e2c9854b1bb213e362dc4e41",
"templates/_conf_header.epp": "6f3077f2eabd3e929a44d55bc1c5446e",
"templates/_header.epp": "9300ac105fe777787ac9e793b8df8d25",
"templates/auth_conf.epp": "5ecb28d31ee897d51b1b29cfe59c8b54",
"templates/pin.pref.epp": "58d462f3ec74c3755a2bd804d7b22207",
"templates/proxy.epp": "7353f09fa5fdb1819517446ec58c9ad5",
"templates/source.list.epp": "c32995778d056f204d51a6d79505a5aa",
"types/auth_conf_entry.pp": "8484d7777144fe7ed87a6e3830cf694a",
"types/proxy.pp": "4bb8b0ad03264cdedb673d1580282b37"
}

11
modules/utilities/unix/package_management/apt/examples/backports.pp
View File

@@ -1,11 +0,0 @@
# Set up a backport for linuxmint qiana
class { 'apt': }
apt::backports { 'qiana':
location => 'http://us.archive.ubuntu.com/ubuntu',
release => 'trusty-backports',
repos => 'main universe multiverse restricted',
key => {
id => '630239CC130E1A7FD81A27B140976EAF437D05B5',
server => 'hkps.pool.sks-keyservers.net',
},
}

3
modules/utilities/unix/package_management/apt/examples/builddep.pp
View File

@@ -1,3 +0,0 @@
package{ 'glusterfs-server':
install_options => 'build-dep',
}

18
modules/utilities/unix/package_management/apt/examples/debian_testing.pp
View File

@@ -1,18 +0,0 @@
package { 'debian-keyring':
ensure => present
}
package { 'debian-archive-keyring':
ensure => present
}
apt::source { 'debian_testing':
location => 'http://debian.mirror.iweb.ca/debian/',
release => 'testing',
repos => 'main contrib non-free',
pin => '-10',
key => {
id => 'A1BD8E9D78F7FE5C3E65D8AF8B48AD6246925553',
server => 'subkeys.pgp.net',
},
}

18
modules/utilities/unix/package_management/apt/examples/debian_unstable.pp
View File

@@ -1,18 +0,0 @@
package { 'debian-keyring':
ensure => present
}
package { 'debian-archive-keyring':
ensure => present
}
apt::source { 'debian_unstable':
location => 'http://debian.mirror.iweb.ca/debian/',
release => 'unstable',
repos => 'main contrib non-free',
pin => '-10',
key => {
id => 'A1BD8E9D78F7FE5C3E65D8AF8B48AD6246925553',
server => 'subkeys.pgp.net',
},
}

5
modules/utilities/unix/package_management/apt/examples/disable_keys.pp
View File

@@ -1,5 +0,0 @@
#Note: This is generally a bad idea. You should not disable verifying repository signatures.
apt::conf { 'unauth':
priority => 99,
content => 'APT::Get::AllowUnauthenticated 1;'
}

4
modules/utilities/unix/package_management/apt/examples/fancy_progress.pp
View File

@@ -1,4 +0,0 @@
apt::conf { 'progressbar':
priority => 99,
content => 'Dpkg::Progress-Fancy "1";',
}

28
modules/utilities/unix/package_management/apt/examples/force.pp
View File

@@ -1,28 +0,0 @@
#if you need to specify a release
$rel_string = '-t <release>'
#else
$rel_string = ''
#if you need to specify a version
$ensure = '<version>'
#else
$ensure = installed
#if overwrite existing cfg files
$config_files = '-o Dpkg::Options::="--force-confnew"'
#elsif force use of old files
$config_files = '-o Dpkg::Options::="--force-confold"'
#elsif update only unchanged files
$config_files = '-o Dpkg::Options::="--force-confdef"'
#else
$config_files = ''
#if install missing configuration files for the package
$config_missing = '-o Dpkg::Options::="--force-confmiss"'
#else
$config_missing = ''
package { '<package>':
ensure => $ensure,
install_options => "${config_files} ${config_missing} ${rel_string}",
}

5
modules/utilities/unix/package_management/apt/examples/hold.pp
View File

@@ -1,5 +0,0 @@
apt::pin { 'hold-vim':
packages => 'vim',
version => '2:7.4.488-5',
priority => 1001,
}

6
modules/utilities/unix/package_management/apt/examples/key.pp
View File

@@ -1,6 +0,0 @@
# Declare Apt key for apt.puppetlabs.com source
apt::key { 'puppetlabs':
id => '6F6B15509CF8E59E6E469F327F438280EF8D349F',
server => 'hkps.pool.sks-keyservers.net',
options => 'http-proxy="http://proxyuser:proxypass@example.org:3128"',
}

5
modules/utilities/unix/package_management/apt/examples/pin.pp
View File

@@ -1,5 +0,0 @@
# pin a release in apt, useful for unstable repositories
apt::pin { 'foo':
packages => '*',
priority => 0,
}

4
modules/utilities/unix/package_management/apt/examples/ppa.pp
View File

@@ -1,4 +0,0 @@
class { 'apt': }
# Example declaration of an Apt PPA
apt::ppa{ 'ppa:openstack-ppa/bleeding-edge': }

4
modules/utilities/unix/package_management/apt/examples/release.pp
View File

@@ -1,4 +0,0 @@
apt::conf { 'release':
content => 'APT::Default-Release "karmic";',
priority => '01',
}

35
modules/utilities/unix/package_management/apt/examples/source.pp
View File

@@ -1,35 +0,0 @@
# Declare the apt class to manage /etc/apt/sources.list and /etc/sources.list.d
class { 'apt': }
# Install the puppetlabs apt source
# Release is automatically obtained from lsbdistcodename fact if available.
apt::source { 'puppetlabs':
location => 'http://apt.puppetlabs.com',
repos => 'main',
key => {
id => '6F6B15509CF8E59E6E469F327F438280EF8D349F',
server => 'hkps.pool.sks-keyservers.net',
},
}
# test two sources with the same key
apt::source { 'debian_testing':
location => 'http://debian.mirror.iweb.ca/debian/',
release => 'testing',
repos => 'main contrib non-free',
key => {
id => 'A1BD8E9D78F7FE5C3E65D8AF8B48AD6246925553',
server => 'hkps.pool.sks-keyservers.net',
},
pin => '-10',
}
apt::source { 'debian_unstable':
location => 'http://debian.mirror.iweb.ca/debian/',
release => 'unstable',
repos => 'main contrib non-free',
key => {
id => 'A1BD8E9D78F7FE5C3E65D8AF8B48AD6246925553',
server => 'hkps.pool.sks-keyservers.net',
},
pin => '-10',
}

1
modules/utilities/unix/package_management/apt/examples/unattended_upgrades.pp
View File

@@ -1 +0,0 @@
# TODO

7
modules/utilities/unix/package_management/apt/lib/facter/apt_reboot_required.rb
View File

@@ -1,7 +0,0 @@
# apt_reboot_required.rb
Facter.add(:apt_reboot_required) do
confine osfamily: 'Debian'
setcode do
File.file?('/var/run/reboot-required')
end
end

16
modules/utilities/unix/package_management/apt/lib/facter/apt_update_last_success.rb
View File

@@ -1,16 +0,0 @@
require 'facter'
# This is derived from the file /var/lib/apt/periodic/update-success-stamp
# This is generated upon a successful apt-get update run natively in ubuntu.
# the Puppetlabs-apt module deploys this same functionality for other debian-ish OSes
Facter.add('apt_update_last_success') do
confine osfamily: 'Debian'
setcode do
if File.exist?('/var/lib/apt/periodic/update-success-stamp')
# get epoch time
File.mtime('/var/lib/apt/periodic/update-success-stamp').to_i
else
-1
end
end
end

118
modules/utilities/unix/package_management/apt/lib/facter/apt_updates.rb
View File

@@ -1,118 +0,0 @@
apt_package_updates = nil
apt_dist_updates = nil
# Executes the upgrading of packages
# @param
# upgrade_option Type of upgrade passed into apt-get command arguments i.e. 'upgrade' or 'dist-upgrade'
def get_updates(upgrade_option)
apt_updates = nil
if File.executable?('/usr/bin/apt-get')
apt_get_result = Facter::Util::Resolution.exec("/usr/bin/apt-get -s -o Debug::NoLocking=true #{upgrade_option} 2>&1")
unless apt_get_result.nil?
apt_updates = [[], []]
apt_get_result.each_line do |line|
next unless line =~ %r{^Inst\s}
package = line.gsub(%r{^Inst\s([^\s]+)\s.*}, '\1').strip
apt_updates[0].push(package)
security_matches = [
%r{ Debian-Security:},
%r{ Ubuntu[^\s]+-security[, ]},
%r{ gNewSense[^\s]+-security[, ]},
]
re = Regexp.union(security_matches)
if line.match(re)
apt_updates[1].push(package)
end
end
end
end
setcode do
if !apt_updates.nil? && apt_updates.length == 2
apt_updates != [[], []]
end
end
apt_updates
end
Facter.add('apt_has_updates') do
confine osfamily: 'Debian'
apt_package_updates = get_updates('upgrade')
end
Facter.add('apt_has_dist_updates') do
confine osfamily: 'Debian'
apt_dist_updates = get_updates('dist-upgrade')
end
Facter.add('apt_package_updates') do
confine apt_has_updates: true
setcode do
if Facter.version < '2.0.0'
apt_package_updates[0].join(',')
else
apt_package_updates[0]
end
end
end
Facter.add('apt_package_dist_updates') do
confine apt_has_dist_updates: true
setcode do
if Facter.version < '2.0.0'
apt_dist_updates[0].join(',')
else
apt_dist_updates[0]
end
end
end
Facter.add('apt_package_security_updates') do
confine apt_has_updates: true
setcode do
if Facter.version < '2.0.0'
apt_package_updates[1].join(',')
else
apt_package_updates[1]
end
end
end
Facter.add('apt_package_security_dist_updates') do
confine apt_has_dist_updates: true
setcode do
if Facter.version < '2.0.0'
apt_dist_updates[1].join(',')
else
apt_dist_updates[1]
end
end
end
Facter.add('apt_updates') do
confine apt_has_updates: true
setcode do
Integer(apt_package_updates[0].length)
end
end
Facter.add('apt_dist_updates') do
confine apt_has_dist_updates: true
setcode do
Integer(apt_dist_updates[0].length)
end
end
Facter.add('apt_security_updates') do
confine apt_has_updates: true
setcode do
Integer(apt_package_updates[1].length)
end
end
Facter.add('apt_security_dist_updates') do
confine apt_has_dist_updates: true
setcode do
Integer(apt_dist_updates[1].length)
end
end

261
modules/utilities/unix/package_management/apt/lib/puppet/provider/apt_key/apt_key.rb
View File

@@ -1,261 +0,0 @@
require 'open-uri'
require 'net/ftp'
require 'tempfile'
if RUBY_VERSION == '1.8.7'
# Mothers cry, puppies die and Ruby 1.8.7's open-uri needs to be
# monkeypatched to support passing in :ftp_passive_mode.
require File.expand_path(File.join(File.dirname(__FILE__), '..', '..', '..',
'puppet_x', 'apt_key', 'patch_openuri.rb'))
OpenURI::Options[:ftp_active_mode] = false
end
Puppet::Type.type(:apt_key).provide(:apt_key) do
desc 'apt-key provider for apt_key resource'
confine osfamily: :debian
defaultfor osfamily: :debian
commands apt_key: 'apt-key'
commands gpg: '/usr/bin/gpg'
def self.instances
cli_args = ['adv', '--no-tty', '--list-keys', '--with-colons', '--fingerprint', '--fixed-list-mode']
key_output = apt_key(cli_args).encode('UTF-8', 'binary', invalid: :replace, undef: :replace, replace: '')
pub_line, sub_line, fpr_line = nil
key_array = key_output.split("\n").map do |line|
if line.start_with?('pub')
pub_line = line
# reset fpr_line, to skip any previous subkeys which were collected
fpr_line = nil
sub_line = nil
elsif line.start_with?('sub')
sub_line = line
elsif line.start_with?('fpr')
fpr_line = line
end
if sub_line && fpr_line
sub_line, fpr_line = nil
next
end
next unless pub_line && fpr_line
line_hash = key_line_hash(pub_line, fpr_line)
# reset everything
pub_line, fpr_line = nil
expired = false
if line_hash[:key_expiry]
expired = Time.now >= line_hash[:key_expiry]
end
new(
name: line_hash[:key_fingerprint],
id: line_hash[:key_long],
fingerprint: line_hash[:key_fingerprint],
short: line_hash[:key_short],
long: line_hash[:key_long],
ensure: :present,
expired: expired,
expiry: line_hash[:key_expiry].nil? ? nil : line_hash[:key_expiry].strftime('%Y-%m-%d'),
size: line_hash[:key_size],
type: line_hash[:key_type],
created: line_hash[:key_created].strftime('%Y-%m-%d'),
)
end
key_array.compact!
end
def self.prefetch(resources)
apt_keys = instances
resources.each_key do |name|
if name.length == 40
provider = apt_keys.find { |key| key.fingerprint == name }
resources[name].provider = provider if provider
elsif name.length == 16
provider = apt_keys.find { |key| key.long == name }
resources[name].provider = provider if provider
elsif name.length == 8
provider = apt_keys.find { |key| key.short == name }
resources[name].provider = provider if provider
end
end
end
def self.key_line_hash(pub_line, fpr_line)
pub_split = pub_line.split(':')
fpr_split = fpr_line.split(':')
fingerprint = fpr_split.last
return_hash = {
key_fingerprint: fingerprint,
key_long: fingerprint[-16..-1], # last 16 characters of fingerprint
key_short: fingerprint[-8..-1], # last 8 characters of fingerprint
key_size: pub_split[2],
key_type: nil,
key_created: Time.at(pub_split[5].to_i),
key_expiry: pub_split[6].empty? ? nil : Time.at(pub_split[6].to_i),
}
# set key type based on types defined in /usr/share/doc/gnupg/DETAILS.gz
case pub_split[3]
when '1'
return_hash[:key_type] = :rsa
when '17'
return_hash[:key_type] = :dsa
when '18'
return_hash[:key_type] = :ecc
when '19'
return_hash[:key_type] = :ecdsa
end
return_hash
end
def source_to_file(value)
parsed_value = URI.parse(value)
if parsed_value.scheme.nil?
raise(_('The file %{_value} does not exist') % { _value: value }) unless File.exist?(value)
# Because the tempfile method has to return a live object to prevent GC
# of the underlying file from occuring too early, we also have to return
# a file object here. The caller can still call the #path method on the
# closed file handle to get the path.
f = File.open(value, 'r')
f.close
f
else
begin
# Only send basic auth if URL contains userinfo
# Some webservers (e.g. Amazon S3) return code 400 if empty basic auth is sent
if parsed_value.userinfo.nil?
key = parsed_value.read
else
user_pass = parsed_value.userinfo.split(':')
parsed_value.userinfo = ''
key = open(parsed_value, http_basic_authentication: user_pass).read
end
rescue OpenURI::HTTPError, Net::FTPPermError => e
raise(_('%{_e} for %{_resource}') % { _e: e.message, _resource: resource[:source] })
rescue SocketError
raise(_('could not resolve %{_resource}') % { _resource: resource[:source] })
else
tempfile(key)
end
end
end
# The tempfile method needs to return the tempfile object to the caller, so
# that it doesn't get deleted by the GC immediately after it returns. We
# want the caller to control when it goes out of scope.
def tempfile(content)
file = Tempfile.new('apt_key')
file.write content
file.close
# confirm that the fingerprint from the file, matches the long key that is in the manifest
if name.size == 40
if File.executable? command(:gpg)
extracted_key = execute(["#{command(:gpg)} --no-tty --with-fingerprint --with-colons #{file.path} | awk -F: '/^fpr:/ { print $10 }'"], failonfail: false)
extracted_key = extracted_key.chomp
found_match = false
extracted_key.each_line do |line|
if line.chomp == name
found_match = true
end
end
unless found_match
raise(_('The id in your manifest %{_resource} and the fingerprint from content/source don\'t match. Check for an error in the id and content/source is legitimate.') % { _resource: resource[:name] }) # rubocop:disable Metrics/LineLength
end
else
warning('/usr/bin/gpg cannot be found for verification of the id.')
end
end
file
end
# Update a key if it is expired
def update_expired_key
# Return without doing anything if refresh or expired is false
return unless resource[:refresh] == true && resource[:expired] == true
# Execute command to update key
command = []
unless resource[:source].nil? && resource[:content].nil?
raise(_('an unexpected condition occurred while trying to add the key: %{_resource}') % { _resource: resource[:id] })
end
# Breaking up the command like this is needed because it blows up
# if --recv-keys isn't the last argument.
command.push('adv', '--no-tty', '--keyserver', resource[:server])
unless resource[:options].nil?
command.push('--keyserver-options', resource[:options])
end
command.push('--recv-keys', resource[:id])
end
def exists?
update_expired_key
# report expired keys as non-existing when refresh => true
@property_hash[:ensure] == :present && !(resource[:refresh] && @property_hash[:expired])
end
def create
command = []
if resource[:source].nil? && resource[:content].nil?
# Breaking up the command like this is needed because it blows up
# if --recv-keys isn't the last argument.
command.push('adv', '--no-tty', '--keyserver', resource[:server])
unless resource[:options].nil?
command.push('--keyserver-options', resource[:options])
end
command.push('--recv-keys', resource[:id])
elsif resource[:content]
key_file = tempfile(resource[:content])
command.push('add', key_file.path)
elsif resource[:source]
key_file = source_to_file(resource[:source])
command.push('add', key_file.path)
# In case we really screwed up, better safe than sorry.
else
raise(_('an unexpected condition occurred while trying to add the key: %{_resource}') % { _resource: resource[:id] })
end
apt_key(command)
@property_hash[:ensure] = :present
end
def destroy
loop do
apt_key('del', resource.provider.short)
r = execute(["#{command(:apt_key)} list | grep '/#{resource.provider.short}\s'"], failonfail: false)
break unless r.exitstatus.zero?
end
@property_hash.clear
end
def read_only(_value)
raise(_('This is a read-only property.'))
end
mk_resource_methods
# Needed until PUP-1470 is fixed and we can drop support for Puppet versions
# before that.
def expired
@property_hash[:expired]
end
# Alias the setters of read-only properties
# to the read_only function.
alias_method :created=, :read_only
alias_method :expired=, :read_only
alias_method :expiry=, :read_only
alias_method :size=, :read_only
alias_method :type=, :read_only
end

146
modules/utilities/unix/package_management/apt/lib/puppet/type/apt_key.rb
View File

@@ -1,146 +0,0 @@
require 'pathname'
require 'puppet/parameter/boolean'
Puppet::Type.newtype(:apt_key) do
@doc = <<-MANIFEST
@summary This type provides Puppet with the capabilities to manage GPG keys needed
by apt to perform package validation. Apt has it's own GPG keyring that can
be manipulated through the `apt-key` command.
@example Basic usage
apt_key { '6F6B15509CF8E59E6E469F327F438280EF8D349F':
source => 'http://apt.puppetlabs.com/pubkey.gpg'
}
**Autorequires**
If Puppet is given the location of a key file which looks like an absolute
path this type will autorequire that file.
@api private
MANIFEST
ensurable
validate do
if self[:refresh] == true && self[:ensure] == :absent
raise(_('ensure => absent and refresh => true are mutually exclusive'))
end
if self[:content] && self[:source]
raise(_('The properties content and source are mutually exclusive.'))
end
if self[:id].length < 40
warning(_('The id should be a full fingerprint (40 characters), see README.'))
end
end
newparam(:id, namevar: true) do
desc 'The ID of the key you want to manage.'
# GPG key ID's should be either 32-bit (short) or 64-bit (long) key ID's
# and may start with the optional 0x, or they can be 40-digit key fingerprints
newvalues(%r{\A(0x)?[0-9a-fA-F]{8}\Z}, %r{\A(0x)?[0-9a-fA-F]{16}\Z}, %r{\A(0x)?[0-9a-fA-F]{40}\Z})
munge do |value|
id = if value.start_with?('0x')
value.partition('0x').last.upcase
else
value.upcase
end
id
end
end
newparam(:content) do
desc 'The content of, or string representing, a GPG key.'
end
newparam(:source) do
desc 'Location of a GPG key file, /path/to/file, ftp://, http:// or https://'
newvalues(%r{\Ahttps?://}, %r{\Aftp://}, %r{\A/\w+})
end
autorequire(:file) do
if self[:source] && Pathname.new(self[:source]).absolute?
self[:source]
end
end
newparam(:server) do
desc 'The key server to fetch the key from based on the ID. It can either be a domain name or url.'
defaultto :'keyserver.ubuntu.com'
newvalues(%r{\A((hkp|hkps|http|https)://)?([a-z\d])([a-z\d-]{0,61}\.)+[a-z\d]+(:\d{2,5})?$})
end
newparam(:options) do
desc 'Additional options to pass to apt-key\'s --keyserver-options.'
end
newparam(:refresh, boolean: true, parent: Puppet::Parameter::Boolean) do
desc 'When true, recreate an existing expired key'
defaultto false
end
newproperty(:fingerprint) do
desc <<-MANIFEST
The 40-digit hexadecimal fingerprint of the specified GPG key.
This property is read-only.
MANIFEST
end
newproperty(:long) do
desc <<-MANIFEST
The 16-digit hexadecimal id of the specified GPG key.
This property is read-only.
MANIFEST
end
newproperty(:short) do
desc <<-MANIFEST
The 8-digit hexadecimal id of the specified GPG key.
This property is read-only.
MANIFEST
end
newproperty(:expired) do
desc <<-MANIFEST
Indicates if the key has expired.
This property is read-only.
MANIFEST
end
newproperty(:expiry) do
desc <<-MANIFEST
The date the key will expire, or nil if it has no expiry date.
This property is read-only.
MANIFEST
end
newproperty(:size) do
desc <<-MANIFEST
The key size, usually a multiple of 1024.
This property is read-only.
MANIFEST
end
newproperty(:type) do
desc <<-MANIFEST
The key type, one of: rsa, dsa, ecc, ecdsa
This property is read-only.
MANIFEST
end
newproperty(:created) do
desc <<-MANIFEST
Date the key was created.
This property is read-only.
MANIFEST
end
end

26
modules/utilities/unix/package_management/apt/locales/config.yaml
View File

@@ -1,26 +0,0 @@
---
# This is the project-specific configuration file for setting up
# fast_gettext for your project.
gettext:
# This is used for the name of the .pot and .po files; they will be
# called <project_name>.pot?
project_name: puppetlabs-apt
# This is used in comments in the .pot and .po files to indicate what
# project the files belong to and should bea little more desctiptive than
# <project_name>
package_name: puppetlabs-apt
# The locale that the default messages in the .pot file are in
default_locale: en
# The email used for sending bug reports.
bugs_address: docs@puppet.com
# The holder of the copyright.
copyright_holder: Puppet, Inc.
# This determines which comments in code should be eligible for translation.
# Any comments that start with this string will be externalized. (Leave
# empty to include all.)
comments_tag: TRANSLATOR
# Patterns for +Dir.glob+ used to find all files that might contain
# translatable content, relative to the project root directory
source_files:
- './lib/**/*.rb'

155
modules/utilities/unix/package_management/apt/locales/ja/puppetlabs-apt.po
View File

@@ -1,155 +0,0 @@
# #-#-#-#-# puppetlabs-apt.pot (puppetlabs-apt 6.0.0-27-gbb0f842) #-#-#-#-#
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2018 Puppet, Inc.
# This file is distributed under the same license as the puppetlabs-apt package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2018.
#
# #-#-#-#-# puppetlabs-apt_metadata.pot (PACKAGE VERSION) #-#-#-#-#
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: PACKAGE VERSION\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2018-09-21T09:17:39+01:00\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: Eriko Kashiwagi <eriko.55@d5.dion.ne.jp>, 2018\n"
"Language-Team: Japanese (Japan) (https://www.transifex.com/puppet/teams/41915/ja_JP/)\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Language: ja_JP\n"
"Plural-Forms: nplurals=1; plural=0;\n"
"X-Generator: Translate Toolkit 2.0.0\n"
#. ./manifests/backports.pp:69
msgid ""
"If not on Debian or Ubuntu, you must explicitly pass location, release, "
"repos, and key"
msgstr "DebianまたはUbuntu以外の場合、場所、リリース、リポジトリ、およびキーを明示的に渡す必要があります。"
#. ./manifests/backports.pp:95
msgid "pin must be either a string, number or hash"
msgstr "pinは、文字列、数値またはハッシュのいずれかである必要があります。"
#. ./manifests/conf.pp:25
msgid "Need to pass in content parameter"
msgstr "contentパラメータを渡す必要があります。"
#. ./manifests/init.pp:143 ./manifests/params.pp:8
msgid "This module only works on Debian or derivatives like Ubuntu"
msgstr "本モジュールは、DebianまたはUbuntuなどの派生OSでのみ動作します。"
#. ./manifests/key.pp:47
msgid "key with id %{_id} already ensured as absent"
msgstr "id %{_id}のキーは、存在しないことが既に確認されています。"
#. ./manifests/key.pp:81
msgid "key with id %{_id} already ensured as present"
msgstr "id %{_id}のキーは、存在することが既に確認されています。"
#. ./manifests/key.pp:97
msgid "Invalid 'ensure' value '%{_ensure}' for apt::key"
msgstr "apt::keyの'%{_ensure}'の'ensure'の値が無効です。"
#. ./manifests/params.pp:100
msgid "Unable to determine value for fact os[\"name\"]"
msgstr "fact os[\"name\"]の値を特定できません。"
#. ./manifests/pin.pp:84
msgid "parameters release, origin, and version are mutually exclusive"
msgstr "パラメータrelease、origin、versionは相互に排他的です。"
#. ./manifests/pin.pp:88
msgid "parameter version cannot be used in general form"
msgstr "パラメータのバージョンは、一般的な形式では使用できません"
#. ./manifests/pin.pp:91
msgid "parameters release and origin are mutually exclusive"
msgstr "パラメータreleaseとoriginは相互に排他的です。"
#. ./manifests/ppa.pp:30 ./manifests/source.pp:79
msgid "lsbdistcodename fact not available: release parameter required"
msgstr "lsbdistcodenameのfactが使用できません。releaseパラメータが必要です。"
#. ./manifests/ppa.pp:34
msgid "apt::ppa is not currently supported on Debian."
msgstr "apt::ppaは、現在Debianではサポートされていません。"
#. ./manifests/setting.pp:31
msgid "apt::setting cannot have both content and source"
msgstr "apt::settingがcontentとsourceの両方を持つことはできません。"
#. ./manifests/setting.pp:35
msgid "apt::setting needs either of content or source"
msgstr "apt::settingには、contentまたはsourceのいずれかが必要です。"
#. ./manifests/setting.pp:43
msgid ""
"apt::setting resource name/title must start with either 'conf-', 'pref-' or "
"'list-'"
msgstr "apt::settingのリソース名/タイトルの先頭は、'conf-'、'pref-'、'list-'にする必要があります。"
#. ./manifests/setting.pp:49
msgid "apt::setting priority must be an integer or a zero-padded integer"
msgstr "apt::settingのpriorityは、整数またはゼロパディングされた整数にする必要があります。"
#. ./manifests/source.pp:87
msgid "cannot create a source entry without specifying a location"
msgstr "場所を指定せずにソースエントリを作成することはできません。"
#. ./manifests/source.pp:101
msgid "key hash must contain at least an id entry"
msgstr "キーハッシュには、少なくともidエントリを含める必要があります。"
#. ./manifests/source.pp:140
msgid "Received invalid value for pin parameter"
msgstr "pinパラメータに無効な値を受信しました。"
#: ../lib/puppet/provider/apt_key/apt_key.rb:124
msgid "The file %{_value} does not exist"
msgstr "ファイル%{_value}が存在しません。"
#: ../lib/puppet/provider/apt_key/apt_key.rb:144
msgid "%{_e} for %{_resource}"
msgstr "%{_resource}の%{_e}"
#: ../lib/puppet/provider/apt_key/apt_key.rb:146
msgid "could not resolve %{_resource}"
msgstr "%{_resource}を解決できませんでした。"
#: ../lib/puppet/provider/apt_key/apt_key.rb:173
msgid ""
"The id in your manifest %{_resource} and the fingerprint from content/source"
" don't match. Check for an error in the id and content/source is legitimate."
msgstr ""
"マニフェスト%{_resource}に含まれるidと、content/sourceのフィンガープリントが一致しません。idに間違いがないか、content/sourceが正当であるかを確認してください。"
#: ../lib/puppet/provider/apt_key/apt_key.rb:191
#: ../lib/puppet/provider/apt_key/apt_key.rb:227
msgid ""
"an unexpected condition occurred while trying to add the key: %{_resource}"
msgstr "キー%{_resource}の追加中に、予期しない状況が発生しました。"
#: ../lib/puppet/provider/apt_key/apt_key.rb:243
msgid "This is a read-only property."
msgstr "これは、読み込み専用のプロパティです。"
#: ../lib/puppet/type/apt_key.rb:27
msgid "ensure => absent and refresh => true are mutually exclusive"
msgstr "ensure => absentとrefresh => trueは相互に排他的です。"
#: ../lib/puppet/type/apt_key.rb:30
msgid "The properties content and source are mutually exclusive."
msgstr "プロパティcontentとsourceは相互に排他的です。 are mutually exclusive."
#: ../lib/puppet/type/apt_key.rb:33
msgid "The id should be a full fingerprint (40 characters), see README."
msgstr "idは完全なフィンガープリント(40文字)である必要があります。READMEを参照してください。"
#. metadata.json
#: .summary
msgid ""
"Provides an interface for managing Apt source, key, and definitions with "
"Puppet"
msgstr "Aptソース、キー、および定義をPuppetで管理するためのインターフェースを提供します。"

177
modules/utilities/unix/package_management/apt/locales/puppetlabs-apt.pot
View File

@@ -1,177 +0,0 @@
# #-#-#-#-# puppetlabs-apt.pot (puppetlabs-apt 6.0.0-27-gbb0f842) #-#-#-#-#
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2018 Puppet, Inc.
# This file is distributed under the same license as the puppetlabs-apt package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2018.
#
# #-#-#-#-# puppetlabs-apt_metadata.pot (PACKAGE VERSION) #-#-#-#-#
#
#, fuzzy
msgid ""
msgstr ""
"#-#-#-#-# puppet.pot (PACKAGE VERSION) #-#-#-#-#\n"
"Project-Id-Version: PACKAGE VERSION\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2018-09-21 09:17:33 +0100\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"X-Generator: Translate Toolkit 2.0.0\n"
"#-#-#-#-# puppetlabs-apt.pot (puppetlabs-apt 6.0.0-27-gbb0f842) #-#-#-#-#\n"
"Project-Id-Version: puppetlabs-apt 6.0.0-27-gbb0f842\n"
"\n"
"Report-Msgid-Bugs-To: docs@puppet.com\n"
"POT-Creation-Date: 2018-09-21 09:27+0100\n"
"PO-Revision-Date: 2018-09-21 09:27+0100\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"Language: \n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Plural-Forms: nplurals=INTEGER; plural=EXPRESSION;\n"
"#-#-#-#-# puppetlabs-apt_metadata.pot (PACKAGE VERSION) #-#-#-#-#\n"
"Project-Id-Version: PACKAGE VERSION\n"
"Report-Msgid-Bugs-To:\n"
"POT-Creation-Date: 2018-09-21T09:17:39+01:00\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"X-Generator: Translate Toolkit 2.0.0\n"
#. ./manifests/backports.pp:69
msgid ""
"If not on Debian or Ubuntu, you must explicitly pass location, release, "
"repos, and key"
msgstr ""
#. ./manifests/backports.pp:95
msgid "pin must be either a string, number or hash"
msgstr ""
#. ./manifests/conf.pp:25
msgid "Need to pass in content parameter"
msgstr ""
#. ./manifests/init.pp:143 ./manifests/params.pp:8
msgid "This module only works on Debian or derivatives like Ubuntu"
msgstr ""
#. ./manifests/key.pp:47
msgid "key with id %{_id} already ensured as absent"
msgstr ""
#. ./manifests/key.pp:81
msgid "key with id %{_id} already ensured as present"
msgstr ""
#. ./manifests/key.pp:97
msgid "Invalid 'ensure' value '%{_ensure}' for apt::key"
msgstr ""
#. ./manifests/params.pp:100
msgid "Unable to determine value for fact os[\"name\"]"
msgstr ""
#. ./manifests/pin.pp:84
msgid "parameters release, origin, and version are mutually exclusive"
msgstr ""
#. ./manifests/pin.pp:88
msgid "parameter version cannot be used in general form"
msgstr ""
#. ./manifests/pin.pp:91
msgid "parameters release and origin are mutually exclusive"
msgstr ""
#. ./manifests/ppa.pp:30 ./manifests/source.pp:79
msgid "lsbdistcodename fact not available: release parameter required"
msgstr ""
#. ./manifests/ppa.pp:34
msgid "apt::ppa is not currently supported on Debian."
msgstr ""
#. ./manifests/setting.pp:31
msgid "apt::setting cannot have both content and source"
msgstr ""
#. ./manifests/setting.pp:35
msgid "apt::setting needs either of content or source"
msgstr ""
#. ./manifests/setting.pp:43
msgid ""
"apt::setting resource name/title must start with either 'conf-', 'pref-' or "
"'list-'"
msgstr ""
#. ./manifests/setting.pp:49
msgid "apt::setting priority must be an integer or a zero-padded integer"
msgstr ""
#. ./manifests/source.pp:87
msgid "cannot create a source entry without specifying a location"
msgstr ""
#. ./manifests/source.pp:101
msgid "key hash must contain at least an id entry"
msgstr ""
#. ./manifests/source.pp:140
msgid "Received invalid value for pin parameter"
msgstr ""
#: ../lib/puppet/provider/apt_key/apt_key.rb:124
msgid "The file %{_value} does not exist"
msgstr ""
#: ../lib/puppet/provider/apt_key/apt_key.rb:144
msgid "%{_e} for %{_resource}"
msgstr ""
#: ../lib/puppet/provider/apt_key/apt_key.rb:146
msgid "could not resolve %{_resource}"
msgstr ""
#: ../lib/puppet/provider/apt_key/apt_key.rb:173
msgid ""
"The id in your manifest %{_resource} and the fingerprint from content/source "
"don't match. Check for an error in the id and content/source is legitimate."
msgstr ""
#: ../lib/puppet/provider/apt_key/apt_key.rb:191
#: ../lib/puppet/provider/apt_key/apt_key.rb:227
msgid ""
"an unexpected condition occurred while trying to add the key: %{_resource}"
msgstr ""
#: ../lib/puppet/provider/apt_key/apt_key.rb:243
msgid "This is a read-only property."
msgstr ""
#: ../lib/puppet/type/apt_key.rb:27
msgid "ensure => absent and refresh => true are mutually exclusive"
msgstr ""
#: ../lib/puppet/type/apt_key.rb:30
msgid "The properties content and source are mutually exclusive."
msgstr ""
#: ../lib/puppet/type/apt_key.rb:33
msgid "The id should be a full fingerprint (40 characters), see README."
msgstr ""
#. metadata.json
#: .summary
msgid ""
"Provides an interface for managing Apt source, key, and definitions with "
"Puppet"
msgstr ""

105
modules/utilities/unix/package_management/apt/manifests/backports.pp
View File

@@ -1,105 +0,0 @@
# @summary Manages backports.
#
# @example Set up a backport for linuxmint qiana
# apt::backports { 'qiana':
# location => 'http://us.archive.ubuntu.com/ubuntu',
# release => 'trusty-backports',
# repos => 'main universe multiverse restricted',
# key => {
# id => '630239CC130E1A7FD81A27B140976EAF437D05B5',
# server => 'hkps.pool.sks-keyservers.net',
# },
# }
#
# @param location
# Specifies an Apt repository containing the backports to manage. Valid options: a string containing a URL. Default value for Debian and
# Ubuntu varies:
#
# - Debian: 'http://deb.debian.org/debian'
#
# - Ubuntu: 'http://archive.ubuntu.com/ubuntu'
#
# @param release
# Specifies a distribution of the Apt repository containing the backports to manage. 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.
#
# @param repos
# Specifies a component of the Apt repository containing the backports to manage. Used in populating the `source.list` configuration file.
# Default value for Debian and Ubuntu varies:
#
# - Debian: 'main contrib non-free'
#
# - Ubuntu: 'main universe multiverse restricted'
#
# @param 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. Default value
# for Debian and Ubuntu varies:
#
# - Debian: 'A1BD8E9D78F7FE5C3E65D8AF8B48AD6246925553'
#
# - Ubuntu: '630239CC130E1A7FD81A27B140976EAF437D05B5'
#
# @param pin
# 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.
#
class apt::backports (
Optional[String] $location = undef,
Optional[String] $release = undef,
Optional[String] $repos = undef,
Optional[Variant[String, Hash]] $key = undef,
Optional[Variant[Integer, String, Hash]] $pin = 200,
){
if $location {
$_location = $location
}
if $release {
$_release = $release
}
if $repos {
$_repos = $repos
}
if $key {
$_key = $key
}
if (!($facts['lsbdistid'] == 'Debian' or $facts['lsbdistid'] == 'Ubuntu')) {
unless $location and $release and $repos and $key {
fail(translate('If not on Debian or Ubuntu, you must explicitly pass location, release, repos, and key'))
}
}
unless $location {
$_location = $::apt::backports['location']
}
unless $release {
$_release = "${facts['lsbdistcodename']}-backports"
}
unless $repos {
$_repos = $::apt::backports['repos']
}
unless $key {
$_key = $::apt::backports['key']
}
if $pin =~ Hash {
$_pin = $pin
} elsif $pin =~ Numeric or $pin =~ String {
# apt::source defaults to pinning to origin, but we should pin to release
# for backports
$_pin = {
'priority' => $pin,
'release' => $_release,
}
} else {
fail(translate('pin must be either a string, number or hash'))
}
apt::source { 'backports':
location => $_location,
release => $_release,
repos => $_repos,
key => $_key,
pin => $_pin,
}
}

36
modules/utilities/unix/package_management/apt/manifests/conf.pp
View File

@@ -1,36 +0,0 @@
# @summary Specifies a custom Apt configuration file.
#
# @param content
# Required unless `ensure` is set to 'absent'. Directly supplies content for the configuration file.
#
# @param ensure
# Specifies whether the configuration file should exist. Valid options: 'present' and 'absent'.
#
# @param priority
# 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 or an integer.
#
# @param notify_update
# Specifies whether to trigger an `apt-get update` run.
#
define apt::conf (
Optional[String] $content = undef,
Enum['present', 'absent'] $ensure = present,
Variant[String, Integer] $priority = 50,
Optional[Boolean] $notify_update = undef,
) {
unless $ensure == 'absent' {
unless $content {
fail(translate('Need to pass in content parameter'))
}
}
$confheadertmp = epp('apt/_conf_header.epp')
apt::setting { "conf-${name}":
ensure => $ensure,
priority => $priority,
content => "${confheadertmp}${content}",
notify_update => $notify_update,
}
}

295
modules/utilities/unix/package_management/apt/manifests/init.pp
View File

@@ -1,295 +0,0 @@
# @summary Main class, includes all other classes.
#
# @see https://docs.puppetlabs.com/references/latest/function.html#createresources for the create resource function
#
# @param provider
# Specifies the provider that should be used by apt::update.
#
# @param keyserver
# Specifies a keyserver to provide the GPG key. Valid options: a string containing a domain name or a full URL (http://, https://, or
# hkp://).
#
# @param ppa_options
# Supplies options to be passed to the `add-apt-repository` command.
#
# @param ppa_package
# Names the package that provides the `apt-add-repository` command.
#
# @param backports
# Specifies some of the default parameters used by apt::backports. Valid options: a hash made up from the following keys:
#
# @option backports [String] :location
# See apt::backports for documentation.
#
# @option backports [String] :repos
# See apt::backports for documentation.
#
# @option backports [String] :key
# See apt::backports for documentation.
#
# @param confs
# Creates new `apt::conf` resources. Valid options: a hash to be passed to the create_resources function linked above.
#
# @param update
# Configures various update settings. Valid options: a hash made up from the following keys:
#
# @option update [String] :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'.
#
# @option update [Integer] :loglevel
# Specifies the log level of logs outputted to the console. Default: undef.
#
# @option update [Integer] :timeout
# Specifies how long to wait for the update to complete before canceling it. Valid options: an integer, in seconds. Default: undef.
#
# @option update [Integer] :tries
# Specifies how many times to retry the update after receiving a DNS or HTTP error. Default: undef.
#
# @param purge
# Specifies whether to purge any existing settings that aren't managed by Puppet. Valid options: a hash made up from the following keys:
#
# @option purge [Boolean] :sources.list
# Specifies whether to purge any unmanaged entries from sources.list. Default false.
#
# @option purge [Boolean] :sources.list.d
# Specifies whether to purge any unmanaged entries from sources.list.d. Default false.
#
# @option purge [Boolean] :preferences
# Specifies whether to purge any unmanaged entries from preferences. Default false.
#
# @option purge [Boolean] :preferences.d.
# Specifies whether to purge any unmanaged entries from preferences.d. Default false.
#
# @param proxy
# Configures Apt to connect to a proxy server. Valid options: a hash matching the locally defined type apt::proxy.
#
# @param sources
# Creates new `apt::source` resources. Valid options: a hash to be passed to the create_resources function linked above.
#
# @param keys
# Creates new `apt::key` resources. Valid options: a hash to be passed to the create_resources function linked above.
#
# @param ppas
# Creates new `apt::ppa` resources. Valid options: a hash to be passed to the create_resources function linked above.
#
# @param pins
# Creates new `apt::pin` resources. Valid options: a hash to be passed to the create_resources function linked above.
#
# @param settings
# Creates new `apt::setting` resources. Valid options: a hash to be passed to the create_resources function linked above.
#
# @param auth_conf_entries
# An optional array of login configuration settings (hashes) that are recorded in the file /etc/apt/auth.conf. This file has a netrc-like
# format (similar to what curl uses) and contains the login configuration for APT sources and proxies that require authentication. See
# https://manpages.debian.org/testing/apt/apt_auth.conf.5.en.html for details. If specified each hash must contain the keys machine, login and
# password and no others.
#
# @param root
# Specifies root directory of Apt executable.
#
# @param sources_list
# Specifies the path of the sources_list file to use.
#
# @param sources_list_d
# Specifies the path of the sources_list.d file to use.
#
# @param conf_d
# Specifies the path of the conf.d file to use.
#
# @param preferences
# Specifies the path of the preferences file to use.
#
# @param preferences_d
# Specifies the path of the preferences.d file to use.
#
# @param config_files
# A hash made up of the various configuration files used by Apt.
#
class apt (
Hash $update_defaults = $apt::params::update_defaults,
Hash $purge_defaults = $apt::params::purge_defaults,
Hash $proxy_defaults = $apt::params::proxy_defaults,
Hash $include_defaults = $apt::params::include_defaults,
String $provider = $apt::params::provider,
String $keyserver = $apt::params::keyserver,
Optional[String] $ppa_options = $apt::params::ppa_options,
Optional[String] $ppa_package = $apt::params::ppa_package,
Optional[Hash] $backports = $apt::params::backports,
Hash $confs = $apt::params::confs,
Hash $update = $apt::params::update,
Hash $purge = $apt::params::purge,
Apt::Proxy $proxy = $apt::params::proxy,
Hash $sources = $apt::params::sources,
Hash $keys = $apt::params::keys,
Hash $ppas = $apt::params::ppas,
Hash $pins = $apt::params::pins,
Hash $settings = $apt::params::settings,
Array[Apt::Auth_conf_entry]
$auth_conf_entries = $apt::params::auth_conf_entries,
String $root = $apt::params::root,
String $sources_list = $apt::params::sources_list,
String $sources_list_d = $apt::params::sources_list_d,
String $conf_d = $apt::params::conf_d,
String $preferences = $apt::params::preferences,
String $preferences_d = $apt::params::preferences_d,
Hash $config_files = $apt::params::config_files,
Hash $source_key_defaults = $apt::params::source_key_defaults,
) inherits apt::params {
if $facts['osfamily'] != 'Debian' {
fail(translate('This module only works on Debian or derivatives like Ubuntu'))
}
if $update['frequency'] {
assert_type(
Enum['always','daily','weekly','reluctantly'],
$update['frequency'],
)
}
if $update['timeout'] {
assert_type(Integer, $update['timeout'])
}
if $update['tries'] {
assert_type(Integer, $update['tries'])
}
$_update = merge($::apt::update_defaults, $update)
include ::apt::update
if $purge['sources.list'] {
assert_type(Boolean, $purge['sources.list'])
}
if $purge['sources.list.d'] {
assert_type(Boolean, $purge['sources.list.d'])
}
if $purge['preferences'] {
assert_type(Boolean, $purge['preferences'])
}
if $purge['preferences.d'] {
assert_type(Boolean, $purge['preferences.d'])
}
$_purge = merge($::apt::purge_defaults, $purge)
$_proxy = merge($apt::proxy_defaults, $proxy)
$confheadertmp = epp('apt/_conf_header.epp')
$proxytmp = epp('apt/proxy.epp', {'proxies' => $_proxy})
$updatestamptmp = epp('apt/15update-stamp.epp')
if $_proxy['ensure'] == 'absent' or $_proxy['host'] {
apt::setting { 'conf-proxy':
ensure => $_proxy['ensure'],
priority => '01',
content => "${confheadertmp}${proxytmp}",
}
}
$sources_list_content = $_purge['sources.list'] ? {
true => "# Repos managed by puppet.\n",
default => undef,
}
$preferences_ensure = $_purge['preferences'] ? {
true => absent,
default => file,
}
if $_update['frequency'] == 'always' {
Exec <| title=='apt_update' |> {
refreshonly => false,
}
}
apt::setting { 'conf-update-stamp':
priority => 15,
content => "${confheadertmp}${updatestamptmp}",
}
file { 'sources.list':
ensure => file,
path => $::apt::sources_list,
owner => root,
group => root,
mode => '0644',
content => $sources_list_content,
notify => Class['apt::update'],
}
file { 'sources.list.d':
ensure => directory,
path => $::apt::sources_list_d,
owner => root,
group => root,
mode => '0644',
purge => $_purge['sources.list.d'],
recurse => $_purge['sources.list.d'],
notify => Class['apt::update'],
}
file { 'preferences':
ensure => $preferences_ensure,
path => $::apt::preferences,
owner => root,
group => root,
mode => '0644',
notify => Class['apt::update'],
}
file { 'preferences.d':
ensure => directory,
path => $::apt::preferences_d,
owner => root,
group => root,
mode => '0644',
purge => $_purge['preferences.d'],
recurse => $_purge['preferences.d'],
notify => Class['apt::update'],
}
if $confs {
create_resources('apt::conf', $confs)
}
# manage sources if present
if $sources {
create_resources('apt::source', $sources)
}
# manage keys if present
if $keys {
create_resources('apt::key', $keys)
}
# manage ppas if present
if $ppas {
create_resources('apt::ppa', $ppas)
}
# manage settings if present
if $settings {
create_resources('apt::setting', $settings)
}
$auth_conf_ensure = $auth_conf_entries ? {
[] => 'absent',
default => 'present',
}
$auth_conf_tmp = epp('apt/auth_conf.epp')
file { '/etc/apt/auth.conf':
ensure => $auth_conf_ensure,
owner => 'root',
group => 'root',
mode => '0600',
content => "${confheadertmp}${auth_conf_tmp}",
notify => Class['apt::update'],
}
# manage pins if present
if $pins {
create_resources('apt::pin', $pins)
}
# required for adding GPG keys on Debian 9 (and derivatives)
ensure_packages(['dirmngr'])
}

100
modules/utilities/unix/package_management/apt/manifests/key.pp
View File

@@ -1,100 +0,0 @@
# @summary Manages the GPG keys that Apt uses to authenticate packages.
#
# @note
# The apt::key defined type makes use of the apt_key type, but includes extra functionality to help prevent duplicate keys.
#
# @example Declare Apt key for apt.puppetlabs.com source
# apt::key { 'puppetlabs':
# id => '6F6B15509CF8E59E6E469F327F438280EF8D349F',
# server => 'hkps.pool.sks-keyservers.net',
# options => 'http-proxy="http://proxyuser:proxypass@example.org:3128"',
# }
#
# @param 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).
#
# @param ensure
# Specifies whether the key should exist. Valid options: 'present', 'absent' or 'refreshed'. Using 'refreshed' will make keys auto
# update when they have expired (assuming a new key exists on the key server).
#
# @param 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.
#
# @param 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.
#
# @param server
# Specifies a keyserver to provide the GPG key. Valid options: a string containing a domain name or a full URL (http://, https://,
# hkp:// or hkps://). The hkps:// protocol is currently only supported on Ubuntu 18.04.
#
# @param options
# Passes additional options to `apt-key adv --keyserver-options`.
#
define apt::key (
Pattern[/\A(0x)?[0-9a-fA-F]{8}\Z/, /\A(0x)?[0-9a-fA-F]{16}\Z/, /\A(0x)?[0-9a-fA-F]{40}\Z/] $id = $title,
Enum['present', 'absent', 'refreshed'] $ensure = present,
Optional[String] $content = undef,
Optional[Pattern[/\Ahttps?:\/\//, /\Aftp:\/\//, /\A\/\w+/]] $source = undef,
Pattern[/\A((hkp|hkps|http|https):\/\/)?([a-z\d])([a-z\d-]{0,61}\.)+[a-z\d]+(:\d{2,5})?$/] $server = $::apt::keyserver,
Optional[String] $options = undef,
) {
case $ensure {
/^(refreshed|present)$/: {
if defined(Anchor["apt_key ${id} absent"]){
fail(translate('key with id %{_id} already ensured as absent'), {'_id' => id})
}
if !defined(Anchor["apt_key ${id} present"]) {
apt_key { $title:
ensure => present,
refresh => $ensure == 'refreshed',
id => $id,
source => $source,
content => $content,
server => $server,
options => $options,
} -> anchor { "apt_key ${id} present": }
case $facts['os']['name'] {
'Debian': {
if versioncmp($facts['os']['release']['major'], '9') >= 0 {
ensure_packages(['dirmngr'])
Apt::Key<| title == $title |>
}
}
'Ubuntu': {
if versioncmp($facts['os']['release']['full'], '17.04') >= 0 {
ensure_packages(['dirmngr'])
Apt::Key<| title == $title |>
}
}
default: { }
}
}
}
absent: {
if defined(Anchor["apt_key ${id} present"]){
fail(translate('key with id %{_id} already ensured as present', {'_id' => id}))
}
if !defined(Anchor["apt_key ${id} absent"]){
apt_key { $title:
ensure => $ensure,
id => $id,
source => $source,
content => $content,
server => $server,
options => $options,
} -> anchor { "apt_key ${id} absent": }
}
}
default: {
fail translate('Invalid \'ensure\' value \'%{_ensure}\' for apt::key', {'_ensure' => ensure})
}
}
}

108
modules/utilities/unix/package_management/apt/manifests/params.pp
View File

@@ -1,108 +0,0 @@
# @summary Provides defaults for the Apt module parameters.
#
# @api private
#
class apt::params {
if $::osfamily != 'Debian' {
fail(translate('This module only works on Debian or derivatives like Ubuntu'))
}
$root = '/etc/apt'
$provider = '/usr/bin/apt-get'
$sources_list = "${root}/sources.list"
$sources_list_d = "${root}/sources.list.d"
$trusted_gpg_d = "${root}/trusted.gpg.d"
$conf_d = "${root}/apt.conf.d"
$preferences = "${root}/preferences"
$preferences_d = "${root}/preferences.d"
$keyserver = 'keyserver.ubuntu.com'
$confs = {}
$update = {}
$purge = {}
$proxy = {}
$sources = {}
$keys = {}
$ppas = {}
$pins = {}
$settings = {}
$auth_conf_entries = []
$config_files = {
'conf' => {
'path' => $conf_d,
'ext' => '',
},
'pref' => {
'path' => $preferences_d,
'ext' => '.pref',
},
'list' => {
'path' => $sources_list_d,
'ext' => '.list',
}
}
$update_defaults = {
'frequency' => 'reluctantly',
'loglevel' => undef,
'timeout' => undef,
'tries' => undef,
}
$proxy_defaults = {
'ensure' => undef,
'host' => undef,
'port' => 8080,
'https' => false,
'direct' => false,
}
$purge_defaults = {
'sources.list' => false,
'sources.list.d' => false,
'preferences' => false,
'preferences.d' => false,
}
$source_key_defaults = {
'server' => $keyserver,
'options' => undef,
'content' => undef,
'source' => undef,
}
$include_defaults = {
'deb' => true,
'src' => false,
}
case $facts['os']['name']{
'Debian': {
$backports = {
'location' => 'http://deb.debian.org/debian',
'key' => 'A1BD8E9D78F7FE5C3E65D8AF8B48AD6246925553',
'repos' => 'main contrib non-free',
}
$ppa_options = undef
$ppa_package = undef
}
'Ubuntu': {
$backports = {
'location' => 'http://archive.ubuntu.com/ubuntu',
'key' => '630239CC130E1A7FD81A27B140976EAF437D05B5',
'repos' => 'main universe multiverse restricted',
}
$ppa_options = '-y'
$ppa_package = 'software-properties-common'
}
undef: {
fail(translate('Unable to determine value for fact os[\"name\"]'))
}
default: {
$ppa_options = undef
$ppa_package = undef
$backports = undef
}
}
}

128
modules/utilities/unix/package_management/apt/manifests/pin.pp
View File

@@ -1,128 +0,0 @@
# @summary Manages Apt pins. Does not trigger an apt-get update run.
#
# @see http://linux.die.net/man/5/apt_preferences for context on these parameters
#
# @param ensure
# Specifies whether the pin should exist. Valid options: 'file', 'present', and 'absent'.
#
# @param explanation
# Supplies a comment to explain the pin. Default: "${caller_module_name}: ${name}".
#
# @param order
# Determines the order in which Apt processes the pin file. Files with lower order numbers are loaded first.
#
# @param packages
# Specifies which package(s) to pin.
#
# @param 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.
#
# @param release
# Tells APT to prefer packages that support the specified release. Typical values include 'stable', 'testing', and 'unstable'.
#
# @param release_version
# Tells APT to prefer packages that support the specified operating system release version (such as Debian release version 7).
#
# @param component
# Names the licensing component associated with the packages in the directory tree of the Release file.
#
# @param originator
# Names the originator of the packages in the directory tree of the Release file.
#
# @param label
# Names the label of the packages in the directory tree of the Release file.
#
define apt::pin(
Optional[Enum['file', 'present', 'absent']] $ensure = present,
Optional[String] $explanation = undef,
Variant[Integer] $order = 50,
Variant[String, Array] $packages = '*',
Variant[Numeric, String] $priority = 0,
Optional[String] $release = '', # a=
Optional[String] $origin = '',
Optional[String] $version = '',
Optional[String] $codename = '', # n=
Optional[String] $release_version = '', # v=
Optional[String] $component = '', # c=
Optional[String] $originator = '', # o=
Optional[String] $label = '', # l=
) {
if $explanation {
$_explanation = $explanation
} else {
if defined('$caller_module_name') { # strict vars check
$_explanation = "${caller_module_name}: ${name}"
} else {
$_explanation = ": ${name}"
}
}
$pin_release_array = [
$release,
$codename,
$release_version,
$component,
$originator,
$label,
]
$pin_release = join($pin_release_array, '')
# Read the manpage 'apt_preferences(5)', especially the chapter
# 'The Effect of APT Preferences' to understand the following logic
# and the difference between specific and general form
if $packages =~ Array {
$packages_string = join($packages, ' ')
} else {
$packages_string = $packages
}
if $packages_string != '*' { # specific form
if ( $pin_release != '' and ( $origin != '' or $version != '' )) or
( $version != '' and ( $pin_release != '' or $origin != '' )) {
fail(translate('parameters release, origin, and version are mutually exclusive'))
}
} else { # general form
if $version != '' {
fail(translate('parameter version cannot be used in general form'))
}
if ( $pin_release != '' and $origin != '' ) {
fail(translate('parameters release and origin are mutually exclusive'))
}
}
# According to man 5 apt_preferences:
# The files have either no or "pref" as filename extension
# and only contain alphanumeric, hyphen (-), underscore (_) and period
# (.) characters. Otherwise APT will print a notice that it has ignored a
# file, unless that file matches a pattern in the
# Dir::Ignore-Files-Silently configuration list - in which case it will
# be silently ignored.
$file_name = regsubst($title, '[^0-9a-z\-_\.]', '_', 'IG')
$headertmp = epp('apt/_header.epp')
$pinpreftmp = epp('apt/pin.pref.epp', {
'name' => $name,
'pin_release' => $pin_release,
'release' => $release,
'codename' => $codename,
'release_version' => $release_version,
'component' => $component,
'originator' => $originator,
'label' => $label,
'version' => $version,
'origin' => $origin,
'explanation' => $_explanation,
'packages_string' => $packages_string,
'priority' => $priority,
})
apt::setting { "pref-${file_name}":
ensure => $ensure,
priority => $order,
content => "${headertmp}${pinpreftmp}",
notify_update => false,
}
}

99
modules/utilities/unix/package_management/apt/manifests/ppa.pp
View File

@@ -1,99 +0,0 @@
# @summary Manages PPA repositories using `add-apt-repository`. Not supported on Debian.
#
# @example Example declaration of an Apt PPA
# apt::ppa{ 'ppa:openstack-ppa/bleeding-edge': }
#
# @param ensure
# Specifies whether the PPA should exist. Valid options: 'present' and 'absent'.
#
# @param options
# Supplies options to be passed to the `add-apt-repository` command. Default: '-y'.
#
# @param 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.
#
# @param package_name
# Names the package that provides the `apt-add-repository` command. Default: 'software-properties-common'.
#
# @param package_manage
# Specifies whether Puppet should manage the package that provides `apt-add-repository`.
#
define apt::ppa(
String $ensure = 'present',
Optional[String] $options = $::apt::ppa_options,
Optional[String] $release = $facts['lsbdistcodename'],
Optional[String] $package_name = $::apt::ppa_package,
Boolean $package_manage = false,
) {
unless $release {
fail(translate('lsbdistcodename fact not available: release parameter required'))
}
if $facts['lsbdistid'] == 'Debian' {
fail(translate('apt::ppa is not currently supported on Debian.'))
}
if versioncmp($facts['lsbdistrelease'], '14.10') >= 0 {
$distid = downcase($facts['lsbdistid'])
$dash_filename = regsubst($name, '^ppa:([^/]+)/(.+)$', "\\1-${distid}-\\2")
$underscore_filename = regsubst($name, '^ppa:([^/]+)/(.+)$', "\\1_${distid}_\\2")
} else {
$dash_filename = regsubst($name, '^ppa:([^/]+)/(.+)$', "\\1-\\2")
$underscore_filename = regsubst($name, '^ppa:([^/]+)/(.+)$', "\\1_\\2")
}
$dash_filename_no_slashes = regsubst($dash_filename, '/', '-', 'G')
$dash_filename_no_specialchars = regsubst($dash_filename_no_slashes, '[\.\+]', '_', 'G')
$underscore_filename_no_slashes = regsubst($underscore_filename, '/', '-', 'G')
$underscore_filename_no_specialchars = regsubst($underscore_filename_no_slashes, '[\.\+]', '_', 'G')
$sources_list_d_filename = "${dash_filename_no_specialchars}-${release}.list"
if versioncmp($facts['lsbdistrelease'], '15.10') >= 0 {
$trusted_gpg_d_filename = "${underscore_filename_no_specialchars}.gpg"
} else {
$trusted_gpg_d_filename = "${dash_filename_no_specialchars}.gpg"
}
if $ensure == 'present' {
if $package_manage {
ensure_packages($package_name)
$_require = [File['sources.list.d'], Package[$package_name]]
} else {
$_require = File['sources.list.d']
}
$_proxy = $::apt::_proxy
if $_proxy['host'] {
if $_proxy['https'] {
$_proxy_env = ["http_proxy=http://${$_proxy['host']}:${$_proxy['port']}", "https_proxy=https://${$_proxy['host']}:${$_proxy['port']}"]
} else {
$_proxy_env = ["http_proxy=http://${$_proxy['host']}:${$_proxy['port']}"]
}
} else {
$_proxy_env = []
}
exec { "add-apt-repository-${name}":
environment => $_proxy_env,
command => "/usr/bin/add-apt-repository ${options} ${name} || (rm ${::apt::sources_list_d}/${sources_list_d_filename} && false)",
unless => "/usr/bin/test -f ${::apt::sources_list_d}/${sources_list_d_filename} && /usr/bin/test -f ${::apt::trusted_gpg_d}/${trusted_gpg_d_filename}",
user => 'root',
logoutput => 'on_failure',
notify => Class['apt::update'],
require => $_require,
}
file { "${::apt::sources_list_d}/${sources_list_d_filename}":
ensure => file,
require => Exec["add-apt-repository-${name}"],
}
}
else {
file { "${::apt::sources_list_d}/${sources_list_d_filename}":
ensure => 'absent',
notify => Class['apt::update'],
}
}
}

77
modules/utilities/unix/package_management/apt/manifests/setting.pp
View File

@@ -1,77 +0,0 @@
# @summary Manages Apt configuration files.
#
# @see https://docs.puppetlabs.com/references/latest/type.html#file-attributes for more information on source and content parameters
#
# @param priority
# Determines the order in which Apt processes the configuration file. Files with higher priority numbers are loaded first.
#
# @param ensure
# Specifies whether the file should exist. Valid options: 'present', 'absent', and 'file'.
#
# @param 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 link above for Puppet's native file type source attribute.
#
# @param content
# Required, unless `source` is set. Directly supplies content for the configuration file. Cannot be used in combination with `source`. Valid
# options: see link above for Puppet's native file type content attribute.
#
# @param notify_update
# Specifies whether to trigger an `apt-get update` run.
#
define apt::setting (
Variant[String, Integer, Array] $priority = 50,
Optional[Enum['file', 'present', 'absent']] $ensure = file,
Optional[String] $source = undef,
Optional[String] $content = undef,
Boolean $notify_update = true,
) {
if $content and $source {
fail(translate('apt::setting cannot have both content and source'))
}
if !$content and !$source {
fail(translate('apt::setting needs either of content or source'))
}
$title_array = split($title, '-')
$setting_type = $title_array[0]
$base_name = join(delete_at($title_array, 0), '-')
assert_type(Pattern[/\Aconf\z/, /\Apref\z/, /\Alist\z/], $setting_type) |$a, $b| {
fail(translate("apt::setting resource name/title must start with either 'conf-', 'pref-' or 'list-'"))
}
if $priority !~ Integer {
# need this to allow zero-padded priority.
assert_type(Pattern[/^\d+$/], $priority) |$a, $b| {
fail(translate('apt::setting priority must be an integer or a zero-padded integer'))
}
}
if ($setting_type == 'list') or ($setting_type == 'pref') {
$_priority = ''
} else {
$_priority = $priority
}
$_path = $::apt::config_files[$setting_type]['path']
$_ext = $::apt::config_files[$setting_type]['ext']
if $notify_update {
$_notify = Class['apt::update']
} else {
$_notify = undef
}
file { "${_path}/${_priority}${base_name}${_ext}":
ensure => $ensure,
owner => 'root',
group => 'root',
mode => '0644',
content => $content,
source => $source,
notify => $_notify,
}
}

165
modules/utilities/unix/package_management/apt/manifests/source.pp
View File

@@ -1,165 +0,0 @@
# @summary Manages the Apt sources in /etc/apt/sources.list.d/.
#
# @example Install the puppetlabs apt source
# apt::source { 'puppetlabs':
# location => 'http://apt.puppetlabs.com',
# repos => 'main',
# key => {
# id => '6F6B15509CF8E59E6E469F327F438280EF8D349F',
# server => 'hkps.pool.sks-keyservers.net',
# },
# }
#
# @param location
# Required, unless ensure is set to 'absent'. Specifies an Apt repository. Valid options: a string containing a repository URL.
#
# @param comment
# Supplies a comment for adding to the Apt source file.
#
# @param ensure
# Specifies whether the Apt source file should exist. Valid options: 'present' and 'absent'.
#
# @param release
# Specifies a distribution of the Apt repository.
#
# @param repos
# Specifies a component of the Apt repository.
#
# @param include
# Configures include options. Valid options: a hash of available keys.
#
# @option include [Boolean] :deb
# Specifies whether to request the distribution's compiled binaries. Default true.
#
# @option include [Boolean] :src
# Specifies whether to request the distribution's uncompiled source code. Default false.
#
# @param 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.
#
# @param 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.
#
# @param 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).
#
# @param 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.
#
# @param notify_update
# Specifies whether to trigger an `apt-get update` run.
#
define apt::source(
Optional[String] $location = undef,
String $comment = $name,
String $ensure = present,
Optional[String] $release = undef,
String $repos = 'main',
Optional[Variant[Hash]] $include = {},
Optional[Variant[String, Hash]] $key = undef,
Optional[Variant[Hash, Numeric, String]] $pin = undef,
Optional[String] $architecture = undef,
Boolean $allow_unsigned = false,
Boolean $notify_update = true,
) {
include ::apt
$_before = Apt::Setting["list-${title}"]
if !$release {
if $facts['lsbdistcodename'] {
$_release = $facts['lsbdistcodename']
} else {
fail(translate('lsbdistcodename fact not available: release parameter required'))
}
} else {
$_release = $release
}
if $ensure == 'present' {
if ! $location {
fail(translate('cannot create a source entry without specifying a location'))
}
# Newer oses, do not need the package for HTTPS transport.
$_transport_https_releases = [ 'wheezy', 'jessie', 'stretch', 'trusty', 'xenial' ]
if $_release in $_transport_https_releases and $location =~ /(?i:^https:\/\/)/ {
ensure_packages('apt-transport-https')
}
}
$includes = merge($::apt::include_defaults, $include)
if $key {
if $key =~ Hash {
unless $key['id'] {
fail(translate('key hash must contain at least an id entry'))
}
$_key = merge($::apt::source_key_defaults, $key)
} else {
$_key = { 'id' => assert_type(String[1], $key) }
}
}
$header = epp('apt/_header.epp')
$sourcelist = epp('apt/source.list.epp', {
'comment' => $comment,
'includes' => $includes,
'opt_architecture' => $architecture,
'allow_unsigned' => $allow_unsigned,
'location' => $location,
'release' => $_release,
'repos' => $repos,
})
apt::setting { "list-${name}":
ensure => $ensure,
content => "${header}${sourcelist}",
notify_update => $notify_update,
}
if $pin {
if $pin =~ Hash {
$_pin = merge($pin, { 'ensure' => $ensure, 'before' => $_before })
} elsif ($pin =~ Numeric or $pin =~ String) {
$url_split = split($location, '[:\/]+')
$host = $url_split[1]
$_pin = {
'ensure' => $ensure,
'priority' => $pin,
'before' => $_before,
'origin' => $host,
}
} else {
fail(translate('Received invalid value for pin parameter'))
}
create_resources('apt::pin', { "${name}" => $_pin })
}
# We do not want to remove keys when the source is absent.
if $key and ($ensure == 'present') {
if $_key =~ Hash {
if $_key['ensure'] != undef {
$_ensure = $_key['ensure']
} else {
$_ensure = $ensure
}
apt::key { "Add key: ${$_key['id']} from Apt::Source ${title}":
ensure => $_ensure,
id => $_key['id'],
server => $_key['server'],
content => $_key['content'],
source => $_key['source'],
options => $_key['options'],
before => $_before,
}
}
}
}

68
modules/utilities/unix/package_management/apt/manifests/update.pp
View File

@@ -1,68 +0,0 @@
# @summary Updates the list of available packages using apt-get update.
#
# @api private
#
class apt::update {
assert_private()
#TODO: to catch if $::apt_update_last_success has the value of -1 here. If we
#opt to do this, a info/warn would likely be all you'd need likely to happen
#on the first run, but if it's not run in awhile something is likely borked
#with apt and we'd want to know about it.
case $::apt::_update['frequency'] {
'always': {
$_kick_apt = true
}
'daily': {
#compare current date with the apt_update_last_success fact to determine
#if we should kick apt_update.
$daily_threshold = (Integer(Timestamp().strftime('%s')) - 86400)
if $::apt_update_last_success {
if $::apt_update_last_success + 0 < $daily_threshold {
$_kick_apt = true
} else {
$_kick_apt = false
}
} else {
#if apt-get update has not successfully run, we should kick apt_update
$_kick_apt = true
}
}
'weekly':{
#compare current date with the apt_update_last_success fact to determine
#if we should kick apt_update.
$weekly_threshold = (Integer(Timestamp().strftime('%s')) - 604800)
if $::apt_update_last_success {
if ( $::apt_update_last_success + 0 < $weekly_threshold ) {
$_kick_apt = true
} else {
$_kick_apt = false
}
} else {
#if apt-get update has not successfully run, we should kick apt_update
$_kick_apt = true
}
}
default: {
#catches 'reluctantly', and any other value (which should not occur).
#do nothing.
$_kick_apt = false
}
}
if $_kick_apt {
$_refresh = false
} else {
$_refresh = true
}
exec { 'apt_update':
command => "${::apt::provider} update",
loglevel => $::apt::_update['loglevel'],
logoutput => 'on_failure',
refreshonly => $_refresh,
timeout => $::apt::_update['timeout'],
tries => $::apt::_update['tries'],
try_sleep => 1
}
}

47
modules/utilities/unix/package_management/apt/metadata.json
View File

@@ -1,47 +0,0 @@
{
"name": "puppetlabs-apt",
"version": "6.2.1",
"author": "puppetlabs",
"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 < 6.0.0"
},
{
"name": "puppetlabs/translate",
"version_requirement": ">= 1.0.0 < 2.0.0"
}
],
"data_provider": null,
"operatingsystem_support": [
{
"operatingsystem": "Debian",
"operatingsystemrelease": [
"8",
"9"
]
},
{
"operatingsystem": "Ubuntu",
"operatingsystemrelease": [
"14.04",
"16.04",
"18.04"
]
}
],
"requirements": [
{
"name": "puppet",
"version_requirement": ">= 4.8.0 < 7.0.0"
}
],
"template-url": "https://github.com/puppetlabs/pdk-templates",
"template-ref": "heads/master-0-gabccfb1",
"pdk-version": "1.7.0"
}

291
modules/utilities/unix/package_management/apt/readmes/README_ja_JP.md
View File

@@ -1,291 +0,0 @@
# apt
#### 目次
1. [説明 - モジュールの機能とその有益性](#module-description)
1. [セットアップ - apt導入の基本](#setup)
* [aptが影響を与えるもの](#what-apt-affects)
* [aptの使用を開始する](#beginning-with-apt)
1. [使用 - 設定オプションと追加機能](#usage)
* [GPGキーの追加](#add-gpg-keys)
* [バックポートの優先度を上げる](#prioritize-backports)
* [パッケージリストの更新](#update-the-list-of-packages)
* [特定のリリースのピン止め](#pin-a-specific-release)
* [PPA (Personal Package Archive)レポジトリの追加](#add-a-personal-package-archive-repository)
* [HieraからのAptの構成](#configure-apt-from-hiera)
* [デフォルトのsources.listファイルの置き換え](#replace-the-default-sourceslist-file)
1. [参考 - モジュールの機能と動作について](#reference)
1. [制約 - OS互換性など](#limitations)
1. [開発 - モジュール貢献についてのガイド](#development)
## モジュールの概要
aptモジュールを導入すると、Puppetを使用してAPT (Advanced Package Tool)のソース、キー、その他の構成オプションを管理できます。
APTとは、Debian、Ubuntu、およびその他いくつかのオペレーティングシステムで利用可能なパッケージマネージャです。aptモジュールは、APTのパッケージ管理を自動化するのに役立つ一連のクラス、定義型、およびfactsを提供します。
**注意**: このモジュールが実行中のDebian/Ubuntu (もしくは派生OS)のバージョンを正しく自動検出するためには、'lsb-release'パッケージがインストールされていることを確認する必要があります。これをプロビジョニングレイヤの一部にするか(多くのDebianシステムまたは派生OSシステムを実行する場合はこちらを推奨)、この依存関係を自動的に取得する機能をもつFacter 2.2.0以降をインストールしておくことを強くお勧めします。
## セットアップ
### aptが影響を与えるもの
* システムの`preferences`ファイルと`preferences.d`ディレクトリ
* システムの `sources.list`ファイルと`sources.list.d`ディレクトリ
* システムレポジトリ
* 認証キー
**注意:** このモジュールには`purge`パラメータがあります。このパラメータを`true`に設定すると、 ノードの `sources.list(.d)`および`preferences(.d)`の構成のうち、Puppetを通して宣言されていないものがすべて**破棄**されます。このパラメータのデフォルトは`false`です。
### aptの使用を開始する
デフォルトのパラメータでaptモジュールを使用するには、`apt`クラスを宣言します。
```puppet
include apt
```
**注意:** メインの`apt`クラスは、このモジュールに含まれるその他すべてのクラス、型、定義型によって要求されます。このモジュールを使用する際は、このクラスを必ず宣言する必要があります。
## 使用
### GPGキーの追加
**警告:** 短いキーIDを使用すると、衝突攻撃が有効になる可能性があり、セキュリティに深刻な問題が生じます。常に、完全なフィンガープリントを使用してGPGキーを識別することを推奨します。このモジュールでは短いキーの使用が許可されていますが、それを使用した場合、セキュリティ警告が発行されます。
`apt::key`の定義型を宣言するには、次のように記述します。
```puppet
apt::key { 'puppetlabs':
id => '6F6B15509CF8E59E6E469F327F438280EF8D349F',
server => 'pgp.mit.edu',
options => 'http-proxy="http://proxyuser:proxypass@example.org:3128"',
}
```
### バックポートの優先度を上げる
```puppet
class { 'apt::backports':
pin => 500,
}
```
デフォルトでは、`apt::backports`クラスはバックポート用のピンファイルをドロップし、優先度200にピン止めします。これは、通常のデフォルト値である500よりも低いため、`ensure => latest`に設定されているパッケージは、明示的な許可がない限り、バックポートからアップグレードされることはありません。
`pin`パラメータを使用して優先度を500に上げると、通常のポリシーが有効になり、Aptは最新のバージョンをインストールするか、最新のバージョンにアップグレードします。これはつまり、`package`リソースの`ensure`属性を明示的に`installed`/`present`もしくは特定のバージョンに設定していない限り、あるパッケージがバックポートから利用できる場合は、そのパッケージと依存関係がバックポートから取得されるということです。
### パッケージリストの更新
デフォルトでは、`apt`クラスをインクルードした後の最初のPuppet実行時と、`notify => Exec['apt_update']`が発生するたびに(別の言い方をすれば、構成ファイルが更新されるか、関連するその他の変更が行われるたびに)、Puppetは`apt-get update`を実行します。`update['frequency']`を'always'に設定すると、Puppet実行時に毎回更新が行われます。`update['frequency']`は'daily'や'weekly'に設定することも可能です。
```puppet
class { 'apt':
update => {
frequency => 'daily',
},
}
```
`Exec['apt_update']`がトリガされると、`Notice`メッセージが生成されます。デフォルトの[agentロギングレベル](https://docs.puppet.com/puppet/latest/configuration.html#loglevel)は`notice`であるため、このレポジトリの更新は、ログおよびagentレポートに記録されます。[Foreman](https://www.theforeman.org)など、一部のツールでは、このような更新通知が重要な変更としてレポートされます。これらの更新がレポートに記録されないようにするには、`Exec['apt_update']`の[loglevel](https://docs.puppet.com/puppet/latest/metaparameter.html#loglevel)メタパラメータをagentロギングレベルよりも高い値に設定します。
```puppet
class { 'apt':
update => {
frequency => 'daily',
loglevel => 'debug',
},
}
```
### 特定のリリースのピン止め
```puppet
apt::pin { 'karmic': priority => 700 }
apt::pin { 'karmic-updates': priority => 700 }
apt::pin { 'karmic-security': priority => 700 }
```
ディストリビューションのプロパティを使用して、より複雑なピンを指定することもできます。
```puppet
apt::pin { 'stable':
priority => -10,
originator => 'Debian',
release_version => '3.0',
component => 'main',
label => 'Debian'
}
```
複数のパッケージをピン止めするには、配列またはスペース区切りの文字列としてその情報を`packages`パラメータに渡します。
### PPA (Personal Package Archive)レポジトリの追加
```puppet
apt::ppa { 'ppa:drizzle-developers/ppa': }
```
### `/etc/apt/sources.list.d/`へのAptソースの追加
```puppet
apt::source { 'debian_unstable':
comment => 'This is the iWeb Debian unstable mirror',
location => 'http://debian.mirror.iweb.ca/debian/',
release => 'unstable',
repos => 'main contrib non-free',
pin => '-10',
key => {
'id' => 'A1BD8E9D78F7FE5C3E65D8AF8B48AD6246925553',
'server' => 'subkeys.pgp.net',
},
include => {
'src' => true,
'deb' => true,
},
}
```
Puppet Aptレポジトリをソースとして使用するには、次のように記述します。
```puppet
apt::source { 'puppetlabs':
location => 'http://apt.puppetlabs.com',
repos => 'main',
key => {
'id' => '6F6B15509CF8E59E6E469F327F438280EF8D349F',
'server' => 'pgp.mit.edu',
},
}
```
### HieraからのAptの構成
ソースをリソースとして直接指定するかわりに、単純に`apt`クラスをインクルードして、値をHieraから自動的に取得するように構成できます。
```yaml
apt::sources:
'debian_unstable':
comment: 'This is the iWeb Debian unstable mirror'
location: 'http://debian.mirror.iweb.ca/debian/'
release: 'unstable'
repos: 'main contrib non-free'
pin: '-10'
key:
id: 'A1BD8E9D78F7FE5C3E65D8AF8B48AD6246925553'
server: 'subkeys.pgp.net'
include:
src: true
deb: true
'puppetlabs':
location: 'http://apt.puppetlabs.com'
repos: 'main'
key:
id: '6F6B15509CF8E59E6E469F327F438280EF8D349F'
server: 'pgp.mit.edu'
```
### デフォルトの`sources.list`ファイルの置き換え
デフォルトの`/etc/apt/sources.list`を置き換える例を以下に示します。以下のコードと合わせて、`purge`パラメータを必ず使用してください。使用しない場合、Apt実行時にソース重複の警告が出ます。
```puppet
apt::source { "archive.ubuntu.com-${lsbdistcodename}":
location => 'http://archive.ubuntu.com/ubuntu',
key => '630239CC130E1A7FD81A27B140976EAF437D05B5',
repos => 'main universe multiverse restricted',
}
apt::source { "archive.ubuntu.com-${lsbdistcodename}-security":
location => 'http://archive.ubuntu.com/ubuntu',
key => '630239CC130E1A7FD81A27B140976EAF437D05B5',
repos => 'main universe multiverse restricted',
release => "${lsbdistcodename}-security"
}
apt::source { "archive.ubuntu.com-${lsbdistcodename}-updates":
location => 'http://archive.ubuntu.com/ubuntu',
key => '630239CC130E1A7FD81A27B140976EAF437D05B5',
repos => 'main universe multiverse restricted',
release => "${lsbdistcodename}-updates"
}
apt::source { "archive.ubuntu.com-${lsbdistcodename}-backports":
location => 'http://archive.ubuntu.com/ubuntu',
key => '630239CC130E1A7FD81A27B140976EAF437D05B5',
repos => 'main universe multiverse restricted',
release => "${lsbdistcodename}-backports"
}
```
### APTソースやプロキシのログイン設定を`/etc/apt/auth.conf`で管理する
APTバージョン1.5以降、認証が必要なAPTソースやプロキシについて、ユーザ名やパスワードなどのログイン設定を`/etc/apt/auth.conf`ファイルに定義できるようになりました。この方法は、`source.list`内にログイン情報を直接記述するよりも推奨されます。直接記述した場合、通常、あらゆるユーザから読み取り可能になるためです。
`/etc/apt/auth.confファイルのフォーマットは、(ftpやcurlによって使用される) netrcに従い、ファイルパーミッションが制限されています。詳しくは、[こちら](https://manpages.debian.org/testing/apt/apt_auth.conf.5.en.html)を参照してください。
オプションの`apt::auth_conf_entries`パラメータを使用して、ログイン設定を含むハッシュの配列を指定します。このハッシュに含めることができるのは、`machine`、`login`、および`password`キーのみです。
```puppet
class { 'apt':
auth_conf_entries => [
{
'machine' => 'apt-proxy.example.net',
'login' => 'proxylogin',
'password' => 'proxypassword',
},
{
'machine' => 'apt.example.com/ubuntu',
'login' => 'reader',
'password' => 'supersecret',
},
],
}
```
## リファレンス
### Facts
* `apt_updates`: `upgrade`で入手可能な更新がある、インストール済みパッケージの数。
* `apt_dist_updates`: `dist-upgrade`で入手可能な更新がある、インストール済みパッケージの数。
* `apt_security_updates`: `upgrade`で入手可能なセキュリティ更新がある、インストール済みパッケージの数。
* `apt_security_dist_updates`: `dist-upgrade`で入手可能なセキュリティ更新がある、インストール済みパッケージの数。
* `apt_package_updates`: `upgrade`で入手可能な更新がある、すべてのインストール済みパッケージの名前。Facter 2.0以降では、このデータのフォーマットは配列で、それ以前のバージョンでは、コンマ区切りの文字列です。
* `apt_package_dist_updates`: `dist-upgrade`で入手可能な更新がある、すべてのインストール済みパッケージの名前。Facter 2.0以降では、このデータのフォーマットは配列で、それ以前のバージョンでは、コンマ区切りの文字列です。
* `apt_update_last_success`: 直近で成功した`apt-get update`実行のエポックタイムによる日付(/var/lib/apt/periodic/update-success-stampのmtimeに基づく)。
* `apt_reboot_required`: 更新がインストールされた後に再起動が必要かどうかを決定します。
### 詳細情報
その他すべてのリファレンスマニュアルについては、[REFERENCE.md](https://github.com/puppetlabs/puppetlabs-apt/blob/master/REFERENCE.md)を参照してください。
## 制約
このモジュールは、[実行ステージ](https://docs.puppetlabs.com/puppet/latest/reference/lang_run_stages.html)に分割するようには設計されていません。
サポート対象のオペレーティングシステムの全リストについては、[metadata.json](https://github.com/puppetlabs/puppetlabs-apt/blob/master/metadata.json)を参照してください。
### 新しいソースまたはPPAの追加
新しいソースまたはPPAを追加し、同一のPuppet実行において、その新しいソースまたはPPAからパッケージをインストールするには、`package`リソースが`Apt::Source`または`Apt::Ppa`に従属し、かつ`Class['apt::update']に従属する必要があります。[コレクタ](https://docs.puppetlabs.com/puppet/latest/reference/lang_collectors.html)を追加することによって、すべてのパッケージが`apt::update`の後に来るように制御することもできますが、その場合、循環依存が発生したり、[仮想リソース](https://docs.puppetlabs.com/puppet/latest/reference/lang_collectors.html#behavior)と関係したりすることがあります。以下のコマンドを実行する前に、すべてのパッケージのプロバイダがaptに設定されていることを確認してください。
```puppet
Class['apt::update'] -> Package <| provider == 'apt' |>
```
## 開発
Puppet ForgeのPuppet Labsモジュールはオープンプロジェクトで、良い状態に保つためには、コミュニティの貢献が必要不可欠です。Puppetが役に立つはずでありながら、私たちがアクセスできないプラットフォームやハードウェア、ソフトウェア、デプロイ構成は無数にあります。私たちの目標は、できる限り簡単に変更に貢献し、みなさまの環境で私たちのモジュールが機能できるようにすることにあります。最高の状態を維持できるようにするために、コントリビュータが従う必要のあるいくつかのガイドラインが存在します。
詳細については、[モジュール貢献ガイド](https://docs.puppetlabs.com/forge/contributing.html)を参照してください。
すでにご協力いただいている方のリストについては、[コントリビュータのリスト](https://github.com/puppetlabs/puppetlabs-apt/graphs/contributors)をご覧ください。

19
modules/utilities/unix/package_management/apt/secgen_metadata.xml
View File

@@ -1,19 +0,0 @@
<?xml version="1.0"?>
<utility xmlns="http://www.github/cliffe/SecGen/utility"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://www.github/cliffe/SecGen/utility">
<name>Apt Package Manager</name>
<author>Puppetlabs</author>
<author>Thomas Shaw</author>
<module_license>Apache v2</module_license>
<description>Apt package management puppet module, includes functionality for adding 3rd party repositories.</description>
<type>http</type>
<platform>linux</platform>
<conflict>
<name>Wheezy</name>
</conflict>
</utility>

16
modules/utilities/unix/package_management/apt/spec/acceptance/01_apt_class_spec.rb
View File

@@ -1,16 +0,0 @@
require 'spec_helper_acceptance'
describe 'apt class' do
context 'with default parameters' do
# Using puppet_apply as a helper
it 'works with no errors' do
pp = <<-MANIFEST
class { 'apt': }
MANIFEST
# Run it twice and test for idempotency
apply_manifest(pp, catch_failures: true)
apply_manifest(pp, catch_changes: true)
end
end
end

1003
modules/utilities/unix/package_management/apt/spec/acceptance/apt_key_provider_spec.rb
View File

File diff suppressed because it is too large Load Diff

56
modules/utilities/unix/package_management/apt/spec/acceptance/apt_spec.rb
View File

@@ -1,56 +0,0 @@
require 'spec_helper_acceptance'
everything_everything_pp = <<-MANIFEST
$sources = {
'puppetlabs' => {
'ensure' => present,
'location' => 'http://apt.puppetlabs.com',
'repos' => 'main',
'key' => {
'id' => '6F6B15509CF8E59E6E469F327F438280EF8D349F',
'server' => 'pool.sks-keyservers.net',
},
},
}
class { 'apt':
update => {
'frequency' => 'always',
'timeout' => 400,
'tries' => 3,
},
purge => {
'sources.list' => true,
'sources.list.d' => true,
'preferences' => true,
'preferences.d' => true,
},
sources => $sources,
}
MANIFEST
describe 'apt class' do
context 'with reset' do
it 'fixes the sources.list' do
shell('cp /etc/apt/sources.list /tmp')
end
end
context 'with all the things' do
it 'works with no errors' do
# Apply the manifest (Retry if timeout error is received from key pool)
retry_on_error_matching do
apply_manifest(everything_everything_pp, catch_failures: true)
end
end
it 'stills work' do
shell('apt-get update')
shell('apt-get -y --force-yes upgrade')
end
end
context 'with reset' do
it 'fixes the sources.list' do
shell('cp /tmp/sources.list /etc/apt')
end
end
end

11
modules/utilities/unix/package_management/apt/spec/acceptance/init_task_spec.rb
View File

@@ -1,11 +0,0 @@
# run a test task
require 'spec_helper_acceptance'
describe 'apt tasks' do
describe 'update and upgrade', if: pe_install? && puppet_version =~ %r{(5\.\d\.\d)} && fact_on(master, 'osfamily') == 'Debian' do
it 'execute arbitary sql' do
result = run_task(task_name: 'apt', params: 'action=update')
expect_multiple_regexes(result: result, regexes: [%r{Reading package lists}, %r{Job completed. 1/1 nodes succeeded}])
end
end
end

78
modules/utilities/unix/package_management/apt/spec/acceptance/locales_spec.rb
View File

@@ -1,78 +0,0 @@
require 'spec_helper_acceptance'
require 'beaker/i18n_helper'
PUPPETLABS_GPG_KEY_LONG_ID = '7F438280EF8D349F'.freeze
PUPPETLABS_LONG_FINGERPRINT = '123456781274D2C8A956789A456789A456789A9A'.freeze
id_doesnt_match_fingerprint_pp = <<-MANIFEST
apt_key { '#{PUPPETLABS_LONG_FINGERPRINT}':
ensure => 'present',
content => '123456781274D2C8A956789A456789A456789A9B',
}
MANIFEST
location_not_specified_fail_pp = <<-MANIFEST
apt::source { 'puppetlabs':
ensure => 'present',
repos => 'main',
key => {
id => '6F6B15509CF8E59E6E469F327F438280EF8D349F',
server => 'hkps.pool.sks-keyservers.net',
},
}
MANIFEST
invalid_title_pp = <<-MANIFEST
apt::setting { 'test':
ensure => 'present',
content => 'test'
}
MANIFEST
no_content_param_pp = <<-MANIFEST
apt::conf { 'test':
ensure => 'present',
}
MANIFEST
describe 'localization', if: (fact('osfamily') == 'Debian' || fact('osfamily') == 'RedHat') && (Gem::Version.new(puppet_version) >= Gem::Version.new('4.10.5')) do
before :all do
hosts.each do |host|
on(host, "sed -i \"96i FastGettext.locale='ja'\" /opt/puppetlabs/puppet/lib/ruby/vendor_ruby/puppet.rb")
change_locale_on(host, 'ja_JP.utf-8')
end
end
describe 'ruby translations' do
it 'translates an interpolated string' do
apply_manifest(id_doesnt_match_fingerprint_pp, expect_failures: true) do |r|
expect(r.stderr).to match(%r{content/sourceが正当であるかを確認してください})
end
end
it 'translates a simple string' do
apply_manifest(location_not_specified_fail_pp, expect_failures: true) do |r|
expect(r.stderr).to match(%r{場所を指定せずにソースエントリを作成することはできません})
end
end
end
describe 'puppet translations' do
it 'translates a concatenated string' do
apply_manifest(invalid_title_pp, expect_failures: true) do |r|
expect(r.stderr).to match(%r{apt::settingのリソース名/タイトルの先頭は、'conf-'、'pref-'、'list-'にする必要があります})
end
end
it 'translates a simple string' do
apply_manifest(no_content_param_pp, expect_failures: true) do |r|
expect(r.stderr).to match(%r{contentパラメータを渡す必要があります})
end
end
end
after :all do
hosts.each do |host|
on(host, 'sed -i "96d" /opt/puppetlabs/puppet/lib/ruby/vendor_ruby/puppet.rb')
change_locale_on(host, 'en_US')
end
end
end

10
modules/utilities/unix/package_management/apt/spec/acceptance/nodesets/centos-7-x64.yml
View File

@@ -1,10 +0,0 @@
HOSTS:
centos-7-x64:
roles:
- agent
- default
platform: el-7-x86_64
hypervisor: vagrant
box: puppetlabs/centos-7.2-64-nocm
CONFIG:
type: foss

10
modules/utilities/unix/package_management/apt/spec/acceptance/nodesets/debian-8-x64.yml
View File

@@ -1,10 +0,0 @@
HOSTS:
debian-8-x64:
roles:
- agent
- default
platform: debian-8-amd64
hypervisor: vagrant
box: puppetlabs/debian-8.2-64-nocm
CONFIG:
type: foss

10
modules/utilities/unix/package_management/apt/spec/acceptance/nodesets/default.yml
View File

@@ -1,10 +0,0 @@
HOSTS:
ubuntu-1404-x64:
roles:
- agent
- default
platform: ubuntu-14.04-amd64
hypervisor: vagrant
box: puppetlabs/ubuntu-14.04-64-nocm
CONFIG:
type: foss

12
modules/utilities/unix/package_management/apt/spec/acceptance/nodesets/docker/centos-7.yml
View File

@@ -1,12 +0,0 @@
HOSTS:
centos-7-x64:
platform: el-7-x86_64
hypervisor: docker
image: centos:7
docker_preserve_image: true
docker_cmd: '["/usr/sbin/init"]'
# install various tools required to get the image up to usable levels
docker_image_commands:
- 'yum install -y crontabs tar wget openssl sysvinit-tools iproute which initscripts'
CONFIG:
trace_limit: 200

11
modules/utilities/unix/package_management/apt/spec/acceptance/nodesets/docker/debian-8.yml
View File

@@ -1,11 +0,0 @@
HOSTS:
debian-8-x64:
platform: debian-8-amd64
hypervisor: docker
image: debian:8
docker_preserve_image: true
docker_cmd: '["/sbin/init"]'
docker_image_commands:
- 'apt-get update && apt-get install -y net-tools wget locales strace lsof && echo "en_US.UTF-8 UTF-8" > /etc/locale.gen && locale-gen'
CONFIG:
trace_limit: 200

12
modules/utilities/unix/package_management/apt/spec/acceptance/nodesets/docker/ubuntu-14.04.yml
View File

@@ -1,12 +0,0 @@
HOSTS:
ubuntu-1404-x64:
platform: ubuntu-14.04-amd64
hypervisor: docker
image: ubuntu:14.04
docker_preserve_image: true
docker_cmd: '["/sbin/init"]'
docker_image_commands:
# ensure that upstart is booting correctly in the container
- 'rm /usr/sbin/policy-rc.d && rm /sbin/initctl && dpkg-divert --rename --remove /sbin/initctl && apt-get update && apt-get install -y net-tools wget && locale-gen en_US.UTF-8'
CONFIG:
trace_limit: 200

253
modules/utilities/unix/package_management/apt/spec/classes/apt_backports_spec.rb
View File

@@ -1,253 +0,0 @@
require 'spec_helper'
describe 'apt::backports', type: :class do
let(:pre_condition) { "class{ '::apt': }" }
describe 'debian/ubuntu tests' do
context 'with defaults on deb' do
let(:facts) do
{
os: { family: 'Debian', name: 'Debian', release: { major: '8', full: '8.0' } },
lsbdistid: 'Debian',
osfamily: 'Debian',
lsbdistcodename: 'jessie',
puppetversion: Puppet.version,
}
end
it {
is_expected.to contain_apt__source('backports').with(location: 'http://deb.debian.org/debian',
key: 'A1BD8E9D78F7FE5C3E65D8AF8B48AD6246925553',
repos: 'main contrib non-free',
release: 'jessie-backports',
pin: { 'priority' => 200, 'release' => 'jessie-backports' })
}
end
context 'with defaults on ubuntu' do
let(:facts) do
{
os: { family: 'Debian', name: 'Ubuntu', release: { major: '16', full: '16.04' } },
lsbdistid: 'Ubuntu',
osfamily: 'Debian',
lsbdistcodename: 'xenial',
lsbdistrelease: '16.04',
puppetversion: Puppet.version,
}
end
it {
is_expected.to contain_apt__source('backports').with(location: 'http://archive.ubuntu.com/ubuntu',
key: '630239CC130E1A7FD81A27B140976EAF437D05B5',
repos: 'main universe multiverse restricted',
release: 'xenial-backports',
pin: { 'priority' => 200, 'release' => 'xenial-backports' })
}
end
context 'with everything set' do
let(:facts) do
{
os: { family: 'Debian', name: 'Ubuntu', release: { major: '16', full: '16.04' } },
lsbdistid: 'Ubuntu',
osfamily: 'Debian',
lsbdistcodename: 'xenial',
lsbdistrelease: '16.04',
puppetversion: Puppet.version,
}
end
let(:params) do
{
location: 'http://archive.ubuntu.com/ubuntu-test',
release: 'vivid',
repos: 'main',
key: 'A1BD8E9D78F7FE5C3E65D8AF8B48AD6246925553',
pin: '90',
}
end
it {
is_expected.to contain_apt__source('backports').with(location: 'http://archive.ubuntu.com/ubuntu-test',
key: 'A1BD8E9D78F7FE5C3E65D8AF8B48AD6246925553',
repos: 'main',
release: 'vivid',
pin: { 'priority' => 90, 'release' => 'vivid' })
}
end
context 'when set things with hashes' do
let(:facts) do
{
os: { family: 'Debian', name: 'Ubuntu', release: { major: '16', full: '16.04' } },
lsbdistid: 'Ubuntu',
osfamily: 'Debian',
lsbdistcodename: 'xenial',
lsbdistrelease: '16.04',
puppetversion: Puppet.version,
}
end
let(:params) do
{
key: {
'id' => 'A1BD8E9D78F7FE5C3E65D8AF8B48AD6246925553',
},
pin: {
'priority' => '90',
},
}
end
it {
is_expected.to contain_apt__source('backports').with(key: { 'id' => 'A1BD8E9D78F7FE5C3E65D8AF8B48AD6246925553' },
pin: { 'priority' => '90' })
}
end
end
describe 'mint tests' do
let(:facts) do
{
os: { family: 'Debian', name: 'Linuxmint', release: { major: '17', full: '17' } },
lsbdistid: 'linuxmint',
osfamily: 'Debian',
lsbdistcodename: 'qiana',
puppetversion: Puppet.version,
}
end
context 'with all the needed things set' do
let(:params) do
{
location: 'http://archive.ubuntu.com/ubuntu',
release: 'trusty-backports',
repos: 'main universe multiverse restricted',
key: '630239CC130E1A7FD81A27B140976EAF437D05B5',
}
end
it {
is_expected.to contain_apt__source('backports').with(location: 'http://archive.ubuntu.com/ubuntu',
key: '630239CC130E1A7FD81A27B140976EAF437D05B5',
repos: 'main universe multiverse restricted',
release: 'trusty-backports',
pin: { 'priority' => 200, 'release' => 'trusty-backports' })
}
end
context 'with missing location' do
let(:params) do
{
release: 'trusty-backports',
repos: 'main universe multiverse restricted',
key: '630239CC130E1A7FD81A27B140976EAF437D05B5',
}
end
it do
is_expected.to raise_error(Puppet::Error, %r{If not on Debian or Ubuntu, you must explicitly pass location, release, repos, and key})
end
end
context 'with missing release' do
let(:params) do
{
location: 'http://archive.ubuntu.com/ubuntu',
repos: 'main universe multiverse restricted',
key: '630239CC130E1A7FD81A27B140976EAF437D05B5',
}
end
it do
is_expected.to raise_error(Puppet::Error, %r{If not on Debian or Ubuntu, you must explicitly pass location, release, repos, and key})
end
end
context 'with missing repos' do
let(:params) do
{
location: 'http://archive.ubuntu.com/ubuntu',
release: 'trusty-backports',
key: '630239CC130E1A7FD81A27B140976EAF437D05B5',
}
end
it do
is_expected.to raise_error(Puppet::Error, %r{If not on Debian or Ubuntu, you must explicitly pass location, release, repos, and key})
end
end
context 'with missing key' do
let(:params) do
{
location: 'http://archive.ubuntu.com/ubuntu',
release: 'trusty-backports',
repos: 'main universe multiverse restricted',
}
end
it do
is_expected.to raise_error(Puppet::Error, %r{If not on Debian or Ubuntu, you must explicitly pass location, release, repos, and key})
end
end
end
describe 'validation' do
let(:facts) do
{
os: { family: 'Debian', name: 'Ubuntu', release: { major: '16', full: '16.04' } },
lsbdistid: 'Ubuntu',
osfamily: 'Debian',
lsbdistcodename: 'xenial',
lsbdistrelease: '16.04',
puppetversion: Puppet.version,
}
end
context 'with invalid location' do
let(:params) do
{
location: true,
}
end
it do
is_expected.to raise_error(Puppet::Error, %r{expects a})
end
end
context 'with invalid release' do
let(:params) do
{
release: true,
}
end
it do
is_expected.to raise_error(Puppet::Error, %r{expects a})
end
end
context 'with invalid repos' do
let(:params) do
{
repos: true,
}
end
it do
is_expected.to raise_error(Puppet::Error, %r{expects a})
end
end
context 'with invalid key' do
let(:params) do
{
key: true,
}
end
it do
is_expected.to raise_error(Puppet::Error, %r{expects a})
end
end
context 'with invalid pin' do
let(:params) do
{
pin: true,
}
end
it do
is_expected.to raise_error(Puppet::Error, %r{expects a})
end
end
end
end

435
modules/utilities/unix/package_management/apt/spec/classes/apt_spec.rb
View File

@@ -1,435 +0,0 @@
require 'spec_helper'
sources_list = { ensure: 'file',
path: '/etc/apt/sources.list',
owner: 'root',
group: 'root',
mode: '0644',
notify: 'Class[Apt::Update]' }
sources_list_d = { ensure: 'directory',
path: '/etc/apt/sources.list.d',
owner: 'root',
group: 'root',
mode: '0644',
purge: false,
recurse: false,
notify: 'Class[Apt::Update]' }
preferences = { ensure: 'file',
path: '/etc/apt/preferences',
owner: 'root',
group: 'root',
mode: '0644',
notify: 'Class[Apt::Update]' }
preferences_d = { ensure: 'directory',
path: '/etc/apt/preferences.d',
owner: 'root',
group: 'root',
mode: '0644',
purge: false,
recurse: false,
notify: 'Class[Apt::Update]' }
describe 'apt' do
let(:facts) do
{
os: { family: 'Debian', name: 'Debian', release: { major: '8', full: '8.0' } },
lsbdistid: 'Debian',
osfamily: 'Debian',
lsbdistcodename: 'wheezy',
puppetversion: Puppet.version,
}
end
context 'with defaults' do
it {
is_expected.to contain_file('sources.list').that_notifies('Class[Apt::Update]').only_with(sources_list)
}
it {
is_expected.to contain_file('sources.list.d').that_notifies('Class[Apt::Update]').only_with(sources_list_d)
}
it {
is_expected.to contain_file('preferences').that_notifies('Class[Apt::Update]').only_with(preferences)
}
it {
is_expected.to contain_file('preferences.d').that_notifies('Class[Apt::Update]').only_with(preferences_d)
}
it { is_expected.to contain_file('/etc/apt/auth.conf').with_ensure('absent') }
it 'lays down /etc/apt/apt.conf.d/15update-stamp' do
is_expected.to contain_file('/etc/apt/apt.conf.d/15update-stamp').with(group: 'root',
mode: '0644',
owner: 'root').with_content(
%r{APT::Update::Post-Invoke-Success {"touch /var/lib/apt/periodic/update-success-stamp 2>/dev/null || true";};},
)
end
it {
is_expected.to contain_exec('apt_update').with(refreshonly: 'true')
}
it { is_expected.not_to contain_apt__setting('conf-proxy') }
end
describe 'proxy=' do
context 'when host=localhost' do
let(:params) { { proxy: { 'host' => 'localhost' } } }
it {
is_expected.to contain_apt__setting('conf-proxy').with(priority: '01').with_content(
%r{Acquire::http::proxy "http://localhost:8080/";},
).without_content(
%r{Acquire::https::proxy},
)
}
end
context 'when host=localhost and port=8180' do
let(:params) { { proxy: { 'host' => 'localhost', 'port' => 8180 } } }
it {
is_expected.to contain_apt__setting('conf-proxy').with(priority: '01').with_content(
%r{Acquire::http::proxy "http://localhost:8180/";},
).without_content(
%r{Acquire::https::proxy},
)
}
end
context 'when host=localhost and https=true' do
let(:params) { { proxy: { 'host' => 'localhost', 'https' => true } } }
it {
is_expected.to contain_apt__setting('conf-proxy').with(priority: '01').with_content(
%r{Acquire::http::proxy "http://localhost:8080/";},
).with_content(
%r{Acquire::https::proxy "https://localhost:8080/";},
)
}
end
context 'when host=localhost and direct=true' do
let(:params) { { proxy: { 'host' => 'localhost', 'direct' => true } } }
it {
is_expected.to contain_apt__setting('conf-proxy').with(priority: '01').with_content(
%r{Acquire::http::proxy "http://localhost:8080/";},
).with_content(
%r{Acquire::https::proxy "DIRECT";},
)
}
end
context 'when host=localhost and https=true and direct=true' do
let(:params) { { proxy: { 'host' => 'localhost', 'https' => true, 'direct' => true } } }
it {
is_expected.to contain_apt__setting('conf-proxy').with(priority: '01').with_content(
%r{Acquire::http::proxy "http://localhost:8080/";},
).with_content(
%r{Acquire::https::proxy "https://localhost:8080/";},
)
}
it {
is_expected.to contain_apt__setting('conf-proxy').with(priority: '01').with_content(
%r{Acquire::http::proxy "http://localhost:8080/";},
).without_content(
%r{Acquire::https::proxy "DIRECT";},
)
}
end
context 'when ensure=absent' do
let(:params) { { proxy: { 'ensure' => 'absent' } } }
it {
is_expected.to contain_apt__setting('conf-proxy').with(ensure: 'absent',
priority: '01')
}
end
end
context 'with lots of non-defaults' do
let :params do
{
update: { 'frequency' => 'always', 'timeout' => 1, 'tries' => 3 },
purge: { 'sources.list' => false, 'sources.list.d' => false,
'preferences' => false, 'preferences.d' => false },
}
end
it {
is_expected.to contain_file('sources.list').with(content: nil)
}
it {
is_expected.to contain_file('sources.list.d').with(purge: false,
recurse: false)
}
it {
is_expected.to contain_file('preferences').with(ensure: 'file')
}
it {
is_expected.to contain_file('preferences.d').with(purge: false,
recurse: false)
}
it {
is_expected.to contain_exec('apt_update').with(refreshonly: false,
timeout: 1,
tries: 3)
}
end
context 'with entries for /etc/apt/auth.conf' do
let(:params) do
{
auth_conf_entries: [
{ machine: 'deb.example.net',
login: 'foologin',
password: 'secret' },
{ machine: 'apt.example.com',
login: 'aptlogin',
password: 'supersecret' },
],
}
end
auth_conf_content = "// This file is managed by Puppet. DO NOT EDIT.
machine deb.example.net login foologin password secret
machine apt.example.com login aptlogin password supersecret
"
it {
is_expected.to contain_file('/etc/apt/auth.conf').with(ensure: 'present',
owner: 'root',
group: 'root',
mode: '0600',
notify: 'Class[Apt::Update]',
content: auth_conf_content)
}
end
context 'with improperly specified entries for /etc/apt/auth.conf' do
let(:params) do
{
auth_conf_entries: [
{ machinn: 'deb.example.net',
username: 'foologin',
password: 'secret' },
{ machine: 'apt.example.com',
login: 'aptlogin',
password: 'supersecret' },
],
}
end
it { is_expected.to raise_error(Puppet::Error) }
end
context 'with sources defined on valid osfamily' do
let :facts do
{ os: { family: 'Debian', name: 'Ubuntu', release: { major: '16', full: '16.04' } },
osfamily: 'Debian',
lsbdistcodename: 'xenial',
lsbdistid: 'Ubuntu',
lsbdistrelease: '16.04',
puppetversion: Puppet.version }
end
let(:params) do
{ sources: {
'debian_unstable' => {
'location' => 'http://debian.mirror.iweb.ca/debian/',
'release' => 'unstable',
'repos' => 'main contrib non-free',
'key' => { 'id' => '150C8614919D8446E01E83AF9AA38DCD55BE302B', 'server' => 'subkeys.pgp.net' },
'pin' => '-10',
'include' => { 'src' => true },
},
'puppetlabs' => {
'location' => 'http://apt.puppetlabs.com',
'repos' => 'main',
'key' => { 'id' => '6F6B15509CF8E59E6E469F327F438280EF8D349F', 'server' => 'pgp.mit.edu' },
},
} }
end
it {
is_expected.to contain_apt__setting('list-debian_unstable').with(ensure: 'present')
}
it { is_expected.to contain_file('/etc/apt/sources.list.d/debian_unstable.list').with_content(%r{^deb http://debian.mirror.iweb.ca/debian/ unstable main contrib non-free$}) }
it { is_expected.to contain_file('/etc/apt/sources.list.d/debian_unstable.list').with_content(%r{^deb-src http://debian.mirror.iweb.ca/debian/ unstable main contrib non-free$}) }
it {
is_expected.to contain_apt__setting('list-puppetlabs').with(ensure: 'present')
}
it { is_expected.to contain_file('/etc/apt/sources.list.d/puppetlabs.list').with_content(%r{^deb http://apt.puppetlabs.com xenial main$}) }
end
context 'with confs defined on valid osfamily' do
let :facts do
{
os: { family: 'Debian', name: 'Ubuntu', release: { major: '16', full: '16.04' } },
osfamily: 'Debian',
lsbdistcodename: 'xenial',
lsbdistid: 'Debian',
puppetversion: Puppet.version,
}
end
let(:params) do
{ confs: {
'foo' => {
'content' => 'foo',
},
'bar' => {
'content' => 'bar',
},
} }
end
it {
is_expected.to contain_apt__conf('foo').with(content: 'foo')
}
it {
is_expected.to contain_apt__conf('bar').with(content: 'bar')
}
end
context 'with keys defined on valid osfamily' do
let :facts do
{
os: { family: 'Debian', name: 'Ubuntu', release: { major: '16', full: '16.04' } },
osfamily: 'Debian',
lsbdistcodename: 'xenial',
lsbdistid: 'Debian',
puppetversion: Puppet.version,
}
end
let(:params) do
{ keys: {
'55BE302B' => {
'server' => 'subkeys.pgp.net',
},
'EF8D349F' => {
'server' => 'pgp.mit.edu',
},
} }
end
it {
is_expected.to contain_apt__key('55BE302B').with(server: 'subkeys.pgp.net')
}
it {
is_expected.to contain_apt__key('EF8D349F').with(server: 'pgp.mit.edu')
}
end
context 'with ppas defined on valid osfamily' do
let :facts do
{
os: { family: 'Debian', name: 'Ubuntu', release: { major: '16', full: '16.04' } },
osfamily: 'Debian',
lsbdistcodename: 'xenial',
lsbdistid: 'ubuntu',
lsbdistrelease: '16.04',
puppetversion: Puppet.version,
}
end
let(:params) do
{ ppas: {
'ppa:drizzle-developers/ppa' => {},
'ppa:nginx/stable' => {},
} }
end
it { is_expected.to contain_apt__ppa('ppa:drizzle-developers/ppa') }
it { is_expected.to contain_apt__ppa('ppa:nginx/stable') }
end
context 'with settings defined on valid osfamily' do
let :facts do
{
os: { family: 'Debian', name: 'Ubuntu', release: { major: '16', full: '16.04' } },
osfamily: 'Debian',
lsbdistcodename: 'xenial',
lsbdistid: 'Debian',
puppetversion: Puppet.version,
}
end
let(:params) do
{ settings: {
'conf-banana' => { 'content' => 'banana' },
'pref-banana' => { 'content' => 'banana' },
} }
end
it { is_expected.to contain_apt__setting('conf-banana') }
it { is_expected.to contain_apt__setting('pref-banana') }
end
context 'with pins defined on valid osfamily' do
let :facts do
{
os: { family: 'Debian', name: 'Ubuntu', release: { major: '16', full: '16.04' } },
osfamily: 'Debian',
lsbdistcodename: 'xenial',
lsbdistid: 'Debian',
puppetversion: Puppet.version,
}
end
let(:params) do
{ pins: {
'stable' => { 'priority' => 600, 'order' => 50 },
'testing' => { 'priority' => 700, 'order' => 100 },
} }
end
it { is_expected.to contain_apt__pin('stable') }
it { is_expected.to contain_apt__pin('testing') }
end
describe 'failing tests' do
context "with purge['sources.list']=>'banana'" do
let(:params) { { purge: { 'sources.list' => 'banana' } } }
it do
is_expected.to raise_error(Puppet::Error)
end
end
context "with purge['sources.list.d']=>'banana'" do
let(:params) { { purge: { 'sources.list.d' => 'banana' } } }
it do
is_expected.to raise_error(Puppet::Error)
end
end
context "with purge['preferences']=>'banana'" do
let(:params) { { purge: { 'preferences' => 'banana' } } }
it do
is_expected.to raise_error(Puppet::Error)
end
end
context "with purge['preferences.d']=>'banana'" do
let(:params) { { purge: { 'preferences.d' => 'banana' } } }
it do
is_expected.to raise_error(Puppet::Error)
end
end
end
end

152
modules/utilities/unix/package_management/apt/spec/classes/apt_update_spec.rb
View File

@@ -1,152 +0,0 @@
require 'spec_helper'
describe 'apt::update', type: :class do
context "when apt::update['frequency']='always'" do
{
'a recent run' => Time.now.to_i,
'we are due for a run' => 1_406_660_561,
'the update-success-stamp file does not exist' => -1,
}.each_pair do |desc, factval|
context "when $::apt_update_last_success indicates #{desc}" do
let(:facts) do
{
os: { family: 'Debian', name: 'Debian', release: { major: '8', full: '8.0' } },
lsbdistid: 'Debian',
osfamily: 'Debian',
apt_update_last_success: factval,
lsbdistcodename: 'jessie',
puppetversion: Puppet.version,
}
end
let(:pre_condition) do
"class{'::apt': update => {'frequency' => 'always' },}"
end
it 'triggers an apt-get update run' do
# set the apt_update exec's refreshonly attribute to false
is_expected.to contain_exec('apt_update').with('refreshonly' => false)
end
end
end
context 'when $::apt_update_last_success is nil' do
let(:facts) do
{
os: { family: 'Debian', name: 'Debian', release: { major: '8', full: '8.0' } },
lsbdistid: 'Debian',
osfamily: 'Debian',
lsbdistcodename: 'jessie',
puppetversion: Puppet.version,
}
end
let(:pre_condition) { "class{ '::apt': update => {'frequency' => 'always' },}" }
it 'triggers an apt-get update run' do
# set the apt_update exec\'s refreshonly attribute to false
is_expected.to contain_exec('apt_update').with('refreshonly' => false)
end
end
end
context "when apt::update['frequency']='reluctantly'" do
{
'a recent run' => Time.now.to_i,
'we are due for a run' => 1_406_660_561,
'the update-success-stamp file does not exist' => -1,
}.each_pair do |desc, factval|
context "when $::apt_update_last_success indicates #{desc}" do
let(:facts) do
{
os: { family: 'Debian', name: 'Debian', release: { major: '8', full: '8.0' } },
lsbdistid: 'Debian',
osfamily: 'Debian',
apt_update_last_success: factval,
lsbdistcodename: 'jessie',
puppetversion: Puppet.version,
}
end
let(:pre_condition) { "class{ '::apt': update => {'frequency' => 'reluctantly' },}" }
it 'does not trigger an apt-get update run' do
# don't change the apt_update exec's refreshonly attribute. (it should be true)
is_expected.to contain_exec('apt_update').with('refreshonly' => true)
end
end
end
context 'when $::apt_update_last_success is nil' do
let(:facts) do
{
os: { family: 'Debian', name: 'Debian', release: { major: '8', full: '8.0' } },
lsbdistid: 'Debian',
osfamily: 'Debian',
lsbdistcodename: 'jessie',
puppetversion: Puppet.version,
}
end
let(:pre_condition) { "class{ '::apt': update => {'frequency' => 'reluctantly' },}" }
it 'does not trigger an apt-get update run' do
# don't change the apt_update exec's refreshonly attribute. (it should be true)
is_expected.to contain_exec('apt_update').with('refreshonly' => true)
end
end
end
['daily', 'weekly'].each do |update_frequency|
context "when apt::update['frequency'] has the value of #{update_frequency}" do
{ 'we are due for a run' => 1_406_660_561, 'the update-success-stamp file does not exist' => -1 }.each_pair do |desc, factval|
context "when $::apt_update_last_success indicates #{desc}" do
let(:facts) do
{
os: { family: 'Debian', name: 'Debian', release: { major: '8', full: '8.0' } },
lsbdistid: 'Debian',
osfamily: 'Debian',
apt_update_last_success: factval,
lsbdistcodename: 'jessie',
puppetversion: Puppet.version,
}
end
let(:pre_condition) { "class{ '::apt': update => {'frequency' => '#{update_frequency}',} }" }
it 'triggers an apt-get update run' do
# set the apt_update exec\'s refreshonly attribute to false
is_expected.to contain_exec('apt_update').with('refreshonly' => false)
end
end
end
context 'when the $::apt_update_last_success fact has a recent value' do
let(:facts) do
{
os: { family: 'Debian', name: 'Debian', release: { major: '8', full: '8.0' } },
lsbdistid: 'Debian',
osfamily: 'Debian',
lsbdistcodename: 'jessie',
apt_update_last_success: Time.now.to_i,
puppetversion: Puppet.version,
}
end
let(:pre_condition) { "class{ '::apt': update => {'frequency' => '#{update_frequency}',} }" }
it 'does not trigger an apt-get update run' do
# don't change the apt_update exec\'s refreshonly attribute. (it should be true)
is_expected.to contain_exec('apt_update').with('refreshonly' => true)
end
end
context 'when $::apt_update_last_success is nil' do
let(:facts) do
{
os: { family: 'Debian', name: 'Debian', release: { major: '8', full: '8.0' } },
lsbdistid: 'Debian',
osfamily: 'Debian',
lsbdistcodename: 'jessie',
apt_update_last_success: nil,
puppetversion: Puppet.version,
}
end
let(:pre_condition) { "class{ '::apt': update => {'frequency' => '#{update_frequency}',} }" }
it 'triggers an apt-get update run' do
# set the apt_update exec\'s refreshonly attribute to false
is_expected.to contain_exec('apt_update').with('refreshonly' => false)
end
end
end
end
end

8
modules/utilities/unix/package_management/apt/spec/default_facts.yml
View File

@@ -1,8 +0,0 @@
# Use default_module_facts.yml for module specific facts.
#
# Facts specified here will override the values provided by rspec-puppet-facts.
---
concat_basedir: ""
ipaddress: "172.16.254.254"
is_pe: false
macaddress: "AA:AA:AA:AA:AA:AA"

90
modules/utilities/unix/package_management/apt/spec/defines/conf_spec.rb
View File

@@ -1,90 +0,0 @@
require 'spec_helper'
describe 'apt::conf', type: :define do
let :pre_condition do
'class { "apt": }'
end
let(:facts) do
{
os: { family: 'Debian', name: 'Debian', release: { major: '8', full: '8.0' } },
lsbdistid: 'Debian',
osfamily: 'Debian',
lsbdistcodename: 'jessie',
puppetversion: Puppet.version,
}
end
let :title do
'norecommends'
end
describe 'when creating an apt preference' do
let :default_params do
{
priority: '00',
content: "Apt::Install-Recommends 0;\nApt::AutoRemove::InstallRecommends 1;\n",
}
end
let :params do
default_params
end
let :filename do
'/etc/apt/apt.conf.d/00norecommends'
end
it {
is_expected.to contain_file(filename).with('ensure' => 'present',
'content' => %r{Apt::Install-Recommends 0;\nApt::AutoRemove::InstallRecommends 1;},
'owner' => 'root',
'group' => 'root',
'mode' => '0644')
}
context 'with notify_update = true (default)' do
let :params do
default_params
end
it { is_expected.to contain_apt__setting("conf-#{title}").with_notify_update(true) }
end
context 'with notify_update = false' do
let :params do
default_params.merge(notify_update: false)
end
it { is_expected.to contain_apt__setting("conf-#{title}").with_notify_update(false) }
end
end
describe 'when creating a preference without content' do
let :params do
{
priority: '00',
}
end
it 'fails' do
is_expected.to raise_error(%r{pass in content})
end
end
describe 'when removing an apt preference' do
let :params do
{
ensure: 'absent',
priority: '00',
}
end
let :filename do
'/etc/apt/apt.conf.d/00norecommends'
end
it {
is_expected.to contain_file(filename).with('ensure' => 'absent',
'owner' => 'root',
'group' => 'root',
'mode' => '0644')
}
end
end

360
modules/utilities/unix/package_management/apt/spec/defines/key_compat_spec.rb
View File

@@ -1,360 +0,0 @@
require 'spec_helper'
def contains_apt_key_example(title)
{ id: title,
ensure: 'present',
source: 'http://apt.puppetlabs.com/pubkey.gpg',
server: 'pgp.mit.edu',
content: params[:content],
options: 'debug' }
end
def apt_key_example(title)
{ id: title,
ensure: 'present',
source: nil,
server: 'keyserver.ubuntu.com',
content: nil,
keyserver_options: nil }
end
describe 'apt::key', type: :define do
GPG_KEY_ID = '6F6B15509CF8E59E6E469F327F438280EF8D349F'.freeze
let(:facts) do
{
os: { family: 'Debian', name: 'Debian', release: { major: '8', full: '8.0' } },
lsbdistid: 'Debian',
osfamily: 'Debian',
puppetversion: Puppet.version,
}
end
let :title do
GPG_KEY_ID
end
let :pre_condition do
'include apt'
end
describe 'normal operation' do
describe 'default options' do
it {
is_expected.to contain_apt_key(title).with(id: title,
ensure: 'present',
source: nil,
server: 'keyserver.ubuntu.com',
content: nil)
}
it 'contains the apt_key present anchor' do
is_expected.to contain_anchor("apt_key #{title} present")
end
end
describe 'title and key =>' do
let :title do
'puppetlabs'
end
let :params do
{
id: GPG_KEY_ID,
}
end
it 'contains the apt_key' do
is_expected.to contain_apt_key(title).with(id: GPG_KEY_ID,
ensure: 'present',
source: nil,
server: 'keyserver.ubuntu.com',
content: nil)
end
it 'contains the apt_key present anchor' do
is_expected.to contain_anchor("apt_key #{GPG_KEY_ID} present")
end
end
describe 'ensure => absent' do
let :params do
{
ensure: 'absent',
}
end
it 'contains the apt_key' do
is_expected.to contain_apt_key(title).with(id: title,
ensure: 'absent',
source: nil,
server: 'keyserver.ubuntu.com',
content: nil)
end
it 'contains the apt_key absent anchor' do
is_expected.to contain_anchor("apt_key #{title} absent")
end
end
describe 'set a bunch of things!' do
let :params do
{
content: 'GPG key content',
source: 'http://apt.puppetlabs.com/pubkey.gpg',
server: 'pgp.mit.edu',
options: 'debug',
}
end
it 'contains the apt_key' do
is_expected.to contain_apt_key(title).with(contains_apt_key_example(title))
end
it 'contains the apt_key present anchor' do
is_expected.to contain_anchor("apt_key #{title} present")
end
end
context 'when domain has dash' do
let(:params) do
{
server: 'p-gp.m-it.edu',
}
end
it 'contains the apt_key' do
is_expected.to contain_apt_key(title).with(id: title,
server: 'p-gp.m-it.edu')
end
end
context 'with url' do
let :params do
{
server: 'hkp://pgp.mit.edu',
}
end
it 'contains the apt_key' do
is_expected.to contain_apt_key(title).with(id: title,
server: 'hkp://pgp.mit.edu')
end
end
context 'with url and port number' do
let :params do
{
server: 'hkp://pgp.mit.edu:80',
}
end
it 'contains the apt_key' do
is_expected.to contain_apt_key(title).with(id: title,
server: 'hkp://pgp.mit.edu:80')
end
end
end
describe 'validation' do
context 'when domain begins with a dash' do
let(:params) do
{
server: '-pgp.mit.edu',
}
end
it 'fails' do
is_expected .to raise_error(%r{expects a match})
end
end
context 'when domain begins with dot' do
let(:params) do
{
server: '.pgp.mit.edu',
}
end
it 'fails' do
is_expected .to raise_error(%r{expects a match})
end
end
context 'when domain ends with dot' do
let(:params) do
{
server: 'pgp.mit.edu.',
}
end
it 'fails' do
is_expected .to raise_error(%r{expects a match})
end
end
context 'when url character limit is exceeded' do
let :params do
{
server: 'hkp://pgpiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiii.mit.edu',
}
end
it 'fails' do
is_expected.to raise_error(%r{expects a match})
end
end
context 'with incorrect port number url' do
let :params do
{
server: 'hkp://pgp.mit.edu:8008080',
}
end
it 'fails' do
is_expected.to raise_error(%r{expects a match})
end
end
context 'with incorrect protocol for url' do
let :params do
{
server: 'abc://pgp.mit.edu:80',
}
end
it 'fails' do
is_expected.to raise_error(%r{expects a match})
end
end
context 'with missing port number url' do
let :params do
{
server: 'hkp://pgp.mit.edu:',
}
end
it 'fails' do
is_expected.to raise_error(%r{expects a match})
end
end
context 'with url ending with a dot' do
let :params do
{
server: 'hkp://pgp.mit.edu.',
}
end
it 'fails' do
is_expected.to raise_error(%r{expects a match})
end
end
context 'with url begin with a dash' do
let(:params) do
{
server: 'hkp://-pgp.mit.edu',
}
end
it 'fails' do
is_expected.to raise_error(%r{expects a match})
end
end
context 'with invalid key' do
let :title do
'Out of rum. Why? Why are we out of rum?'
end
it 'fails' do
is_expected.to raise_error(%r{expects a match})
end
end
context 'with invalid source' do
let :params do
{
source: 'afp://puppetlabs.com/key.gpg',
}
end
it 'fails' do
is_expected.to raise_error(%r{evaluating a Resource})
end
end
context 'with invalid content' do
let :params do
{
content: [],
}
end
it 'fails' do
is_expected.to raise_error(%r{expects a})
end
end
context 'with invalid server' do
let :params do
{
server: 'two bottles of rum',
}
end
it 'fails' do
is_expected.to raise_error(%r{expects a match})
end
end
context 'with invalid keyserver_options' do
let :params do
{
options: {},
}
end
it 'fails' do
is_expected.to raise_error(%r{expects a})
end
end
context 'with invalid ensure' do
let :params do
{
ensure: 'foo',
}
end
it 'fails' do
is_expected.to raise_error(%r{Enum\['absent', 'present', 'refreshed'\]})
end
end
describe 'duplication - two apt::key resources for same key, different titles' do
let :pre_condition do
"#{super()}\napt::key { 'duplicate': id => '#{title}', }"
end
it 'contains the duplicate apt::key resource' do
is_expected.to contain_apt__key('duplicate').with(id: title,
ensure: 'present')
end
it 'contains the original apt::key resource' do
is_expected.to contain_apt__key(title).with(id: title,
ensure: 'present')
end
it 'contains the native apt_key' do
is_expected.to contain_apt_key('duplicate').with(apt_key_example(title))
end
it 'does not contain the original apt_key' do
is_expected.not_to contain_apt_key(title)
end
end
describe 'duplication - two apt::key resources, different ensure' do
let :pre_condition do
"#{super()}\napt::key { 'duplicate': id => '#{title}', ensure => 'absent', }"
end
it 'informs the user of the impossibility' do
is_expected.to raise_error(%r{already ensured as absent})
end
end
end
end

383
modules/utilities/unix/package_management/apt/spec/defines/key_spec.rb
View File

@@ -1,383 +0,0 @@
require 'spec_helper'
GPG_KEY_ID = '6F6B15509CF8E59E6E469F327F438280EF8D349F'.freeze
title_key_example = { id: GPG_KEY_ID,
ensure: 'present',
source: nil,
server: 'keyserver.ubuntu.com',
content: nil,
options: nil }
def default_apt_key_example(title)
{ id: title,
ensure: 'present',
source: nil,
server: 'keyserver.ubuntu.com',
content: nil,
options: nil,
refresh: false }
end
def bunch_things_apt_key_example(title, params)
{ id: title,
ensure: 'present',
source: 'http://apt.puppetlabs.com/pubkey.gpg',
server: 'pgp.mit.edu',
content: params[:content],
options: 'debug' }
end
def absent_apt_key(title)
{ id: title,
ensure: 'absent',
source: nil,
server: 'keyserver.ubuntu.com',
content: nil,
keyserver: nil }
end
describe 'apt::key' do
let :pre_condition do
'class { "apt": }'
end
let(:facts) do
{
os: { family: 'Debian', name: 'Debian', release: { major: '8', full: '8.0' } },
lsbdistid: 'Debian',
osfamily: 'Debian',
lsbdistcodename: 'jessie',
puppetversion: Puppet.version,
}
end
let :title do
GPG_KEY_ID
end
describe 'normal operation' do
describe 'default options' do
it 'contains the apt_key' do
is_expected.to contain_apt_key(title).with(default_apt_key_example(title))
end
it 'contains the apt_key present anchor' do
is_expected.to contain_anchor("apt_key #{title} present")
end
end
describe 'title and key =>' do
let :title do
'puppetlabs'
end
let :params do
{
id: GPG_KEY_ID,
}
end
it 'contains the apt_key' do
is_expected.to contain_apt_key(title).with(title_key_example)
end
it 'contains the apt_key present anchor' do
is_expected.to contain_anchor("apt_key #{GPG_KEY_ID} present")
end
end
describe 'ensure => absent' do
let :params do
{
ensure: 'absent',
}
end
it 'contains the apt_key' do
is_expected.to contain_apt_key(title).with(absent_apt_key(title))
end
it 'contains the apt_key absent anchor' do
is_expected.to contain_anchor("apt_key #{title} absent")
end
end
describe 'ensure => refreshed' do
let :params do
{
ensure: 'refreshed',
}
end
it 'contains the apt_key with refresh => true' do
is_expected.to contain_apt_key(title).with(
ensure: 'present',
refresh: true,
)
end
end
describe 'set a bunch of things!' do
let :params do
{
content: 'GPG key content',
source: 'http://apt.puppetlabs.com/pubkey.gpg',
server: 'pgp.mit.edu',
options: 'debug',
}
end
it 'contains the apt_key' do
is_expected.to contain_apt_key(title).with(bunch_things_apt_key_example(title, params))
end
it 'contains the apt_key present anchor' do
is_expected.to contain_anchor("apt_key #{title} present")
end
end
context 'when domain with dash' do
let(:params) do
{
server: 'p-gp.m-it.edu',
}
end
it 'contains the apt_key' do
is_expected.to contain_apt_key(title).with(id: title,
server: 'p-gp.m-it.edu')
end
end
context 'with url' do
let :params do
{
server: 'hkp://pgp.mit.edu',
}
end
it 'contains the apt_key' do
is_expected.to contain_apt_key(title).with(id: title,
server: 'hkp://pgp.mit.edu')
end
end
context 'when url with port number' do
let :params do
{
server: 'hkp://pgp.mit.edu:80',
}
end
it 'contains the apt_key' do
is_expected.to contain_apt_key(title).with(id: title,
server: 'hkp://pgp.mit.edu:80')
end
end
end
describe 'validation' do
context 'when domain begin with dash' do
let(:params) do
{
server: '-pgp.mit.edu',
}
end
it 'fails' do
is_expected .to raise_error(%r{expects a match})
end
end
context 'when domain begin with dot' do
let(:params) do
{
server: '.pgp.mit.edu',
}
end
it 'fails' do
is_expected .to raise_error(%r{expects a match})
end
end
context 'when domain end with dot' do
let(:params) do
{
server: 'pgp.mit.edu.',
}
end
it 'fails' do
is_expected .to raise_error(%r{expects a match})
end
end
context 'when character url exceeded' do
let :params do
{
server: 'hkp://pgpiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiii.mit.edu',
}
end
it 'fails' do
is_expected.to raise_error(%r{expects a match})
end
end
context 'with incorrect port number url' do
let :params do
{
server: 'hkp://pgp.mit.edu:8008080',
}
end
it 'fails' do
is_expected.to raise_error(%r{expects a match})
end
end
context 'with incorrect protocol for url' do
let :params do
{
server: 'abc://pgp.mit.edu:80',
}
end
it 'fails' do
is_expected.to raise_error(%r{expects a match})
end
end
context 'with missing port number url' do
let :params do
{
server: 'hkp://pgp.mit.edu:',
}
end
it 'fails' do
is_expected.to raise_error(%r{expects a match})
end
end
context 'with url ending with a dot' do
let :params do
{
server: 'hkp://pgp.mit.edu.',
}
end
it 'fails' do
is_expected.to raise_error(%r{expects a match})
end
end
context 'when url begins with a dash' do
let(:params) do
{
server: 'hkp://-pgp.mit.edu',
}
end
it 'fails' do
is_expected.to raise_error(%r{expects a match})
end
end
context 'with invalid key' do
let :title do
'Out of rum. Why? Why are we out of rum?'
end
it 'fails' do
is_expected.to raise_error(%r{expects a match})
end
end
context 'with invalid source' do
let :params do
{
source: 'afp://puppetlabs.com/key.gpg',
}
end
it 'fails' do
is_expected.to raise_error(%r{evaluating a Resource})
end
end
context 'with invalid content' do
let :params do
{
content: [],
}
end
it 'fails' do
is_expected.to raise_error(%r{expects a})
end
end
context 'with invalid server' do
let :params do
{
server: 'two bottles of rum',
}
end
it 'fails' do
is_expected.to raise_error(%r{expects a match})
end
end
context 'with invalid options' do
let :params do
{
options: {},
}
end
it 'fails' do
is_expected.to raise_error(%r{expects a})
end
end
context 'with invalid ensure' do
['foo', 'aabsent', 'absenta', 'apresent', 'presenta', 'refresh', 'arefreshed', 'refresheda'].each do |param|
let :params do
{
ensure: param,
}
end
it 'fails' do
is_expected.to raise_error(%r{for Enum\['absent', 'present', 'refreshed'\], got})
end
end
end
describe 'duplication - two apt::key resources for same key, different titles' do
let :pre_condition do
"class { 'apt': }
apt::key { 'duplicate': id => '#{title}', }"
end
it 'contains two apt::key resource - duplicate' do
is_expected.to contain_apt__key('duplicate').with(id: title,
ensure: 'present')
end
it 'contains two apt::key resource - title' do
is_expected.to contain_apt__key(title).with(id: title,
ensure: 'present')
end
it 'contains only a single apt_key - duplicate' do
is_expected.to contain_apt_key('duplicate').with(default_apt_key_example(title))
end
it 'contains only a single apt_key - no title' do
is_expected.not_to contain_apt_key(title)
end
end
describe 'duplication - two apt::key resources, different ensure' do
let :pre_condition do
"class { 'apt': }
apt::key { 'duplicate': id => '#{title}', ensure => 'absent', }"
end
it 'informs the user of the impossibility' do
is_expected.to raise_error(%r{already ensured as absent})
end
end
end
end

148
modules/utilities/unix/package_management/apt/spec/defines/pin_spec.rb
View File

@@ -1,148 +0,0 @@
require 'spec_helper'
describe 'apt::pin', type: :define do
let :pre_condition do
'class { "apt": }'
end
let(:facts) do
{
os: { family: 'Debian', name: 'Debian', release: { major: '8', full: '8.0' } },
lsbdistid: 'Debian',
osfamily: 'Debian',
lsbdistcodename: 'jessie',
puppetversion: Puppet.version,
}
end
let(:title) { 'my_pin' }
context 'with defaults' do
it { is_expected.to contain_apt__setting('pref-my_pin').with_content(%r{Explanation: : my_pin\nPackage: \*\nPin: release a=my_pin\nPin-Priority: 0\n}) }
end
context 'with set version' do
let :params do
{
'packages' => 'vim',
'version' => '1',
}
end
it { is_expected.to contain_apt__setting('pref-my_pin').with_content(%r{Explanation: : my_pin\nPackage: vim\nPin: version 1\nPin-Priority: 0\n}) }
end
context 'with set origin' do
let :params do
{
'packages' => 'vim',
'origin' => 'test',
}
end
it { is_expected.to contain_apt__setting('pref-my_pin').with_content(%r{Explanation: : my_pin\nPackage: vim\nPin: origin test\nPin-Priority: 0\n}) }
end
context 'without defaults' do
let :params do
{
'explanation' => 'foo',
'order' => 99,
'release' => '1',
'codename' => 'bar',
'release_version' => '2',
'component' => 'baz',
'originator' => 'foobar',
'label' => 'foobaz',
'priority' => 10,
}
end
it { is_expected.to contain_apt__setting('pref-my_pin').with_content(%r{Explanation: foo\nPackage: \*\nPin: release a=1, n=bar, v=2, c=baz, o=foobar, l=foobaz\nPin-Priority: 10\n}) }
it {
is_expected.to contain_apt__setting('pref-my_pin').with('priority' => 99)
}
end
context 'with ensure absent' do
let :params do
{
'ensure' => 'absent',
}
end
it {
is_expected.to contain_apt__setting('pref-my_pin').with('ensure' => 'absent')
}
end
context 'with bad characters' do
let(:title) { 'such bad && wow!' }
it { is_expected.to contain_apt__setting('pref-such__bad____wow_') }
end
describe 'validation' do
context 'with invalid order' do
let :params do
{
'order' => 'foo',
}
end
it do
is_expected.to raise_error(Puppet::Error, %r{expects an Integer value, got String})
end
end
context 'with packages == * and version' do
let :params do
{
'version' => '1',
}
end
it do
is_expected.to raise_error(Puppet::Error, %r{parameter version cannot be used in general form})
end
end
context 'with packages == * and release and origin' do
let :params do
{
'origin' => 'test',
'release' => 'foo',
}
end
it do
is_expected.to raise_error(Puppet::Error, %r{parameters release and origin are mutually exclusive})
end
end
context 'with specific release and origin' do
let :params do
{
'release' => 'foo',
'origin' => 'test',
'packages' => 'vim',
}
end
it do
is_expected.to raise_error(Puppet::Error, %r{parameters release, origin, and version are mutually exclusive})
end
end
context 'with specific version and origin' do
let :params do
{
'version' => '1',
'origin' => 'test',
'packages' => 'vim',
}
end
it do
is_expected.to raise_error(Puppet::Error, %r{parameters release, origin, and version are mutually exclusive})
end
end
end
end

339
modules/utilities/unix/package_management/apt/spec/defines/ppa_spec.rb
View File

@@ -1,339 +0,0 @@
require 'spec_helper'
describe 'apt::ppa' do
let :pre_condition do
'class { "apt": }'
end
describe 'defaults' do
let :facts do
{
os: { family: 'Debian', name: 'Ubuntu', release: { major: '14', full: '41.04' } },
lsbdistrelease: '14.04',
lsbdistcodename: 'trusty',
operatingsystem: 'Ubuntu',
osfamily: 'Debian',
lsbdistid: 'Ubuntu',
puppetversion: Puppet.version,
}
end
let(:title) { 'ppa:needs/such.substitution/wow+type' }
it { is_expected.not_to contain_package('python-software-properties') }
it {
is_expected.to contain_exec('add-apt-repository-ppa:needs/such.substitution/wow+type').that_notifies('Class[Apt::Update]').with(environment: [],
command: '/usr/bin/add-apt-repository -y ppa:needs/such.substitution/wow+type || (rm /etc/apt/sources.list.d/needs-such_substitution-wow_type-trusty.list && false)', # rubocop:disable Metrics/LineLength
unless: '/usr/bin/test -f /etc/apt/sources.list.d/needs-such_substitution-wow_type-trusty.list && /usr/bin/test -f /etc/apt/trusted.gpg.d/needs-such_substitution-wow_type.gpg', # rubocop:disable Metrics/LineLength
user: 'root',
logoutput: 'on_failure')
}
end
describe 'Ubuntu 15.10 sources.list filename' do
let :facts do
{
os: { family: 'Debian', name: 'Ubuntu', release: { major: '15', full: '15.10' } },
lsbdistrelease: '15.10',
lsbdistcodename: 'wily',
operatingsystem: 'Ubuntu',
osfamily: 'Debian',
lsbdistid: 'Ubuntu',
puppetversion: Puppet.version,
}
end
let(:title) { 'ppa:user/foo' }
it {
is_expected.to contain_exec('add-apt-repository-ppa:user/foo').that_notifies('Class[Apt::Update]').with(environment: [],
command: '/usr/bin/add-apt-repository -y ppa:user/foo || (rm /etc/apt/sources.list.d/user-ubuntu-foo-wily.list && false)', # rubocop:disable Metrics/LineLength
unless: '/usr/bin/test -f /etc/apt/sources.list.d/user-ubuntu-foo-wily.list && /usr/bin/test -f /etc/apt/trusted.gpg.d/user_ubuntu_foo.gpg', # rubocop:disable Metrics/LineLength
user: 'root',
logoutput: 'on_failure')
}
end
describe 'package_name => software-properties-common' do
let :pre_condition do
'class { "apt": }'
end
let :params do
{
package_name: 'software-properties-common',
package_manage: true,
}
end
let :facts do
{
os: { family: 'Debian', name: 'Ubuntu', release: { major: '14', full: '14.04' } },
lsbdistrelease: '14.04',
lsbdistcodename: 'trusty',
operatingsystem: 'Ubuntu',
osfamily: 'Debian',
lsbdistid: 'Ubuntu',
puppetversion: Puppet.version,
}
end
let(:title) { 'ppa:needs/such.substitution/wow' }
it { is_expected.to contain_package('software-properties-common') }
it {
is_expected.to contain_exec('add-apt-repository-ppa:needs/such.substitution/wow').that_notifies('Class[Apt::Update]').with('environment' => [],
'command' => '/usr/bin/add-apt-repository -y ppa:needs/such.substitution/wow || (rm /etc/apt/sources.list.d/needs-such_substitution-wow-trusty.list && false)', # rubocop:disable Metrics/LineLength
'unless' => '/usr/bin/test -f /etc/apt/sources.list.d/needs-such_substitution-wow-trusty.list && /usr/bin/test -f /etc/apt/trusted.gpg.d/needs-such_substitution-wow.gpg', # rubocop:disable Metrics/LineLength
'user' => 'root',
'logoutput' => 'on_failure')
}
it {
is_expected.to contain_file('/etc/apt/sources.list.d/needs-such_substitution-wow-trusty.list').that_requires('Exec[add-apt-repository-ppa:needs/such.substitution/wow]').with('ensure' => 'file')
}
end
describe 'package_manage => false' do
let :pre_condition do
'class { "apt": }'
end
let :facts do
{
os: { family: 'Debian', name: 'Ubuntu', release: { major: '14', full: '14.04' } },
lsbdistrelease: '14.04',
lsbdistcodename: 'trusty',
operatingsystem: 'Ubuntu',
osfamily: 'Debian',
lsbdistid: 'Ubuntu',
puppetversion: Puppet.version,
}
end
let :params do
{
package_manage: false,
}
end
let(:title) { 'ppa:needs/such.substitution/wow' }
it { is_expected.not_to contain_package('python-software-properties') }
it {
is_expected.to contain_exec('add-apt-repository-ppa:needs/such.substitution/wow').that_notifies('Class[Apt::Update]').with('environment' => [],
'command' => '/usr/bin/add-apt-repository -y ppa:needs/such.substitution/wow || (rm /etc/apt/sources.list.d/needs-such_substitution-wow-trusty.list && false)', # rubocop:disable Metrics/LineLength
'unless' => '/usr/bin/test -f /etc/apt/sources.list.d/needs-such_substitution-wow-trusty.list && /usr/bin/test -f /etc/apt/trusted.gpg.d/needs-such_substitution-wow.gpg', # rubocop:disable Metrics/LineLength
'user' => 'root',
'logoutput' => 'on_failure')
}
it {
is_expected.to contain_file('/etc/apt/sources.list.d/needs-such_substitution-wow-trusty.list').that_requires('Exec[add-apt-repository-ppa:needs/such.substitution/wow]').with('ensure' => 'file')
}
end
describe 'apt included, no proxy' do
let :pre_condition do
'class { "apt": }
apt::ppa { "ppa:user/foo2": }
'
end
let :facts do
{
os: { family: 'Debian', name: 'Ubuntu', release: { major: '14', full: '14.04' } },
lsbdistrelease: '14.04',
lsbdistcodename: 'trusty',
operatingsystem: 'Ubuntu',
lsbdistid: 'Ubuntu',
osfamily: 'Debian',
puppetversion: Puppet.version,
}
end
let :params do
{
options: '',
package_manage: true,
require: 'Apt::Ppa[ppa:user/foo2]',
}
end
let(:title) { 'ppa:user/foo' }
it { is_expected.to compile.with_all_deps }
it { is_expected.to contain_package('software-properties-common') }
it {
is_expected.to contain_exec('add-apt-repository-ppa:user/foo').that_notifies('Class[Apt::Update]').with(environment: [],
command: '/usr/bin/add-apt-repository ppa:user/foo || (rm /etc/apt/sources.list.d/user-foo-trusty.list && false)', # rubocop:disable Metrics/LineLength
unless: '/usr/bin/test -f /etc/apt/sources.list.d/user-foo-trusty.list && /usr/bin/test -f /etc/apt/trusted.gpg.d/user-foo.gpg', # rubocop:disable Metrics/LineLength
user: 'root',
logoutput: 'on_failure')
}
end
describe 'apt included, proxy host' do
let :pre_condition do
'class { "apt":
proxy => { "host" => "localhost" },
}'
end
let :facts do
{
os: { family: 'Debian', name: 'Ubuntu', release: { major: '14', full: '14.04' } },
lsbdistrelease: '14.04',
lsbdistcodename: 'trusty',
operatingsystem: 'Ubuntu',
lsbdistid: 'Ubuntu',
osfamily: 'Debian',
puppetversion: Puppet.version,
}
end
let :params do
{
'options' => '',
'package_manage' => true,
}
end
let(:title) { 'ppa:user/foo' }
it { is_expected.to contain_package('software-properties-common') }
it {
is_expected.to contain_exec('add-apt-repository-ppa:user/foo').that_notifies('Class[Apt::Update]').with(environment: ['http_proxy=http://localhost:8080'],
command: '/usr/bin/add-apt-repository ppa:user/foo || (rm /etc/apt/sources.list.d/user-foo-trusty.list && false)', # rubocop:disable Metrics/LineLength
unless: '/usr/bin/test -f /etc/apt/sources.list.d/user-foo-trusty.list && /usr/bin/test -f /etc/apt/trusted.gpg.d/user-foo.gpg', # rubocop:disable Metrics/LineLength
user: 'root',
logoutput: 'on_failure')
}
end
describe 'apt included, proxy host and port' do
let :pre_condition do
'class { "apt":
proxy => { "host" => "localhost", "port" => 8180 },
}'
end
let :facts do
{
os: { family: 'Debian', name: 'Ubuntu', release: { major: '14', full: '14.04' } },
lsbdistrelease: '14.04',
lsbdistcodename: 'trusty',
operatingsystem: 'Ubuntu',
lsbdistid: 'Ubuntu',
osfamily: 'Debian',
puppetversion: Puppet.version,
}
end
let :params do
{
options: '',
package_manage: true,
}
end
let(:title) { 'ppa:user/foo' }
it { is_expected.to contain_package('software-properties-common') }
it {
is_expected.to contain_exec('add-apt-repository-ppa:user/foo').that_notifies('Class[Apt::Update]').with(environment: ['http_proxy=http://localhost:8180'],
command: '/usr/bin/add-apt-repository ppa:user/foo || (rm /etc/apt/sources.list.d/user-foo-trusty.list && false)', # rubocop:disable Metrics/LineLength
unless: '/usr/bin/test -f /etc/apt/sources.list.d/user-foo-trusty.list && /usr/bin/test -f /etc/apt/trusted.gpg.d/user-foo.gpg', # rubocop:disable Metrics/LineLength
user: 'root',
logoutput: 'on_failure')
}
end
describe 'apt included, proxy host and port and https' do
let :pre_condition do
'class { "apt":
proxy => { "host" => "localhost", "port" => 8180, "https" => true },
}'
end
let :facts do
{
os: { family: 'Debian', name: 'Ubuntu', release: { major: '14', full: '14.04' } },
lsbdistrelease: '14.04',
lsbdistcodename: 'trusty',
operatingsystem: 'Ubuntu',
lsbdistid: 'Ubuntu',
osfamily: 'Debian',
puppetversion: Puppet.version,
}
end
let :params do
{
options: '',
package_manage: true,
}
end
let(:title) { 'ppa:user/foo' }
it { is_expected.to contain_package('software-properties-common') }
it {
is_expected.to contain_exec('add-apt-repository-ppa:user/foo').that_notifies('Class[Apt::Update]').with(environment: ['http_proxy=http://localhost:8180', 'https_proxy=https://localhost:8180'],
command: '/usr/bin/add-apt-repository ppa:user/foo || (rm /etc/apt/sources.list.d/user-foo-trusty.list && false)', # rubocop:disable Metrics/LineLength
unless: '/usr/bin/test -f /etc/apt/sources.list.d/user-foo-trusty.list && /usr/bin/test -f /etc/apt/trusted.gpg.d/user-foo.gpg', # rubocop:disable Metrics/LineLength
user: 'root',
logoutput: 'on_failure')
}
end
describe 'ensure absent' do
let :pre_condition do
'class { "apt": }'
end
let :facts do
{
os: { family: 'Debian', name: 'Ubuntu', release: { major: '14', full: '14.04' } },
lsbdistrelease: '14.04',
lsbdistcodename: 'trusty',
operatingsystem: 'Ubuntu',
lsbdistid: 'Ubuntu',
osfamily: 'Debian',
puppetversion: Puppet.version,
}
end
let(:title) { 'ppa:user/foo' }
let :params do
{
ensure: 'absent',
}
end
it {
is_expected.to contain_file('/etc/apt/sources.list.d/user-foo-trusty.list').that_notifies('Class[Apt::Update]').with(ensure: 'absent')
}
end
context 'with validation' do
describe 'no release' do
let :facts do
{
os: { family: 'Debian', name: 'Ubuntu', release: { major: '14', full: '14.04' } },
lsbdistrelease: '14.04',
operatingsystem: 'Ubuntu',
lsbdistid: 'Ubuntu',
osfamily: 'Debian',
lsbdistcodeanme: nil,
puppetversion: Puppet.version,
}
end
let(:title) { 'ppa:user/foo' }
it do
is_expected.to raise_error(Puppet::Error, %r{lsbdistcodename fact not available: release parameter required})
end
end
describe 'not ubuntu' do
let :facts do
{
os: { family: 'Debian', name: 'Debian', release: { major: '6', full: '6.0.7' } },
lsbdistrelease: '6.0.7',
lsbdistcodename: 'wheezy',
operatingsystem: 'Debian',
lsbdistid: 'debian',
osfamily: 'Debian',
puppetversion: Puppet.version,
}
end
let(:title) { 'ppa:user/foo' }
it do
is_expected.to raise_error(Puppet::Error, %r{not currently supported on Debian})
end
end
end
end

145
modules/utilities/unix/package_management/apt/spec/defines/setting_spec.rb
View File

@@ -1,145 +0,0 @@
require 'spec_helper'
describe 'apt::setting' do
let(:pre_condition) { 'class { "apt": }' }
let :facts do
{
os: { distro: { codename: 'wheezy' }, family: 'Debian', name: 'Debian', release: { major: '8', full: '8.0' } },
lsbdistrelease: '8.0',
lsbdistcodename: 'jessie',
operatingsystem: 'Debian',
osfamily: 'Debian',
lsbdistid: 'Debian',
puppetversion: Puppet.version,
}
end
let(:title) { 'conf-teddybear' }
let(:default_params) { { content: 'di' } }
describe 'when using the defaults' do
context 'without source or content' do
it do
is_expected.to raise_error(Puppet::Error, %r{needs either of })
end
end
context 'with title=conf-teddybear ' do
let(:params) { default_params }
it { is_expected.to contain_file('/etc/apt/apt.conf.d/50teddybear').that_notifies('Class[Apt::Update]') }
end
context 'with title=pref-teddybear' do
let(:title) { 'pref-teddybear' }
let(:params) { default_params }
it { is_expected.to contain_file('/etc/apt/preferences.d/teddybear.pref').that_notifies('Class[Apt::Update]') }
end
context 'with title=list-teddybear' do
let(:title) { 'list-teddybear' }
let(:params) { default_params }
it { is_expected.to contain_file('/etc/apt/sources.list.d/teddybear.list').that_notifies('Class[Apt::Update]') }
end
context 'with source' do
let(:params) { { source: 'puppet:///la/die/dah' } }
it {
is_expected.to contain_file('/etc/apt/apt.conf.d/50teddybear').that_notifies('Class[Apt::Update]').with(ensure: 'file',
owner: 'root',
group: 'root',
mode: '0644',
source: params[:source].to_s)
}
end
context 'with content' do
let(:params) { default_params }
it {
is_expected.to contain_file('/etc/apt/apt.conf.d/50teddybear').that_notifies('Class[Apt::Update]').with(ensure: 'file',
owner: 'root',
group: 'root',
mode: '0644',
content: params[:content].to_s)
}
end
end
describe 'settings requiring settings, MODULES-769' do
let(:pre_condition) do
'class { "apt": }
apt::setting { "list-teddybear": content => "foo" }
'
end
let(:facts) do
{
os: { family: 'Debian', name: 'Debian', release: { major: '8', full: '8.0' } },
lsbdistid: 'Debian',
osfamily: 'Debian',
lsbdistcodename: 'jessie',
puppetversion: Puppet.version,
}
end
let(:title) { 'conf-teddybear' }
let(:default_params) { { content: 'di' } }
let(:params) { default_params.merge(require: 'Apt::Setting[list-teddybear]') }
it { is_expected.to compile.with_all_deps }
end
describe 'when trying to pull one over' do
context 'with source and content' do
let(:params) { default_params.merge(source: 'la') }
it do
is_expected.to raise_error(Puppet::Error, %r{cannot have both })
end
end
context 'with title=ext-teddybear' do
let(:title) { 'ext-teddybear' }
let(:params) { default_params }
it do
is_expected.to raise_error(Puppet::Error, %r{must start with either})
end
end
context 'with ensure=banana' do
let(:params) { default_params.merge(ensure: 'banana') }
it do
is_expected.to raise_error(Puppet::Error, %r{Enum\['absent', 'file', 'present'\]})
end
end
context 'with priority=1.2' do
let(:params) { default_params.merge(priority: 1.2) }
if Puppet::Util::Package.versioncmp(Puppet.version, '4.0') >= 0 || ENV['FUTURE_PARSER'] == 'yes'
it { is_expected.to compile.and_raise_error(%r{expects a value of type}) }
else
it { is_expected.to compile.and_raise_error(%r{priority must be an integer or a zero-padded integer}) }
end
end
end
describe 'with priority=100' do
let(:params) { default_params.merge(priority: 100) }
it { is_expected.to contain_file('/etc/apt/apt.conf.d/100teddybear').that_notifies('Class[Apt::Update]') }
end
describe 'with ensure=absent' do
let(:params) { default_params.merge(ensure: 'absent') }
it {
is_expected.to contain_file('/etc/apt/apt.conf.d/50teddybear').that_notifies('Class[Apt::Update]').with(ensure: 'absent')
}
end
end

154
modules/utilities/unix/package_management/apt/spec/defines/source_compat_spec.rb
View File

@@ -1,154 +0,0 @@
require 'spec_helper'
describe 'apt::source', type: :define do
GPG_KEY_ID = '6F6B15509CF8E59E6E469F327F438280EF8D349F'.freeze
let :title do
'my_source'
end
context 'with mostly defaults' do
let :facts do
{
os: { family: 'Debian', name: 'Debian', release: { major: '8', full: '8.0' } },
lsbdistid: 'Debian',
lsbdistcodename: 'jessie',
osfamily: 'Debian',
puppetversion: Puppet.version,
}
end
let :params do
{
'include' => { 'deb' => false, 'src' => true },
'location' => 'http://debian.mirror.iweb.ca/debian/',
}
end
it {
is_expected.to contain_apt__setting('list-my_source').with_content(%r{# my_source\ndeb-src http://debian.mirror.iweb.ca/debian/ jessie main\n})
}
end
context 'with no defaults' do
let :facts do
{
os: { family: 'Debian', name: 'Debian', release: { major: '8', full: '8.0' } },
lsbdistid: 'Debian',
lsbdistcodename: 'jessie',
osfamily: 'Debian',
puppetversion: Puppet.version,
}
end
let :params do
{
'comment' => 'foo',
'location' => 'http://debian.mirror.iweb.ca/debian/',
'release' => 'sid',
'repos' => 'testing',
'include' => { 'src' => false },
'key' => GPG_KEY_ID,
'pin' => '10',
'architecture' => 'x86_64',
'allow_unsigned' => true,
}
end
it {
is_expected.to contain_apt__setting('list-my_source').with_content(%r{# foo\ndeb \[arch=x86_64 trusted=yes\] http://debian.mirror.iweb.ca/debian/ sid testing\n})
.without_content(%r{deb-src})
}
it {
is_expected.to contain_apt__pin('my_source').that_comes_before('Apt::Setting[list-my_source]').with('ensure' => 'present',
'priority' => '10',
'origin' => 'debian.mirror.iweb.ca')
}
it {
is_expected.to contain_apt__key("Add key: #{GPG_KEY_ID} from Apt::Source my_source").that_comes_before('Apt::Setting[list-my_source]').with('ensure' => 'present',
'id' => GPG_KEY_ID)
}
end
context 'when allow_unsigned true' do
let :facts do
{
os: { family: 'Debian', name: 'Debian', release: { major: '8', full: '8.0' } },
lsbdistid: 'Debian',
lsbdistcodename: 'jessie',
osfamily: 'Debian',
puppetversion: Puppet.version,
}
end
let :params do
{
'include' => { 'src' => false },
'location' => 'http://debian.mirror.iweb.ca/debian/',
'allow_unsigned' => true,
}
end
it { is_expected.to contain_apt__setting('list-my_source').with_content(%r{# my_source\ndeb \[trusted=yes\] http://debian.mirror.iweb.ca/debian/ jessie main\n}) }
end
context 'with architecture equals x86_64' do
let :facts do
{
os: { family: 'Debian', name: 'Debian', release: { major: '8', full: '8.0' } },
lsbdistid: 'Debian',
lsbdistcodename: 'jessie',
osfamily: 'Debian',
puppetversion: Puppet.version,
}
end
let :params do
{
'location' => 'http://debian.mirror.iweb.ca/debian/',
'architecture' => 'x86_64',
}
end
it {
is_expected.to contain_apt__setting('list-my_source').with_content(%r{# my_source\ndeb \[arch=x86_64\] http://debian.mirror.iweb.ca/debian/ jessie main\n})
}
end
context 'with ensure => absent' do
let :facts do
{
os: { family: 'Debian', name: 'Debian', release: { major: '8', full: '8.0' } },
lsbdistid: 'Debian',
lsbdistcodename: 'jessie',
osfamily: 'Debian',
puppetversion: Puppet.version,
}
end
let :params do
{
'ensure' => 'absent',
}
end
it {
is_expected.to contain_apt__setting('list-my_source').with('ensure' => 'absent')
}
end
describe 'validation' do
context 'with no release' do
let :facts do
{
os: { family: 'Debian', name: 'Debian', release: { major: '8', full: '8.0' } },
lsbdistid: 'Debian',
osfamily: 'Debian',
puppetversion: Puppet.version,
}
end
it do
is_expected.to raise_error(Puppet::Error, %r{lsbdistcodename fact not available: release parameter required})
end
end
end
end

468
modules/utilities/unix/package_management/apt/spec/defines/source_spec.rb
View File

@@ -1,468 +0,0 @@
require 'spec_helper'
describe 'apt::source' do
GPG_KEY_ID = '6F6B15509CF8E59E6E469F327F438280EF8D349F'.freeze
let :pre_condition do
'class { "apt": }'
end
let :title do
'my_source'
end
context 'with defaults' do
context 'without location' do
let :facts do
{
os: { family: 'Debian', name: 'Debian', release: { major: '8', full: '8.0' } },
osfamily: 'Debian',
lsbdistcodename: 'jessie',
puppetversion: Puppet.version,
}
end
it do
is_expected.to raise_error(Puppet::Error, %r{source entry without specifying a location})
end
end
context 'with location' do
let :facts do
{
os: { family: 'Debian', name: 'Debian', release: { major: '8', full: '8.0' } },
lsbdistid: 'Debian',
lsbdistcodename: 'jessie',
osfamily: 'Debian',
puppetversion: Puppet.version,
}
end
let(:params) { { location: 'hello.there' } }
it {
is_expected.to contain_apt__setting('list-my_source').with(ensure: 'present').without_content(%r{# my_source\ndeb-src hello.there wheezy main\n})
is_expected.not_to contain_package('apt-transport-https')
}
end
end
describe 'no defaults' do
let :facts do
{
os: { family: 'Debian', name: 'Debian', release: { major: '8', full: '8.0' } },
lsbdistid: 'Debian',
lsbdistcodename: 'jessie',
osfamily: 'Debian',
operatingsystem: 'Debian',
lsbdistrelease: '8.0',
puppetversion: Puppet.version,
}
end
context 'with complex pin' do
let :params do
{
location: 'hello.there',
pin: { 'release' => 'wishwash',
'explanation' => 'wishwash',
'priority' => 1001 },
}
end
it {
is_expected.to contain_apt__setting('list-my_source').with(ensure: 'present').with_content(%r{hello.there jessie main\n})
}
it { is_expected.to contain_file('/etc/apt/sources.list.d/my_source.list').that_notifies('Class[Apt::Update]') }
it {
is_expected.to contain_apt__pin('my_source').that_comes_before('Apt::Setting[list-my_source]').with(ensure: 'present',
priority: 1001,
explanation: 'wishwash',
release: 'wishwash')
}
end
context 'with simple key' do
let :params do
{
comment: 'foo',
location: 'http://debian.mirror.iweb.ca/debian/',
release: 'sid',
repos: 'testing',
key: GPG_KEY_ID,
pin: '10',
architecture: 'x86_64',
allow_unsigned: true,
}
end
it {
is_expected.to contain_apt__setting('list-my_source').with(ensure: 'present').with_content(%r{# foo\ndeb \[arch=x86_64 trusted=yes\] http://debian.mirror.iweb.ca/debian/ sid testing\n})
.without_content(%r{deb-src})
}
it {
is_expected.to contain_apt__pin('my_source').that_comes_before('Apt::Setting[list-my_source]').with(ensure: 'present',
priority: '10',
origin: 'debian.mirror.iweb.ca')
}
it {
is_expected.to contain_apt__key("Add key: #{GPG_KEY_ID} from Apt::Source my_source").that_comes_before('Apt::Setting[list-my_source]').with(ensure: 'present',
id: GPG_KEY_ID)
}
end
context 'with complex key' do
let :params do
{
comment: 'foo',
location: 'http://debian.mirror.iweb.ca/debian/',
release: 'sid',
repos: 'testing',
key: { 'ensure' => 'refreshed',
'id' => GPG_KEY_ID,
'server' => 'pgp.mit.edu',
'content' => 'GPG key content',
'source' => 'http://apt.puppetlabs.com/pubkey.gpg' },
pin: '10',
architecture: 'x86_64',
allow_unsigned: true,
}
end
it {
is_expected.to contain_apt__setting('list-my_source').with(ensure: 'present').with_content(%r{# foo\ndeb \[arch=x86_64 trusted=yes\] http://debian.mirror.iweb.ca/debian/ sid testing\n})
.without_content(%r{deb-src})
}
it {
is_expected.to contain_apt__pin('my_source').that_comes_before('Apt::Setting[list-my_source]').with(ensure: 'present',
priority: '10',
origin: 'debian.mirror.iweb.ca')
}
it {
is_expected.to contain_apt__key("Add key: #{GPG_KEY_ID} from Apt::Source my_source").that_comes_before('Apt::Setting[list-my_source]').with(ensure: 'refreshed',
id: GPG_KEY_ID,
server: 'pgp.mit.edu',
content: 'GPG key content',
source: 'http://apt.puppetlabs.com/pubkey.gpg')
}
end
end
context 'with allow_unsigned true' do
let :facts do
{
os: { family: 'Debian', name: 'Debian', release: { major: '8', full: '8.0' } },
lsbdistid: 'Debian',
lsbdistcodename: 'jessie',
osfamily: 'Debian',
puppetversion: Puppet.version,
}
end
let :params do
{
location: 'hello.there',
allow_unsigned: true,
}
end
it {
is_expected.to contain_apt__setting('list-my_source').with(ensure: 'present').with_content(%r{# my_source\ndeb \[trusted=yes\] hello.there jessie main\n})
}
end
context 'with a https location, install apt-transport-https' do
let :facts do
{
os: { family: 'Debian', name: 'Debian', release: { major: '8', full: '8.0' } },
lsbdistid: 'Debian',
lsbdistcodename: 'jessie',
osfamily: 'Debian',
puppetversion: Puppet.version,
}
end
let :params do
{
location: 'HTTPS://foo.bar',
allow_unsigned: false,
}
end
it {
is_expected.to contain_package('apt-transport-https')
}
end
context 'with a https location, do not install apt-transport-https on oses not in list eg buster' do
let :facts do
{
os: { family: 'Debian', name: 'Debian', release: { major: '10', full: '10.0' } },
lsbdistid: 'Debian',
lsbdistcodename: 'buster',
osfamily: 'Debian',
puppetversion: Puppet.version,
}
end
let :params do
{
location: 'https://foo.bar',
allow_unsigned: false,
}
end
it {
is_expected.not_to contain_package('apt-transport-https')
}
end
context 'with architecture equals x86_64' do
let :facts do
{
os: { family: 'Debian', name: 'Debian', release: { major: '7', full: '7.0' } },
lsbdistid: 'Debian',
lsbdistcodename: 'wheezy',
osfamily: 'Debian',
puppetversion: Puppet.version,
}
end
let :params do
{
location: 'hello.there',
include: { 'deb' => false, 'src' => true },
architecture: 'x86_64',
}
end
it {
is_expected.to contain_apt__setting('list-my_source').with(ensure: 'present').with_content(%r{# my_source\ndeb-src \[arch=x86_64\] hello.there wheezy main\n})
}
end
context 'with architecture fact and unset architecture parameter' do
let :facts do
{
architecture: 'amd64',
os: { family: 'Debian', name: 'Debian', release: { major: '8', full: '8.0' } },
lsbdistid: 'Debian',
lsbdistcodename: 'jessie',
osfamily: 'Debian',
puppetversion: Puppet.version,
}
end
let :params do
{
location: 'hello.there',
include: { 'deb' => false, 'src' => true },
}
end
it {
is_expected.to contain_apt__setting('list-my_source').with(ensure: 'present').with_content(%r{# my_source\ndeb-src hello.there jessie main\n})
}
end
context 'with include_src => true' do
let :facts do
{
os: { family: 'Debian', name: 'Debian', release: { major: '8', full: '8.0' } },
lsbdistid: 'Debian',
lsbdistcodename: 'jessie',
osfamily: 'Debian',
puppetversion: Puppet.version,
}
end
let :params do
{
location: 'hello.there',
include: { 'src' => true },
}
end
it {
is_expected.to contain_apt__setting('list-my_source').with(ensure: 'present').with_content(%r{# my_source\ndeb hello.there jessie main\ndeb-src hello.there jessie main\n})
}
end
context 'with include deb => false' do
let :facts do
{
os: { family: 'Debian', name: 'Debian', release: { major: '8', full: '8.0' } },
lsbdistid: 'debian',
lsbdistcodename: 'jessie',
osfamily: 'debian',
puppetversion: Puppet.version,
}
end
let :params do
{
include: { 'deb' => false },
location: 'hello.there',
}
end
it {
is_expected.to contain_apt__setting('list-my_source').with(ensure: 'present').without_content(%r{deb-src hello.there wheezy main\n})
}
it { is_expected.to contain_apt__setting('list-my_source').without_content(%r{deb hello.there wheezy main\n}) }
end
context 'with include src => true and include deb => false' do
let :facts do
{
os: { family: 'Debian', name: 'Debian', release: { major: '8', full: '8.0' } },
lsbdistid: 'debian',
lsbdistcodename: 'jessie',
osfamily: 'debian',
puppetversion: Puppet.version,
}
end
let :params do
{
include: { 'deb' => false, 'src' => true },
location: 'hello.there',
}
end
it {
is_expected.to contain_apt__setting('list-my_source').with(ensure: 'present').with_content(%r{deb-src hello.there jessie main\n})
}
it { is_expected.to contain_apt__setting('list-my_source').without_content(%r{deb hello.there jessie main\n}) }
end
context 'with ensure => absent' do
let :facts do
{
os: { family: 'Debian', name: 'Debian', release: { major: '8', full: '8.0' } },
lsbdistid: 'Debian',
lsbdistcodename: 'jessie',
osfamily: 'Debian',
puppetversion: Puppet.version,
}
end
let :params do
{
ensure: 'absent',
}
end
it {
is_expected.to contain_apt__setting('list-my_source').with(ensure: 'absent')
}
end
describe 'validation' do
context 'with no release' do
let :facts do
{
os: { family: 'Debian', name: 'Debian', release: { major: '8', full: '8.0' } },
lsbdistid: 'Debian',
osfamily: 'Debian',
puppetversion: Puppet.version,
}
end
let(:params) { { location: 'hello.there' } }
it do
is_expected.to raise_error(Puppet::Error, %r{lsbdistcodename fact not available: release parameter required})
end
end
context 'with release is empty string' do
let :facts do
{
os: { family: 'Debian', name: 'Debian', release: { major: '8', full: '8.0' } },
lsbdistid: 'Debian',
osfamily: 'Debian',
puppetversion: Puppet.version,
}
end
let(:params) { { location: 'hello.there', release: '' } }
it { is_expected.to contain_apt__setting('list-my_source').with_content(%r{hello\.there main}) }
end
context 'with invalid pin' do
let :facts do
{
os: { family: 'Debian', name: 'Debian', release: { major: '8', full: '8.0' } },
lsbdistid: 'Debian',
lsbdistcodename: 'jessie',
osfamily: 'Debian',
puppetversion: Puppet.version,
}
end
let :params do
{
location: 'hello.there',
pin: true,
}
end
it do
is_expected.to raise_error(Puppet::Error, %r{expects a value})
end
end
context 'with notify_update = undef (default)' do
let :facts do
{
os: { family: 'Debian', name: 'Debian', release: { major: '8', full: '8.0' } },
lsbdistid: 'Debian',
lsbdistcodename: 'jessie',
osfamily: 'Debian',
puppetversion: Puppet.version,
}
end
let :params do
{
location: 'hello.there',
}
end
it { is_expected.to contain_apt__setting("list-#{title}").with_notify_update(true) }
end
context 'with notify_update = true' do
let :facts do
{
os: { family: 'Debian', name: 'Debian', release: { major: '8', full: '8.0' } },
lsbdistid: 'Debian',
lsbdistcodename: 'jessie',
osfamily: 'Debian',
puppetversion: Puppet.version,
}
end
let :params do
{
location: 'hello.there',
notify_update: true,
}
end
it { is_expected.to contain_apt__setting("list-#{title}").with_notify_update(true) }
end
context 'with notify_update = false' do
let :facts do
{
os: { family: 'Debian', name: 'Debian', release: { major: '8', full: '8.0' } },
lsbdistid: 'Debian',
lsbdistcodename: 'jessie',
osfamily: 'Debian',
puppetversion: Puppet.version,
}
end
let :params do
{
location: 'hello.there',
notify_update: false,
}
end
it { is_expected.to contain_apt__setting("list-#{title}").with_notify_update(false) }
end
end
end

44
modules/utilities/unix/package_management/apt/spec/spec_helper.rb
View File

@@ -1,44 +0,0 @@
require 'puppetlabs_spec_helper/module_spec_helper'
require 'rspec-puppet-facts'
require 'spec_helper_local' if File.file?(File.join(File.dirname(__FILE__), 'spec_helper_local.rb'))
include RspecPuppetFacts
default_facts = {
puppetversion: Puppet.version,
facterversion: Facter.version,
}
default_fact_files = [
File.expand_path(File.join(File.dirname(__FILE__), 'default_facts.yml')),
File.expand_path(File.join(File.dirname(__FILE__), 'default_module_facts.yml')),
]
default_fact_files.each do |f|
next unless File.exist?(f) && File.readable?(f) && File.size?(f)
begin
default_facts.merge!(YAML.safe_load(File.read(f)))
rescue => e
RSpec.configuration.reporter.message "WARNING: Unable to load #{f}: #{e}"
end
end
RSpec.configure do |c|
c.default_facts = default_facts
c.before :each do
# set to strictest setting for testing
# by default Puppet runs at warning level
Puppet.settings[:strict] = :warning
end
end
def ensure_module_defined(module_name)
module_name.split('::').reduce(Object) do |last_module, next_module|
last_module.const_set(next_module, Module.new) unless last_module.const_defined?(next_module)
last_module.const_get(next_module)
end
end
# 'spec_overrides' from sync.yml will appear below this line

77
modules/utilities/unix/package_management/apt/spec/spec_helper_acceptance.rb
View File

@@ -1,77 +0,0 @@
require 'beaker-pe'
require 'beaker-puppet'
require 'beaker-rspec'
require 'beaker/puppet_install_helper'
require 'beaker/module_install_helper'
require 'beaker-task_helper'
require 'beaker/i18n_helper'
require 'beaker-task_helper'
run_puppet_install_helper
configure_type_defaults_on(hosts)
install_bolt_on(hosts) unless pe_install?
install_module_on(hosts)
install_module_dependencies_on(hosts)
UNSUPPORTED_PLATFORMS = ['RedHat', 'Suse', 'windows', 'AIX', 'Solaris'].freeze
MAX_RETRY_COUNT = 12
RETRY_WAIT = 10
ERROR_MATCHER = %r{(no valid OpenPGP data found|keyserver timed out|keyserver receive failed)}
# This method allows a block to be passed in and if an exception is raised
# that matches the 'error_matcher' matcher, the block will wait a set number
# of seconds before retrying.
# Params:
# - max_retry_count - Max number of retries
# - retry_wait_interval_secs - Number of seconds to wait before retry
# - error_matcher - Matcher which the exception raised must match to allow retry
# Example Usage:
# retry_on_error_matching(3, 5, /OpenGPG Error/) do
# apply_manifest(pp, :catch_failures => true)
# end
def retry_on_error_matching(max_retry_count = MAX_RETRY_COUNT, retry_wait_interval_secs = RETRY_WAIT, error_matcher = ERROR_MATCHER)
try = 0
begin
puts "retry_on_error_matching: try #{try}" unless try.zero?
try += 1
yield
rescue StandardError => e
raise unless try < max_retry_count && (error_matcher.nil? || e.message =~ error_matcher)
sleep retry_wait_interval_secs
retry
end
end
RSpec.configure do |c|
File.expand_path(File.join(File.dirname(__FILE__), '..'))
# Readable test descriptions
c.formatter = :documentation
# Configure all nodes in nodeset
c.before :suite do
run_puppet_access_login(user: 'admin') if pe_install? && (Gem::Version.new(puppet_version) >= Gem::Version.new('5.0.0'))
hosts.each do |host|
# This will be removed, this is temporary to test localisation.
if (fact('osfamily') == 'Debian' || fact('osfamily') == 'RedHat') &&
(Gem::Version.new(puppet_version) >= Gem::Version.new('4.10.5') &&
Gem::Version.new(puppet_version) < Gem::Version.new('5.2.0'))
on(host, 'mkdir /opt/puppetlabs/puppet/share/locale/ja')
on(host, 'touch /opt/puppetlabs/puppet/share/locale/ja/puppet.po')
end
if fact('osfamily') == 'Debian'
# install language on debian systems
install_language_on(host, 'ja_JP.utf-8') if not_controller(host)
# This will be removed, this is temporary to test localisation.
end
# Required for binding tests.
if fact('osfamily') == 'RedHat'
if fact('operatingsystemmajrelease') =~ %r{7} || fact('operatingsystem') =~ %r{Fedora}
shell('yum install -y bzip2')
end
end
on host, puppet('module', 'install', 'stahnma/epel')
end
end
end

40
modules/utilities/unix/package_management/apt/spec/unit/facter/apt_dist_has_updates_spec.rb
View File

@@ -1,40 +0,0 @@
require 'spec_helper'
describe 'apt_has_dist_updates fact' do
subject { Facter.fact(:apt_has_dist_updates).value }
after(:each) { Facter.clear }
describe 'on non-Debian distro' do
before(:each) do
Facter.fact(:osfamily).expects(:value).at_least(1).returns 'RedHat'
end
it { is_expected.to be_nil }
end
describe 'on Debian based distro missing apt-get' do
before(:each) do
Facter.fact(:osfamily).expects(:value).at_least(1).returns 'Debian'
File.stubs(:executable?) # Stub all other calls
File.expects(:executable?).with('/usr/bin/apt-get').returns false
end
it { is_expected.to be_nil }
end
describe 'on Debian based distro' do
before(:each) do
Facter.fact(:osfamily).expects(:value).at_least(1).returns 'Debian'
File.stubs(:executable?) # Stub all other calls
Facter::Util::Resolution.stubs(:exec) # Catch all other calls
File.expects(:executable?).with('/usr/bin/apt-get').returns true
Facter::Util::Resolution.expects(:exec).with('/usr/bin/apt-get -s -o Debug::NoLocking=true upgrade 2>&1').returns 'test'
File.expects(:executable?).with('/usr/bin/apt-get').returns true
apt_output = "Inst extremetuxracer [2015f-0+deb8u1] (2015g-0+deb8u1 Debian:stable-updates [all])\n" \
"Conf extremetuxracer (2015g-0+deb8u1 Debian:stable-updates [all])\n" \
"Inst planet.rb [13-1.1] (22-2~bpo8+1 Debian Backports:jessie-backports [all])\n" \
"Conf planet.rb (22-2~bpo8+1 Debian Backports:jessie-backports [all])\n"
Facter::Util::Resolution.expects(:exec).with('/usr/bin/apt-get -s -o Debug::NoLocking=true dist-upgrade 2>&1').returns apt_output
end
it { is_expected.to be true }
end
end

60
modules/utilities/unix/package_management/apt/spec/unit/facter/apt_dist_package_security_updates_spec.rb
View File

@@ -1,60 +0,0 @@
require 'spec_helper'
describe 'apt_package_security_dist_updates fact' do
subject { Facter.fact(:apt_package_security_dist_updates).value }
after(:each) { Facter.clear }
describe 'when apt has no updates' do
before(:each) do
Facter.fact(:apt_has_dist_updates).stubs(:value).returns false
end
it { is_expected.to be nil }
end
describe 'when apt has updates' do
before(:each) do
Facter.fact(:osfamily).stubs(:value).returns 'Debian'
File.stubs(:executable?) # Stub all other calls
Facter::Util::Resolution.stubs(:exec) # Catch all other calls
File.expects(:executable?).with('/usr/bin/apt-get').returns true
Facter::Util::Resolution.expects(:exec).with('/usr/bin/apt-get -s -o Debug::NoLocking=true upgrade 2>&1').returns 'test'
File.expects(:executable?).with('/usr/bin/apt-get').returns true
Facter::Util::Resolution.expects(:exec).with('/usr/bin/apt-get -s -o Debug::NoLocking=true dist-upgrade 2>&1').returns apt_get_upgrade_output
end
describe 'on Debian' do
let(:apt_get_upgrade_output) do
"Inst extremetuxracer [2015f-0+deb8u1] (2015g-0+deb8u1 Debian:stable-updates [all])\n" \
"Conf extremetuxracer (2015g-0+deb8u1 Debian:stable-updates [all])\n" \
"Inst planet.rb [13-1.1] (22-2~bpo8+1 Debian Backports:jessie-backports [all])\n" \
"Conf planet.rb (22-2~bpo8+1 Debian Backports:jessie-backports [all])\n" \
"Inst vim [7.52.1-5] (7.52.1-5+deb9u2 Debian-Security:9/stable [amd64]) []\n" \
"Conf vim (7.52.1-5+deb9u2 Debian-Security:9/stable [amd64])\n" \
end
if Facter.version < '2.0.0'
it { is_expected.to eq('vim') }
else
it { is_expected.to eq(['vim']) }
end
end
describe 'on Ubuntu' do
let(:apt_get_upgrade_output) do
"Inst extremetuxracer [2016f-0ubuntu0.16.04] (2016j-0ubuntu0.16.04 Ubuntu:16.04/xenial-security, Ubuntu:16.04/xenial-updates [all])\n" \
"Conf extremetuxracer (2016j-0ubuntu0.16.04 Ubuntu:16.04/xenial-security, Ubuntu:16.04/xenial-updates [all])\n" \
"Inst vim [7.47.0-1ubuntu2] (7.47.0-1ubuntu2.2 Ubuntu:16.04/xenial-security [amd64]) []\n" \
"Conf vim (7.47.0-1ubuntu2.2 Ubuntu:16.04/xenial-security [amd64])\n" \
"Inst onioncircuits [2:3.3.10-4ubuntu2] (2:3.3.10-4ubuntu2.3 Ubuntu:16.04/xenial-updates [amd64])\n" \
"Conf onioncircuits (2:3.3.10-4ubuntu2.3 Ubuntu:16.04/xenial-updates [amd64])\n"
end
if Facter.version < '2.0.0'
it { is_expected.to eq('extremetuxracer,vim') }
else
it { is_expected.to eq(['extremetuxracer', 'vim']) }
end
end
end
end

35
modules/utilities/unix/package_management/apt/spec/unit/facter/apt_dist_package_updates_spec.rb
View File

@@ -1,35 +0,0 @@
require 'spec_helper'
describe 'apt_package_dist_updates fact' do
subject { Facter.fact(:apt_package_dist_updates).value }
after(:each) { Facter.clear }
describe 'when apt has no updates' do
before(:each) do
Facter.fact(:apt_has_dist_updates).stubs(:value).returns false
end
it { is_expected.to be nil }
end
describe 'when apt has updates' do
before(:each) do
Facter.fact(:osfamily).stubs(:value).returns 'Debian'
File.stubs(:executable?) # Stub all other calls
Facter::Util::Resolution.stubs(:exec) # Catch all other calls
File.expects(:executable?).with('/usr/bin/apt-get').returns true
Facter::Util::Resolution.expects(:exec).with('/usr/bin/apt-get -s -o Debug::NoLocking=true upgrade 2>&1').returns 'test'
File.expects(:executable?).with('/usr/bin/apt-get').returns true
apt_output = "Inst extremetuxracer [2015f-0+deb8u1] (2015g-0+deb8u1 Debian:stable-updates [all])\n" \
"Conf extremetuxracer (2015g-0+deb8u1 Debian:stable-updates [all])\n" \
"Inst planet.rb [13-1.1] (22-2~bpo8+1 Debian Backports:jessie-backports [all])\n" \
"Conf planet.rb (22-2~bpo8+1 Debian Backports:jessie-backports [all])\n"
Facter::Util::Resolution.expects(:exec).with('/usr/bin/apt-get -s -o Debug::NoLocking=true dist-upgrade 2>&1').returns apt_output
end
if Facter.version < '2.0.0'
it { is_expected.to eq('extremetuxracer,planet.rb') }
else
it { is_expected.to eq(['extremetuxracer', 'planet.rb']) }
end
end
end

52
modules/utilities/unix/package_management/apt/spec/unit/facter/apt_dist_security_updates_spec.rb
View File

@@ -1,52 +0,0 @@
require 'spec_helper'
describe 'apt_security_updates fact' do
subject { Facter.fact(:apt_security_dist_updates).value }
after(:each) { Facter.clear }
describe 'when apt has no updates' do
before(:each) do
Facter.fact(:apt_has_dist_updates).stubs(:value).returns false
end
it { is_expected.to be nil }
end
describe 'when apt has security updates' do
before(:each) do
Facter.fact(:osfamily).stubs(:value).returns 'Debian'
File.stubs(:executable?) # Stub all other calls
Facter::Util::Resolution.stubs(:exec) # Catch all other calls
File.expects(:executable?).with('/usr/bin/apt-get').returns true
Facter::Util::Resolution.expects(:exec).with('/usr/bin/apt-get -s -o Debug::NoLocking=true upgrade 2>&1').returns 'test'
File.expects(:executable?).with('/usr/bin/apt-get').returns true
Facter::Util::Resolution.expects(:exec).with('/usr/bin/apt-get -s -o Debug::NoLocking=true dist-upgrade 2>&1').returns apt_get_upgrade_output
end
describe 'on Debian' do
let(:apt_get_upgrade_output) do
"Inst extremetuxracer [2015f-0+deb8u1] (2015g-0+deb8u1 Debian:stable-updates [all])\n" \
"Conf extremetuxracer (2015g-0+deb8u1 Debian:stable-updates [all])\n" \
"Inst planet.rb [13-1.1] (22-2~bpo8+1 Debian Backports:jessie-backports [all])\n" \
"Conf planet.rb (22-2~bpo8+1 Debian Backports:jessie-backports [all])\n" \
"Inst vim [7.52.1-5] (7.52.1-5+deb9u2 Debian-Security:9/stable [amd64]) []\n" \
"Conf vim (7.52.1-5+deb9u2 Debian-Security:9/stable [amd64])\n" \
end
it { is_expected.to eq(1) }
end
describe 'on Ubuntu' do
let(:apt_get_upgrade_output) do
"Inst extremetuxracer [2016f-0ubuntu0.16.04] (2016j-0ubuntu0.16.04 Ubuntu:16.04/xenial-security, Ubuntu:16.04/xenial-updates [all])\n" \
"Conf extremetuxracer (2016j-0ubuntu0.16.04 Ubuntu:16.04/xenial-security, Ubuntu:16.04/xenial-updates [all])\n" \
"Inst vim [7.47.0-1ubuntu2] (7.47.0-1ubuntu2.2 Ubuntu:16.04/xenial-security [amd64]) []\n" \
"Conf vim (7.47.0-1ubuntu2.2 Ubuntu:16.04/xenial-security [amd64])\n" \
"Inst onioncircuits [2:3.3.10-4ubuntu2] (2:3.3.10-4ubuntu2.3 Ubuntu:16.04/xenial-updates [amd64])\n" \
"Conf onioncircuits (2:3.3.10-4ubuntu2.3 Ubuntu:16.04/xenial-updates [amd64])\n"
end
it { is_expected.to eq(2) }
end
end
end

31
modules/utilities/unix/package_management/apt/spec/unit/facter/apt_dist_updates_spec.rb
View File

@@ -1,31 +0,0 @@
require 'spec_helper'
describe 'apt_updates fact' do
subject { Facter.fact(:apt_dist_updates).value }
after(:each) { Facter.clear }
describe 'when apt has no updates' do
before(:each) do
Facter.fact(:apt_has_dist_updates).stubs(:value).returns false
end
it { is_expected.to be nil }
end
describe 'when apt has updates' do
before(:each) do
Facter.fact(:osfamily).stubs(:value).returns 'Debian'
File.stubs(:executable?) # Stub all other calls
Facter::Util::Resolution.stubs(:exec) # Catch all other calls
File.expects(:executable?).with('/usr/bin/apt-get').returns true
Facter::Util::Resolution.expects(:exec).with('/usr/bin/apt-get -s -o Debug::NoLocking=true upgrade 2>&1').returns 'test'
File.expects(:executable?).with('/usr/bin/apt-get').returns true
apt_output = "Inst extremetuxracer [2015f-0+deb8u1] (2015g-0+deb8u1 Debian:stable-updates [all])\n" \
"Conf extremetuxracer (2015g-0+deb8u1 Debian:stable-updates [all])\n" \
"Inst planet.rb [13-1.1] (22-2~bpo8+1 Debian Backports:jessie-backports [all])\n" \
"Conf planet.rb (22-2~bpo8+1 Debian Backports:jessie-backports [all])\n"
Facter::Util::Resolution.expects(:exec).with('/usr/bin/apt-get -s -o Debug::NoLocking=true dist-upgrade 2>&1').returns apt_output
end
it { is_expected.to eq(2) }
end
end

38
modules/utilities/unix/package_management/apt/spec/unit/facter/apt_has_updates_spec.rb
View File

@@ -1,38 +0,0 @@
require 'spec_helper'
describe 'apt_has_updates fact' do
subject { Facter.fact(:apt_has_updates).value }
after(:each) { Facter.clear }
describe 'on non-Debian distro' do
before(:each) do
Facter.fact(:osfamily).expects(:value).at_least(1).returns 'RedHat'
end
it { is_expected.to be_nil }
end
describe 'on Debian based distro missing apt-get' do
before(:each) do
Facter.fact(:osfamily).expects(:value).at_least(1).returns 'Debian'
File.stubs(:executable?) # Stub all other calls
File.expects(:executable?).with('/usr/bin/apt-get').returns false
end
it { is_expected.to be_nil }
end
describe 'on Debian based distro' do
before(:each) do
Facter.fact(:osfamily).expects(:value).at_least(1).returns 'Debian'
File.stubs(:executable?) # Stub all other calls
Facter::Util::Resolution.stubs(:exec) # Catch all other calls
File.expects(:executable?).with('/usr/bin/apt-get').returns true
apt_output = "Inst tzdata [2015f-0+deb8u1] (2015g-0+deb8u1 Debian:stable-updates [all])\n" \
"Conf tzdata (2015g-0+deb8u1 Debian:stable-updates [all])\n" \
"Inst unhide.rb [13-1.1] (22-2~bpo8+1 Debian Backports:jessie-backports [all])\n" \
"Conf unhide.rb (22-2~bpo8+1 Debian Backports:jessie-backports [all])\n"
Facter::Util::Resolution.expects(:exec).with('/usr/bin/apt-get -s -o Debug::NoLocking=true upgrade 2>&1').returns apt_output
end
it { is_expected.to be true }
end
end

58
modules/utilities/unix/package_management/apt/spec/unit/facter/apt_package_security_updates_spec.rb
View File

@@ -1,58 +0,0 @@
require 'spec_helper'
describe 'apt_package_security_updates fact' do
subject { Facter.fact(:apt_package_security_updates).value }
after(:each) { Facter.clear }
describe 'when apt has no updates' do
before(:each) do
Facter.fact(:apt_has_updates).stubs(:value).returns false
end
it { is_expected.to be nil }
end
describe 'when apt has updates' do
before(:each) do
Facter.fact(:osfamily).stubs(:value).returns 'Debian'
File.stubs(:executable?) # Stub all other calls
Facter::Util::Resolution.stubs(:exec) # Catch all other calls
File.expects(:executable?).with('/usr/bin/apt-get').returns true
Facter::Util::Resolution.expects(:exec).with('/usr/bin/apt-get -s -o Debug::NoLocking=true upgrade 2>&1').returns apt_get_upgrade_output
end
describe 'on Debian' do
let(:apt_get_upgrade_output) do
"Inst tzdata [2015f-0+deb8u1] (2015g-0+deb8u1 Debian:stable-updates [all])\n" \
"Conf tzdata (2015g-0+deb8u1 Debian:stable-updates [all])\n" \
"Inst unhide.rb [13-1.1] (22-2~bpo8+1 Debian Backports:jessie-backports [all])\n" \
"Conf unhide.rb (22-2~bpo8+1 Debian Backports:jessie-backports [all])\n" \
"Inst curl [7.52.1-5] (7.52.1-5+deb9u2 Debian-Security:9/stable [amd64]) []\n" \
"Conf curl (7.52.1-5+deb9u2 Debian-Security:9/stable [amd64])\n" \
end
if Facter.version < '2.0.0'
it { is_expected.to eq('curl') }
else
it { is_expected.to eq(['curl']) }
end
end
describe 'on Ubuntu' do
let(:apt_get_upgrade_output) do
"Inst tzdata [2016f-0ubuntu0.16.04] (2016j-0ubuntu0.16.04 Ubuntu:16.04/xenial-security, Ubuntu:16.04/xenial-updates [all])\n" \
"Conf tzdata (2016j-0ubuntu0.16.04 Ubuntu:16.04/xenial-security, Ubuntu:16.04/xenial-updates [all])\n" \
"Inst curl [7.47.0-1ubuntu2] (7.47.0-1ubuntu2.2 Ubuntu:16.04/xenial-security [amd64]) []\n" \
"Conf curl (7.47.0-1ubuntu2.2 Ubuntu:16.04/xenial-security [amd64])\n" \
"Inst procps [2:3.3.10-4ubuntu2] (2:3.3.10-4ubuntu2.3 Ubuntu:16.04/xenial-updates [amd64])\n" \
"Conf procps (2:3.3.10-4ubuntu2.3 Ubuntu:16.04/xenial-updates [amd64])\n"
end
if Facter.version < '2.0.0'
it { is_expected.to eq('tzdata,curl') }
else
it { is_expected.to eq(['tzdata', 'curl']) }
end
end
end
end

33
modules/utilities/unix/package_management/apt/spec/unit/facter/apt_package_updates_spec.rb
View File

@@ -1,33 +0,0 @@
require 'spec_helper'
describe 'apt_package_updates fact' do
subject { Facter.fact(:apt_package_updates).value }
after(:each) { Facter.clear }
describe 'when apt has no updates' do
before(:each) do
Facter.fact(:apt_has_updates).stubs(:value).returns false
end
it { is_expected.to be nil }
end
describe 'when apt has updates' do
before(:each) do
Facter.fact(:osfamily).stubs(:value).returns 'Debian'
File.stubs(:executable?) # Stub all other calls
Facter::Util::Resolution.stubs(:exec) # Catch all other calls
File.expects(:executable?).with('/usr/bin/apt-get').returns true
apt_output = "Inst tzdata [2015f-0+deb8u1] (2015g-0+deb8u1 Debian:stable-updates [all])\n" \
"Conf tzdata (2015g-0+deb8u1 Debian:stable-updates [all])\n" \
"Inst unhide.rb [13-1.1] (22-2~bpo8+1 Debian Backports:jessie-backports [all])\n" \
"Conf unhide.rb (22-2~bpo8+1 Debian Backports:jessie-backports [all])\n"
Facter::Util::Resolution.expects(:exec).with('/usr/bin/apt-get -s -o Debug::NoLocking=true upgrade 2>&1').returns apt_output
end
if Facter.version < '2.0.0'
it { is_expected.to eq('tzdata,unhide.rb') }
else
it { is_expected.to eq(['tzdata', 'unhide.rb']) }
end
end
end

25
modules/utilities/unix/package_management/apt/spec/unit/facter/apt_reboot_required_spec.rb
View File

@@ -1,25 +0,0 @@
require 'spec_helper'
describe 'apt_reboot_required fact' do
subject { Facter.fact(:apt_reboot_required).value }
after(:each) { Facter.clear }
describe 'if a reboot is required' do
before(:each) do
Facter.fact(:osfamily).expects(:value).at_least(1).returns 'Debian'
File.stubs(:file?).returns true
File.expects(:file?).at_least(1).with('/var/run/reboot-required').returns true
end
it { is_expected.to eq true }
end
describe 'if a reboot is not required' do
before(:each) do
Facter.fact(:osfamily).expects(:value).at_least(1).returns 'Debian'
File.stubs(:file?).returns true
File.expects(:file?).at_least(1).with('/var/run/reboot-required').returns false
end
it { is_expected.to eq false }
end
end

50
modules/utilities/unix/package_management/apt/spec/unit/facter/apt_security_updates_spec.rb
View File

@@ -1,50 +0,0 @@
require 'spec_helper'
describe 'apt_security_updates fact' do
subject { Facter.fact(:apt_security_updates).value }
after(:each) { Facter.clear }
describe 'when apt has no updates' do
before(:each) do
Facter.fact(:apt_has_updates).stubs(:value).returns false
end
it { is_expected.to be nil }
end
describe 'when apt has security updates' do
before(:each) do
Facter.fact(:osfamily).stubs(:value).returns 'Debian'
File.stubs(:executable?) # Stub all other calls
Facter::Util::Resolution.stubs(:exec) # Catch all other calls
File.expects(:executable?).with('/usr/bin/apt-get').returns true
Facter::Util::Resolution.expects(:exec).with('/usr/bin/apt-get -s -o Debug::NoLocking=true upgrade 2>&1').returns apt_get_upgrade_output
end
describe 'on Debian' do
let(:apt_get_upgrade_output) do
"Inst tzdata [2015f-0+deb8u1] (2015g-0+deb8u1 Debian:stable-updates [all])\n" \
"Conf tzdata (2015g-0+deb8u1 Debian:stable-updates [all])\n" \
"Inst unhide.rb [13-1.1] (22-2~bpo8+1 Debian Backports:jessie-backports [all])\n" \
"Conf unhide.rb (22-2~bpo8+1 Debian Backports:jessie-backports [all])\n" \
"Inst curl [7.52.1-5] (7.52.1-5+deb9u2 Debian-Security:9/stable [amd64]) []\n" \
"Conf curl (7.52.1-5+deb9u2 Debian-Security:9/stable [amd64])\n" \
end
it { is_expected.to eq(1) }
end
describe 'on Ubuntu' do
let(:apt_get_upgrade_output) do
"Inst tzdata [2016f-0ubuntu0.16.04] (2016j-0ubuntu0.16.04 Ubuntu:16.04/xenial-security, Ubuntu:16.04/xenial-updates [all])\n" \
"Conf tzdata (2016j-0ubuntu0.16.04 Ubuntu:16.04/xenial-security, Ubuntu:16.04/xenial-updates [all])\n" \
"Inst curl [7.47.0-1ubuntu2] (7.47.0-1ubuntu2.2 Ubuntu:16.04/xenial-security [amd64]) []\n" \
"Conf curl (7.47.0-1ubuntu2.2 Ubuntu:16.04/xenial-security [amd64])\n" \
"Inst procps [2:3.3.10-4ubuntu2] (2:3.3.10-4ubuntu2.3 Ubuntu:16.04/xenial-updates [amd64])\n" \
"Conf procps (2:3.3.10-4ubuntu2.3 Ubuntu:16.04/xenial-updates [amd64])\n"
end
it { is_expected.to eq(2) }
end
end
end

25
modules/utilities/unix/package_management/apt/spec/unit/facter/apt_update_last_success_spec.rb
View File

@@ -1,25 +0,0 @@
require 'spec_helper'
describe 'apt_update_last_success fact' do
subject { Facter.fact(:apt_update_last_success).value }
before(:each) { Facter.clear }
after(:each) { Facter.clear }
describe 'on Debian based distro which has not yet created the update-success-stamp file' do
it 'has a value of -1' do
Facter.fact(:osfamily).stubs(:value).returns 'Debian'
File.expects(:exist?).with('/var/lib/apt/periodic/update-success-stamp').returns false
is_expected.to eq(-1)
end
end
describe 'on Debian based distro which has created the update-success-stamp' do
it 'has the value of the mtime of the file' do
Facter.fact(:osfamily).stubs(:value).returns 'Debian'
File.stubs(:exist?).returns true
File.stubs(:mtime).returns 1_407_660_561
is_expected.to eq(1_407_660_561)
end
end
end

30
modules/utilities/unix/package_management/apt/spec/unit/facter/apt_updates_spec.rb
View File

@@ -1,30 +0,0 @@
require 'spec_helper'
describe 'apt_updates fact' do
subject { Facter.fact(:apt_updates).value }
after(:each) { Facter.clear }
describe 'when apt has no updates' do
before(:each) do
Facter.fact(:apt_has_updates).stubs(:value).returns false
end
it { is_expected.to be nil }
end
describe 'when apt has updates' do
before(:each) do
Facter.fact(:osfamily).stubs(:value).returns 'Debian'
File.stubs(:executable?) # Stub all other calls
Facter::Util::Resolution.stubs(:exec) # Catch all other calls
File.expects(:executable?).with('/usr/bin/apt-get').returns true
apt_output = "Inst tzdata [2015f-0+deb8u1] (2015g-0+deb8u1 Debian:stable-updates [all])\n" \
"Conf tzdata (2015g-0+deb8u1 Debian:stable-updates [all])\n" \
"Inst unhide.rb [13-1.1] (22-2~bpo8+1 Debian Backports:jessie-backports [all])\n" \
"Conf unhide.rb (22-2~bpo8+1 Debian Backports:jessie-backports [all])\n"
puts apt_output
Facter::Util::Resolution.expects(:exec).with('/usr/bin/apt-get -s -o Debug::NoLocking=true upgrade 2>&1').returns apt_output
end
it { is_expected.to eq(2) }
end
end

225
modules/utilities/unix/package_management/apt/spec/unit/puppet/type/apt_key_spec.rb
View File

@@ -1,225 +0,0 @@
require 'spec_helper'
require 'puppet'
describe Puppet::Type.type(:apt_key) do
context 'with only namevar 32bit key id' do
let(:resource) do
Puppet::Type.type(:apt_key).new(
id: 'EF8D349F',
)
end
it 'id is set' do
expect(resource[:id]).to eq 'EF8D349F'
end
it 'name is set to id' do
expect(resource[:name]).to eq 'EF8D349F'
end
it 'keyserver is default' do
expect(resource[:server]).to eq :'keyserver.ubuntu.com'
end
it 'source is not set' do
expect(resource[:source]).to eq nil
end
it 'content is not set' do
expect(resource[:content]).to eq nil
end
it 'refresh is not set' do
expect(resource[:refresh]).to eq nil
end
end
context 'with a lowercase 32bit key id' do
let(:resource) do
Puppet::Type.type(:apt_key).new(
id: 'ef8d349f',
)
end
it 'id is set' do
expect(resource[:id]).to eq 'EF8D349F'
end
end
context 'with a 64bit key id' do
let(:resource) do
Puppet::Type.type(:apt_key).new(
id: 'FFFFFFFFEF8D349F',
)
end
it 'id is set' do
expect(resource[:id]).to eq 'FFFFFFFFEF8D349F'
end
end
context 'with a 0x formatted key id' do
let(:resource) do
Puppet::Type.type(:apt_key).new(
id: '0xEF8D349F',
)
end
it 'id is set' do
expect(resource[:id]).to eq 'EF8D349F'
end
end
context 'with a 0x formatted lowercase key id' do
let(:resource) do
Puppet::Type.type(:apt_key).new(
id: '0xef8d349f',
)
end
it 'id is set' do
expect(resource[:id]).to eq 'EF8D349F'
end
end
context 'with a 0x formatted 64bit key id' do
let(:resource) do
Puppet::Type.type(:apt_key).new(
id: '0xFFFFFFFFEF8D349F',
)
end
it 'id is set' do
expect(resource[:id]).to eq 'FFFFFFFFEF8D349F'
end
end
context 'with source' do
let(:resource) do
Puppet::Type.type(:apt_key).new(
id: 'EF8D349F',
source: 'http://apt.puppetlabs.com/pubkey.gpg',
)
end
it 'source is set to the URL' do
expect(resource[:source]).to eq 'http://apt.puppetlabs.com/pubkey.gpg'
end
end
context 'with content' do
let(:resource) do
Puppet::Type.type(:apt_key).new(
id: 'EF8D349F',
content: 'http://apt.puppetlabs.com/pubkey.gpg',
)
end
it 'content is set to the string' do
expect(resource[:content]).to eq 'http://apt.puppetlabs.com/pubkey.gpg'
end
end
context 'with keyserver' do
let(:resource) do
Puppet::Type.type(:apt_key).new(
id: 'EF8D349F',
server: 'http://keyring.debian.org',
)
end
it 'keyserver is set to Debian' do
expect(resource[:server]).to eq 'http://keyring.debian.org'
end
end
context 'with validation' do
it 'raises an error if content and source are set' do
expect {
Puppet::Type.type(:apt_key).new(id: 'EF8D349F',
source: 'http://apt.puppetlabs.com/pubkey.gpg',
content: 'Completely invalid as a GPG key')
}.to raise_error(%r{content and source are mutually exclusive})
end
it 'raises an error if refresh => true and ensure => absent' do
expect {
Puppet::Type.type(:apt_key).new(id: 'EF8D349F',
source: 'http://apt.puppetlabs.com/pubkey.gpg',
ensure: :absent,
refresh: :true)
}.to raise_error(%r{ensure => absent and refresh => true are mutually exclusive})
end
it 'raises an error if a weird length key is used' do
expect {
Puppet::Type.type(:apt_key).new(id: 'FEF8D349F',
source: 'http://apt.puppetlabs.com/pubkey.gpg',
content: 'Completely invalid as a GPG key')
}.to raise_error(%r{Valid values match})
end
it 'raises an error when an invalid URI scheme is used in source' do
expect {
Puppet::Type.type(:apt_key).new(id: 'EF8D349F',
source: 'hkp://pgp.mit.edu')
}.to raise_error(%r{Valid values match})
end
it 'allows the http URI scheme in source' do
expect {
Puppet::Type.type(:apt_key).new(id: 'EF8D349F',
source: 'http://pgp.mit.edu')
}.not_to raise_error
end
it 'allows the http URI with username and password' do
expect {
Puppet::Type.type(:apt_key).new(id: '4BD6EC30',
source: 'http://testme:Password2@pgp.mit.edu')
}.not_to raise_error
end
it 'allows the https URI scheme in source' do
expect {
Puppet::Type.type(:apt_key).new(id: 'EF8D349F',
source: 'https://pgp.mit.edu')
}.not_to raise_error
end
it 'allows the https URI with username and password' do
expect {
Puppet::Type.type(:apt_key).new(id: 'EF8D349F',
source: 'https://testme:Password2@pgp.mit.edu')
}.not_to raise_error
end
it 'allows the ftp URI scheme in source' do
expect {
Puppet::Type.type(:apt_key).new(id: 'EF8D349F',
source: 'ftp://pgp.mit.edu')
}.not_to raise_error
end
it 'allows an absolute path in source' do
expect {
Puppet::Type.type(:apt_key).new(id: 'EF8D349F',
source: '/path/to/a/file')
}.not_to raise_error
end
it 'allows 5-digit ports' do
expect {
Puppet::Type.type(:apt_key).new(id: 'EF8D349F',
source: 'http://pgp.mit.edu:12345/key')
}.not_to raise_error
end
it 'allows 5-digit ports when using key servers' do
expect {
Puppet::Type.type(:apt_key).new(id: 'EF8D349F',
server: 'http://pgp.mit.edu:12345')
}.not_to raise_error
end
end
end

10
modules/utilities/unix/package_management/apt/tasks/init.json
View File

@@ -1,10 +0,0 @@
{
"description": "Allows you to perform apt functions",
"input_method": "stdin",
"parameters": {
"action": {
"description": "Action to perform ",
"type": "Enum[update, upgrade]"
}
}
}

24
modules/utilities/unix/package_management/apt/tasks/init.rb
View File

@@ -1,24 +0,0 @@
#!/opt/puppetlabs/puppet/bin/ruby
require 'json'
require 'open3'
require 'puppet'
def apt_get(action)
cmd = ['apt-get', action]
cmd << '-y' if action == 'upgrade'
stdout, stderr, status = Open3.capture3(*cmd)
raise Puppet::Error, stderr if status != 0 # rubocop:disable GetText/DecorateFunctionMessage
{ status: stdout.strip }
end
params = JSON.parse(STDIN.read)
action = params['action']
begin
result = apt_get(action)
puts result.to_json
exit 0
rescue Puppet::Error => e
puts({ status: 'failure', error: e.message }.to_json)
exit 1
end

1
modules/utilities/unix/package_management/apt/templates/15update-stamp.epp
View File

@@ -1 +0,0 @@
APT::Update::Post-Invoke-Success {"touch /var/lib/apt/periodic/update-success-stamp 2>/dev/null || true";};

1
modules/utilities/unix/package_management/apt/templates/_conf_header.epp
View File

@@ -1 +0,0 @@
// This file is managed by Puppet. DO NOT EDIT.

1
modules/utilities/unix/package_management/apt/templates/_header.epp
View File

@@ -1 +0,0 @@
# This file is managed by Puppet. DO NOT EDIT.

5
modules/utilities/unix/package_management/apt/templates/auth_conf.epp
View File

@@ -1,5 +0,0 @@
<% if $apt::auth_conf_entries != [] { -%>
<% $apt::auth_conf_entries.each | $auth_conf_entry | { -%>
machine <%= $auth_conf_entry['machine'] %> login <%= $auth_conf_entry['login'] %> password <%= $auth_conf_entry['password'] %>
<% } -%>
<% } -%>

26
modules/utilities/unix/package_management/apt/templates/pin.pref.epp
View File

@@ -1,26 +0,0 @@
<%- | $name, $pin_release, $release, $codename, $release_version, $component, $originator, $label, $version, $origin, $explanation, $packages_string, $priority | -%>
<%-
$pin =
if $pin_release != '' {
$options = [
if $release != '' { "a=${release}" },
if $codename != '' { "n=${codename}" },
if $release_version != '' { "v=${release_version}"},
if $component != '' { "c=${component}" },
if $originator != '' { "o=${originator}" },
if $label != '' { "l=${label}" },
].filter |$x| { $x != undef }
"release ${options.join(', ')}" }
elsif $version and "${version}".length > 0 {
"version ${version}" }
elsif $origin and $origin.length > 0 {
"origin ${origin}" }
else {
"release a=${name}" #Default value
}
-%>
Explanation: <%= $explanation %>
Package: <%= $packages_string %>
Pin: <%= $pin %>
Pin-Priority: <%= $priority %>

7
modules/utilities/unix/package_management/apt/templates/proxy.epp
View File

@@ -1,7 +0,0 @@
<%- | Hash $proxies | -%>
Acquire::http::proxy "http://<%= $proxies['host'] %>:<%= $proxies['port'] %>/";
<%- if $proxies['https'] { %>
Acquire::https::proxy "https://<%= $proxies['host'] %>:<%= $proxies['port'] %>/";
<%- } elsif $proxies['direct'] { -%>
Acquire::https::proxy "DIRECT";
<%- } -%>

10
modules/utilities/unix/package_management/apt/templates/source.list.epp
View File

@@ -1,10 +0,0 @@
<%- | String $comment, Hash $includes, $opt_architecture, Boolean $allow_unsigned, $location, $release, String $repos | -%>
# <%= $comment %>
<%- if $includes['deb'] { -%>
deb <%- if ($opt_architecture or $allow_unsigned) {-%>
[<%- if ($opt_architecture) {%>arch=<%= $opt_architecture %><% } %><%if ($opt_architecture and $allow_unsigned) {%> <% }%><% if ($allow_unsigned) {%>trusted=yes<% } %>] <%- } %> <%= $location %> <%= $release %> <%= $repos %>
<%- } -%>
<%- if $includes['src'] { -%>
deb-src <%- if $opt_architecture or $allow_unsigned { -%>
[<%- if ($opt_architecture) {%>arch=<%= $opt_architecture %><% } %><%if ($opt_architecture and $allow_unsigned) {%> <% }%><% if ($allow_unsigned) {%>trusted=yes<% } %>] <%- } %> <%= $location %> <%= $release %> <%= $repos %>
<%- } -%>

20
modules/utilities/unix/package_management/apt/types/auth_conf_entry.pp
View File

@@ -1,20 +0,0 @@
# @summary Login configuration settings that are recorded in the file `/etc/apt/auth.conf`.
#
# @see https://manpages.debian.org/testing/apt/apt_auth.conf.5.en.html for more information
#
# @param machine
# Hostname of machine to connect to.
#
# @param login
# Specifies the username to connect with.
#
# @param password
# Specifies the password to connect with.
#
type Apt::Auth_conf_entry = Struct[
{
machine => String[1],
login => String,
password => String
}
]

26
modules/utilities/unix/package_management/apt/types/proxy.pp
View File

@@ -1,26 +0,0 @@
# @summary Configures Apt to connect to a proxy server.
#
# @param ensure
# Specifies whether the proxy should exist. Valid options: 'file', 'present', and 'absent'. Prefer 'file' over 'present'.
#
# @param host
# Specifies a proxy host to be stored in `/etc/apt/apt.conf.d/01proxy`. Valid options: a string containing a hostname.
#
# @param port
# Specifies a proxy port to be stored in `/etc/apt/apt.conf.d/01proxy`. Valid options: an integer containing a port number.
#
# @param https
# Specifies whether to enable https proxies.
#
# @param direct
# Specifies whether or not to use a `DIRECT` https proxy if http proxy is used but https is not.
#
type Apt::Proxy = Struct[
{
ensure => Optional[Enum['file', 'present', 'absent']],
host => Optional[String],
port => Optional[Integer[0, 65535]],
https => Optional[Boolean],
direct => Optional[Boolean],
}
]