The 0.4.x branch of puppetlabs-pe_xl (a.k.a. puppetlabs-peadm) should
support deploying PE 2018.1 stacks for testing and validation in support
of customers using that version of PE. Note that it is not recommended
any new customers perform new deployments of that PE version.

To match 0.5.x

After upgrade, several changes are consistenly made on the master node.
This commit runs Puppet on the master once as part of the upgrade to
ensure these changes are taken care of at the same time the rest of the
upgrade is.

Commit includes minor code changes to support this use case, and an
addition to the documentation detailing how to upgrade using the
Orchestrator transport.

Due to master services restarting during a Puppet run

Make it match the install and configure ones

In RHEL, VERSION_ID can be something like "7.3", rather than just "7".
So for EL os's strip out the minor version when calculating the platform
tag.

  * This backports a number of commits from the master branch
    pertaining to testing on docker.

  * Previously working on this module required a buildout
    of a puppet infrastructure with VMs or cloud providers.
    Which can sometimes be costly or take hours to deploy.

    This commit uses containers and docker-compose to produce
    sample environments for each architecuture in order to
    perform rapid prototyping or test the functionality of this module
    and the puppet infra command.

    The architectures supported in this command are:
      * standard, stadard-ha
      * large, large-ha
      * extra-large, extra-large-ha

    While there are many other possiblites and combinations of amount
    of servers and containers these are the current choices.

    For more information please see documention/docker_examples.md

  * When using the example docker containers you will
    have the ability to see what files are copied over to the
    system for inspection.

  * previously the example docker files used a static
    directory for bolt scripts.  This removes the script-dir
    so bolt will create a unique one each time.

  * Also adds the live_audit script to systemd.
    This will cause systemd to startup the audit on boot
    so all bolt files will be copied over to /tmp/backup
    for investigation.

  * When running puppetdb queries in the container it is helpful to
    have the the config file setup already. This commit configures
    the puppetdb.conf file on the puppet servers.

  * The docker container for bolt was having some encoding issues
    after running a plan.  This fixes that issue so the plan/command
    does not fail.

  * Only applies to the example docker containers

  * This only applies to our example docker containers.
    If the docker host reboots, the containers will now
    restart upon reboot. Was just too annoying before to always
    have to start up the machines again.

  * previously if the sign or request cert tasks were
    run twice, the tasks would fail.  This adds idempotency
    to the submit_csr tasks.
  * Also backports the sign_csr and submit_csr tasks and updates the
    install plan to use sign_csr instead of the puppet apply.

Backport docker examples for 2018

Somehow the 0.4.2 tag split off of the 0.4.x branch. This commit merges
it back in.