diff --git a/CHANGELOG.md b/CHANGELOG.md index 925e375e..e0e68136 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -4,6 +4,28 @@ All notable changes to this project will be documented in this file. Each new release typically also includes the latest modulesync defaults. These should not affect the functionality of the module. +## [v4.3.0](https://github.com/voxpupuli/puppet-yum/tree/v4.3.0) (2020-07-20) + +[Full Changelog](https://github.com/voxpupuli/puppet-yum/compare/v4.2.0...v4.3.0) + +**Implemented enhancements:** + +- Improve extraction of available updates [\#181](https://github.com/voxpupuli/puppet-yum/pull/181) ([smortex](https://github.com/smortex)) +- Use simpler code for tests for expected failures [\#173](https://github.com/voxpupuli/puppet-yum/pull/173) ([traylenator](https://github.com/traylenator)) + +**Fixed bugs:** + +- De-duplicate start of string match character [\#179](https://github.com/voxpupuli/puppet-yum/pull/179) ([traylenator](https://github.com/traylenator)) +- versionlock must specify at least .\* for arch. [\#177](https://github.com/voxpupuli/puppet-yum/pull/177) ([traylenator](https://github.com/traylenator)) + +**Closed issues:** + +- yum\_package\_updates fact misinterprets output [\#180](https://github.com/voxpupuli/puppet-yum/issues/180) + +**Merged pull requests:** + +- Add dnf tag to metadata [\#175](https://github.com/voxpupuli/puppet-yum/pull/175) ([traylenator](https://github.com/traylenator)) + ## [v4.2.0](https://github.com/voxpupuli/puppet-yum/tree/v4.2.0) (2020-05-22) [Full Changelog](https://github.com/voxpupuli/puppet-yum/compare/v4.1.1...v4.2.0) diff --git a/REFERENCE.md b/REFERENCE.md index 2530f649..4a4729ed 100644 --- a/REFERENCE.md +++ b/REFERENCE.md @@ -1,15 +1,16 @@ # Reference + ## Table of Contents -**Classes** +### Classes * [`yum`](#yum): A class to install and manage Yum configuration. * [`yum::clean`](#yumclean): A $(yum clean all) Exec to be notified if desired. * [`yum::plugin::versionlock`](#yumpluginversionlock): Class: yum::plugin::versionlock This class installs versionlock plugin Parameters: [*ensure*] - specifies if versionlock should be presen -**Defined types** +### Defined types * [`yum::config`](#yumconfig): Define: yum::config This definition manages yum.conf Parameters: [*key*] - alternative conf. key (defaults to name) [*ensure*] - * [`yum::gpgkey`](#yumgpgkey): Define: yum::gpgkey This definition saves and imports public GPG key for RPM. Key can be stored on Puppet's fileserver or as inline content. @@ -18,11 +19,11 @@ * [`yum::plugin`](#yumplugin): Define: yum::plugin This definition installs Yum plugin. Parameters: [*ensure*] - specifies if plugin should be present or absent Acti * [`yum::versionlock`](#yumversionlock): Locks package from updates. -**Functions** +### Functions * [`yum::bool2num_hash_recursive`](#yumbool2num_hash_recursive): This functions converts the Boolean values of a Hash to Integers, either '0' or '1'. It does this recursively, decending as far as the langu -**Data types** +### Data types * [`Yum::RpmArch`](#yumrpmarch): Valid rpm architectures. * [`Yum::RpmName`](#yumrpmname): Valid rpm name. @@ -30,13 +31,13 @@ * [`Yum::RpmVersion`](#yumrpmversion): Valid rpm version fields. * [`Yum::VersionlockString`](#yumversionlockstring): This type matches strings appropriate for use with yum-versionlock. Its basic format, using the `rpm(8)` query string format, is `%{EPOCH}:%{ -**Tasks** +### Tasks * [`init`](#init): Allows you to perform yum functions ## Classes -### yum +### `yum` A class to install and manage Yum configuration. @@ -106,7 +107,7 @@ Data type: `Boolean` Whether or not to purge old kernel version beyond the `keeponly_limit`. -Default value: `true` +Default value: ``true`` ##### `keep_kernel_devel` @@ -114,7 +115,7 @@ Data type: `Boolean` Whether or not to keep kernel devel packages on old kernel purge. -Default value: `false` +Default value: ``false`` ##### `config_options` @@ -126,7 +127,7 @@ are either the direct `ensure` value, or a Hash of the resource's attributes. @note Boolean parameter values will be converted to either a `1` or `0`; use a quoted string to get a literal `true` or `false`. -Default value: { } +Default value: `{ }` ##### `repos` @@ -141,7 +142,7 @@ parameters may be overriden or removed via global or environment Hiera data. @note Boolean parameter values will be converted to either a `1` or `0`; use a quoted string to get a literal `true` or `false`. -Default value: {} +Default value: `{}` ##### `managed_repos` @@ -154,7 +155,7 @@ set in the module's Hiera data. @note This only indicates the *managed* state of the repos, the `ensure` state must be managed in the `repos` data. -Default value: [] +Default value: `[]` ##### `manage_os_default_repos` @@ -165,7 +166,7 @@ Whether or not to add an operating system's default repos to the `managed_repos` @note This only works for operating systems with data in the module's data directory. Currently the module only contains data for for CentOS 6 & 7. -Default value: `false` +Default value: ``false`` ##### `os_default_repos` @@ -174,7 +175,7 @@ Data type: `Array[String]` A list of default repos to add to `managed_repos` if `manage_os_default_repos` is enabled. Normally this should not be modified. -Default value: [] +Default value: `[]` ##### `repo_exclusions` @@ -184,7 +185,7 @@ An array of first-level keys from the `repos` hash to exclude from management vi Values in this array will be subtracted from the `managed_repos` array as a last step before instantiation. -Default value: [] +Default value: `[]` ##### `gpgkeys` @@ -194,7 +195,7 @@ A hash of yum::gpgkey types, which will be automatically included if they are referenced by a managed_repo. This will use the same merging behavior as repos. -Default value: {} +Default value: `{}` ##### `utils_package_name` @@ -202,13 +203,13 @@ Data type: `String` Name of the utils package, e.g. 'yum-utils', or 'dnf-utils'. -Default value: 'yum-utils' +Default value: `'yum-utils'` -### yum::clean +### `yum::clean` A $(yum clean all) Exec to be notified if desired. -### yum::plugin::versionlock +### `yum::plugin::versionlock` Class: yum::plugin::versionlock @@ -235,7 +236,7 @@ Data type: `Enum['present', 'absent']` -Default value: 'present' +Default value: `'present'` ##### `path` @@ -243,7 +244,7 @@ Data type: `String` -Default value: '/etc/yum/pluginconf.d/versionlock.list' +Default value: `'/etc/yum/pluginconf.d/versionlock.list'` ##### `clean` @@ -251,11 +252,11 @@ Data type: `Boolean` -Default value: `false` +Default value: ``false`` ## Defined types -### yum::config +### `yum::config` Define: yum::config @@ -296,9 +297,9 @@ Data type: `String` -Default value: $title +Default value: `$title` -### yum::gpgkey +### `yum::gpgkey` Define: yum::gpgkey @@ -338,7 +339,7 @@ Data type: `String` -Default value: $name +Default value: `$name` ##### `ensure` @@ -346,7 +347,7 @@ Data type: `Enum['present', 'absent']` -Default value: 'present' +Default value: `'present'` ##### `content` @@ -354,7 +355,7 @@ Data type: `Optional[String]` -Default value: `undef` +Default value: ``undef`` ##### `source` @@ -362,7 +363,7 @@ Data type: `Optional[String]` -Default value: `undef` +Default value: ``undef`` ##### `owner` @@ -370,7 +371,7 @@ Data type: `String` -Default value: 'root' +Default value: `'root'` ##### `group` @@ -378,7 +379,7 @@ Data type: `String` -Default value: 'root' +Default value: `'root'` ##### `mode` @@ -386,9 +387,9 @@ Data type: `String` -Default value: '0644' +Default value: `'0644'` -### yum::group +### `yum::group` Define: yum::group @@ -420,7 +421,7 @@ Data type: `Array[String[1]]` -Default value: [] +Default value: `[]` ##### `ensure` @@ -428,7 +429,7 @@ Data type: `Enum['present', 'installed', 'latest', 'absent', 'purged']` -Default value: 'present' +Default value: `'present'` ##### `timeout` @@ -436,9 +437,9 @@ Data type: `Optional[Integer]` -Default value: `undef` +Default value: ``undef`` -### yum::install +### `yum::install` Define: yum::install @@ -478,7 +479,7 @@ Data type: `Enum['present', 'installed', 'absent', 'purged']` -Default value: 'present' +Default value: `'present'` ##### `timeout` @@ -486,9 +487,9 @@ Data type: `Optional[Integer]` -Default value: `undef` +Default value: ``undef`` -### yum::plugin +### `yum::plugin` Define: yum::plugin @@ -517,7 +518,7 @@ Data type: `Enum['present', 'absent']` -Default value: 'present' +Default value: `'present'` ##### `pkg_prefix` @@ -525,7 +526,7 @@ Data type: `Optional[String]` -Default value: `undef` +Default value: ``undef`` ##### `pkg_name` @@ -533,9 +534,9 @@ Data type: `Optional[String]` -Default value: `undef` +Default value: ``undef`` -### yum::versionlock +### `yum::versionlock` Locks package from updates. @@ -552,7 +553,7 @@ package name. If a version is set on CentOS 7 then it behaves like CentOS 8 * **See also** -http://man7.org/linux/man-pages/man1/yum-versionlock.1.html + * http://man7.org/linux/man-pages/man1/yum-versionlock.1.html #### Examples @@ -598,7 +599,7 @@ Data type: `Enum['present', 'absent', 'exclude']` Specifies if versionlock should be `present`, `absent` or `exclude`. -Default value: 'present' +Default value: `'present'` ##### `version` @@ -607,7 +608,7 @@ Data type: `Optional[Yum::RpmVersion]` Version of the package if CentOS 8 mechanism is used. This must be set for dnf based systems (e.g CentOS 8). If version is set then the name var is assumed to a package name and not the full versionlock string. -Default value: `undef` +Default value: ``undef`` ##### `release` @@ -615,7 +616,7 @@ Data type: `Yum::RpmRelease` Release of the package if CentOS 8 mechanism is used. -Default value: '*' +Default value: `'*'` ##### `arch` @@ -623,7 +624,7 @@ Data type: `Variant[Yum::RpmArch, Enum['*']]` Arch of the package if CentOS 8 mechanism is used. -Default value: '*' +Default value: `'*'` ##### `epoch` @@ -631,11 +632,11 @@ Data type: `Integer[0]` Epoch of the package if CentOS 8 mechanism is used. -Default value: 0 +Default value: `0` ## Functions -### yum::bool2num_hash_recursive +### `yum::bool2num_hash_recursive` Type: Puppet Language @@ -707,16 +708,16 @@ The hash on which to operate ## Data types -### Yum::RpmArch +### `Yum::RpmArch` Output of `rpm -q --queryformat '%{arch}\n' package` * **See also** -https://github.com/rpm-software-management/rpm/blob/master/rpmrc.in + * https://github.com/rpm-software-management/rpm/blob/master/rpmrc.in Alias of `Enum['noarch', 'x86_64', 'i386', 'arm', 'ppc64', 'ppc64le', 'sparc64', 'ia64', 'alpha', 'ip', 'm68k', 'mips', 'mipsel', 'mk68k', 'mint', 'ppc', 'rs6000', 's390', 's390x', 'sh', 'sparc', 'xtensa']` -### Yum::RpmName +### `Yum::RpmName` Can be alphanumeric or contain `.` `_` `+` `%` `{` `}` `-`. Output of `rpm -q --queryformat '%{name}\n package` @@ -724,29 +725,29 @@ Examples python36-foobar, netscape Alias of `Pattern[/\A([0-9a-zA-Z\._\+%\{\}-]+)\z/]` -### Yum::RpmRelease +### `Yum::RpmRelease` It may not contain a dash. Output of `rpm -q --queryformat '%{release}\n' package`. Examples 3.4 3.4.el6, 3.4.el6_2 * **See also** -http://ftp.rpm.org/max-rpm/ch-rpm-file-format.html + * http://ftp.rpm.org/max-rpm/ch-rpm-file-format.html -Alias of `Pattern[/\A^([^-]+)\z/]` +Alias of `Pattern[/\A([^-]+)\z/]` -### Yum::RpmVersion +### `Yum::RpmVersion` It may not contain a dash. Output of `rpm -q --queryformat '%{version}\n' package`. Examples 3.4, 2.5.alpha6 * **See also** -http://ftp.rpm.org/max-rpm/ch-rpm-file-format.html + * http://ftp.rpm.org/max-rpm/ch-rpm-file-format.html Alias of `Pattern[/\A([^-]+)\z/]` -### Yum::VersionlockString +### `Yum::VersionlockString` This type matches strings appropriate for use with yum-versionlock. Its basic format, using the `rpm(8)` query string format, is @@ -821,7 +822,7 @@ Alias of `Pattern[/^([0-9\*]+):([0-9a-zA-Z\._\+%\{\}\*-]+)-([^-]+)-([^-]+)\.(([0 ## Tasks -### init +### `init` Allows you to perform yum functions diff --git a/metadata.json b/metadata.json index 4e878b62..450caecb 100644 --- a/metadata.json +++ b/metadata.json @@ -1,6 +1,6 @@ { "name": "puppet-yum", - "version": "4.2.1-rc0", + "version": "4.3.0", "author": "Vox Pupuli", "summary": "YUM utilities", "license": "MIT",