``profile::yum_client``
=======================

This module configures :manpage:`yum(8)`.


Parameters
----------

===============================  ========  =============================================
**Name**                         **Type**  **Default**
-------------------------------  --------  ---------------------------------------------
exclude                          list      hiera('yum_client::exclude', [])
package_groups                   list      hiera_array('yum_client::package_groups', [])
purge_repositories               bool      hiera('yum_client::purge_repositories')
repos                            list      hiera_array('yum_client::repositories')
===============================  ========  =============================================


``exclude``
~~~~~~~~~~~

An array containing entries suitable for the ``exclude`` option in
:manpage:`yum.conf(5)`.


``package_group``
~~~~~~~~~~~~~~~~~

A list containing the names of the package groups to be installed on the
systems. The package groups have to be defined through `pkg_group::$NAME`_ and
are completely independent of Yum (environment) groups.


``pkg_group::$NAME``
~~~~~~~~~~~~~~~~~~~~

The list of packages that comprise the package group ``$NAME``.


``purge_repositories``
~~~~~~~~~~~~~~~~~~~~~~

A boolean controlling whether files that were not created by Puppet should be
removed from ``/etc/yum.repos.d``. This is useful to prevent repositories to be
configured through other means (e.g. manually).


``repos``
~~~~~~~~~

A list of names designating the repositories that are to be configured (not
necessarily enabled) on the system. If ``<name>`` is the name of the repository,
then its definition is determined by searching Hiera for the
``yum_client::repo_<name>`` key.
