Add log rotation file

.. note:: This role does not manage the ``logrotate`` package or
          configuration directory, and it is assumed to be installed
          and available.

This role installs a log rotation file in ``/etc/logrotate.d/`` for a
given file.

For information on the directives see ``logrotate.conf(5)``.  This is
not an exhaustive list of directives (contributions are welcome).

** Role Variables **

.. zuul:rolevar:: logrotate_file_name

   The full path to log file on disk to rotate.  May be a wild-card;
   e.g. ``/var/log/progname/*.log``.

.. zuul:rolevar:: logrotate_config_file_name
   :default: Unique name based on the hash of :zuul:rolevar::`logrotate.logrotate_file_name`

   The name of the configuration file in ``/etc/logrotate.d``.  If
   this is specified, it is up to the caller to ensure it is unique
   across all calls of this role.

.. zuul:rolevar:: logrotate_compress
   :default: yes

.. zuul:rolevar:: logrotate_copytruncate
   :default: yes

.. zuul:rolevar:: logrotate_delaycompress
   :default: yes

.. zuul:rolevar:: logrotate_missingok
   :default: yes

.. zuul:rolevar:: logrotate_rotate
   :default: 7

.. zuul:rolevar:: logrotate_frequency
   :default: daily

   One of ``hourly``, ``daily``, ``weekly``, ``monthly``, ``yearly``
   or ``size``.

   If choosing ``size``, :zuul:rolevar::`logrotate.logrotate_size` must
   be specified

.. zuul:rolevar:: logrotate_size
   :default: None

   Size; e.g. 100K, 10M, 1G.  Only when
   :zuul:rolevar::`logrotate.logrotate_frequency` is ``size``.

.. zuul:rolevar:: logrotate_notifempty
   :default: yes