Add foreman_debug task

This task helps on creating bugs by generate and download the
foreman-debug report tarball and also prints the Satellite release
string. The release string will be grabbed from the satellite.repo yum
repo file which is the repo file created for every downstream install.

Closes #137

automation_tools/__init__.py

@@ -13,7 +13,7 @@
 from re import search
 from urlparse import urlsplit
 
-from fabric.api import cd, env, execute, local, put, run, warn_only
+from fabric.api import cd, env, execute, get, local, put, run, warn_only
 if sys.version_info[0] is 2:
     from urlparse import urljoin  # (import-error) pylint:disable=F0401
     from StringIO import StringIO  # (import-error) pylint:disable=F0401
@@ -1457,6 +1457,34 @@ def update_packages(*args, **kwargs):
     )
 
 
+# =============================================================================
+# Utility tasks
+# =============================================================================
+def foreman_debug(tarball_name=None):
+    """Generates and download the foreman-debug generated tarball
+
+    :param str tarball_name: The tarball file name which will be downloaded
+        relative to the current working directory. If ``None`` the tarball will
+        be named foreman-debug-<timestamp>.
+
+    """
+    if tarball_name is None:
+        tarball_name = 'foreman-debug-{0}'.format(int(time.time()))
+
+    with cd('/tmp'):
+        run('foreman-debug -q -d {0}'.format(tarball_name), quiet=True)
+        get(
+            local_path='%(basename)s',
+            remote_path='/tmp/{0}/{0}.tar.xz'.format(tarball_name),
+        )
+
+    release = run(
+        'cat /etc/yum.repos.d/satellite.repo | grep baseurl | cut -d "/" -f 7',
+        quiet=True
+    )
+    print('Satellite release: {0}'.format(release))
+
+
 # =============================================================================
 # Helper functions
 # =============================================================================

fabfile.py

@@ -9,6 +9,7 @@
     downstream_install,
     errata_upgrade,
     fix_hostname,
+    foreman_debug,
     install_errata,
     install_katello_agent,
     install_prerequisites,