document new package repository configuration in puppet

admin-guide/puppet/roles/base.rst

@@ -15,6 +15,7 @@ Parameters
 default_target          string    ``multi-user``
 enable_afs              bool      hiera('base::enable_afs')
 enable_autofs           bool      hiera('base::enable_autofs')
+enable_epics            bool      hiera('base::enable_epics')
 enable_filecopy         bool      hiera('base::enable_filecopy')
 enable_ganglia          bool      hiera('base::enable_ganglia')
 enable_icinga           bool      hiera('base::enable_icinga')
@@ -31,9 +32,10 @@ enable_telegraf         bool      hiera('base::enable_telegraf')
 enable_updatedb         bool      hiera('base::enable_updatedb')
 include_aaa             bool      true
 include_log_client      bool      true
-include_yum_client      bool      true
-package_groups          array     []
-pkg_group::*            array     -
+include_rpm_repos       bool      true
+package_groups          array     hiera_array('base::package_groups', [])
+package_excludes        array     hierra_array('base::package_exclude', [])
+pkg_group::*            array     hierra_array('base::pkg_group::...', [])
 selinux_mode            string    hiera('base::selinux_mode', 'enforcing')
 ======================  ========  ================================================
 
@@ -62,6 +64,12 @@ needed to support the ``-hosts`` map as documented in :manpage:`auto.master`.
 The ``-hosts`` map is mounted on ``/net``.
 
 
+``enable_epics``
+~~~~~~~~~~~~~~~~~
+
+Enables the ``EPICS``. TODO: more details...
+
+
 ``enable_filecopy``
 ~~~~~~~~~~~~~~~~~~~
 
@@ -177,25 +185,39 @@ meant to allow roles customization of the :doc:`log_client
 <../profiles/log_client>` profile.
 
 
-``include_yum_client``
+``include_rpm_repos``
 ~~~~~~~~~~~~~~~~~~~~~~
 
-Determines whether to include the :doc:`yum_client <../profiles/yum_client>`
-profile.
+Determines whether to install the default RPM package repositories.
 
 
 ``package_groups``
 ~~~~~~~~~~~~~~~~~~
 
-The list of package groups to install. Package groups are defined using
-`pkg_group::NAME`_.
+The list of package groups to install. Package groups are defined in Hiera using
+``base::pkg_group::NAME``.
 
 
 ``pkg_group::NAME``
 ~~~~~~~~~~~~~~~~~~~
 
-An array defining the package group ``NAME``. Package groups are installed using
-the `package_groups`_ parameter.
+An array defining the package group ``NAME``. It contains the package name with optionally
+one or more tags, separated by ``:``. Following tags are allowed:
+
+========== =====================================================
+Tag        Description
+---------- -----------------------------------------------------
+latest     ensure the latest version of the package is installed
+absent     ensure the package is not installed
+os=redhat7 install it only on this OS
+os!redhat7 install on any OS except this one
+========== =====================================================
+
+
+``package_excludes``
+~~~~~~~~~~~~~~~~~~~~
+
+An array with packages which are not made available on the system.
 
 
 ``selinux_mode``
@@ -224,7 +246,7 @@ Examples
 The most basic usage is::
 
   class role::some_role () {
-    
+
     include role::base
 
     ...