Add support for Ubuntu platform

Or at least, enough support to try it out.

Author: reidmv

documentation/basic_usage.md

@@ -74,3 +74,13 @@ Example params.json Bolt parameters file:
   "version": "2019.1.1"
 }
 ```
+
+## Offline usage
+
+The peadm::provision plan downloads installation content from an online repository by default. To perform an offline installation, you can prefetch the needed content and place it in the staging directory. If content is available in the staging directory, peadm::provision will not try to download it.
+
+The default staging directory is `/tmp`. If a different staging dir is being used, it can be specified using the `stagingdir` parameter to the peadm::provision plan.
+
+The content needed is the PE installation tarball for the target version. The installation content should be in the staging dir, and should have its original name. E.g. `/tmp/puppet-enterprise-2019.2.2-el-7-x86_64.tar.gz`.
+
+Installation content can be downloaded from [https://puppet.com/try-puppet/puppet-enterprise/download/](https://puppet.com/try-puppet/puppet-enterprise/download/).

plans/action/install.pp

@@ -106,12 +106,18 @@
     },
   }
 
+  $precheck_results = run_task('peadm::precheck', $all_targets)
+  $platform = $precheck_results.first['platform'] # Assume the platform of the first result correct
+
   # Validate that the name given for each system is both a resolvable name AND
-  # the configured hostname.
-  run_task('peadm::hostname', $all_targets).each |$result| {
+  # the configured hostname, and that all systems return the same platform
+  $precheck_results.each |$result| {
     if $result.target.name != $result['hostname'] {
       fail_plan("Hostname / DNS name mismatch: target ${result.target.name} reports '${result['hostname']}'")
     }
+    if $result['platform'] != $platform {
+      fail_plan("Platform mismatch: target ${result.target.name} reports '${result['platform']}; expected ${platform}'")
+    }
   }
 
   # Generate all the needed pe.conf files
@@ -143,12 +149,12 @@
   peadm::file_content_upload($puppetdb_database_replica_pe_conf, '/tmp/pe.conf', $puppetdb_database_replica_target)
 
   # Download the PE tarball and send it to the nodes that need it
-  $pe_tarball_name     = "puppet-enterprise-${version}-el-7-x86_64.tar.gz"
+  $pe_tarball_name     = "puppet-enterprise-${version}-${platform}-x86_64.tar.gz"
   $local_tarball_path  = "${stagingdir}/${pe_tarball_name}"
   $upload_tarball_path = "/tmp/${pe_tarball_name}"
 
   run_plan('peadm::util::retrieve_and_upload', $pe_installer_targets,
-    source      => "https://s3.amazonaws.com/pe-builds/released/${version}/puppet-enterprise-${version}-el-7-x86_64.tar.gz",
+    source      => "https://s3.amazonaws.com/pe-builds/released/${version}/puppet-enterprise-${version}-${platform}-x86_64.tar.gz",
     local_path  => $local_tarball_path,
     upload_path => $upload_tarball_path,
   )

tasks/hostname.json

@@ -0,0 +1,8 @@
+{
+  "description": "Return pre-check information about a system",
+  "parameters": { },
+  "input_method": "environment",
+  "implementations": [
+    {"name": "precheck.sh"}
+  ]
+}

tasks/hostname.sh

@@ -0,0 +1,13 @@
+#!/bin/bash
+
+hostname=$(hostname -f)
+osfamily=$(cat /etc/os-release | grep -qi ubuntu && echo "ubuntu" || echo "el")
+version=$(grep VERSION_ID /etc/os-release | cut -d '"' -f 2)
+
+# Output a JSON result for ease of Task usage in Puppet Task Plans
+cat <<EOS
+  {
+    "hostname": "${hostname}",
+    "platform": "${osfamily}-${version}"
+  }
+EOS