Merge pull request #25004 from garethgreenaway/pkg_beacon

Adding a beacon to monitor installed packages

salt/beacons/pkg.py

@@ -0,0 +1,65 @@
+# -*- coding: utf-8 -*-
+'''
+Watch for pkgs that have upgrades then fire an event
+'''
+
+# Import python libs
+from __future__ import absolute_import
+
+__virtualname__ = 'pkg'
+
+import logging
+log = logging.getLogger(__name__)
+
+
+def __virtual__():
+    '''
+    Only load if strace is installed
+    '''
+    return __virtualname__ if 'pkg.upgrade_available' in __salt__ else False
+
+
+def validate(config):
+    '''
+    Validate the beacon configuration
+    '''
+    # Configuration for pkg beacon should be a list
+    if not isinstance(config, dict):
+        log.info('Configuration for pkg beacon must be a dictionary.')
+        return False
+    if 'pkgs' not in config:
+        log.info('Configuration for pkg beacon requires list of pkgs.')
+        return False
+    return True
+
+
+def beacon(config):
+    '''
+    Check if installed packages are the latest versions
+    and fire an event for those that have upgrades.
+
+    .. code-block:: yaml
+
+        beacons:
+          pkg:
+            - pkgs:
+                - zsh
+                - apache2
+            - refresh: True
+    '''
+    ret = []
+    if not validate(config):
+        return ret
+
+    _refresh = False
+    if 'refresh' in config and config['refresh']:
+        _refresh = True
+    for pkg in config['pkgs']:
+        _installed = __salt__['pkg.version'](pkg)
+        _latest = __salt__['pkg.latest_version'](pkg, refresh=_refresh)
+        if _installed and _latest:
+            _pkg = {'pkg': pkg,
+                    'version': _latest
+                    }
+            ret.append(_pkg)
+    return ret