ARCHIVED

See instead: https://github.com/ncsa/docker_puppet

This repo has been archived. All new work will be done at the linked repo above.

docker_puppet

Requirements

Install each of the dependencies below:

• docker
• docker-compose

Quickstart

Get pupperware

• git clone https://github.com/puppetlabs/pupperware
• cd pupperware

Note: All commands below are expected to be run from inside the pupperware directory.

Install customizations from this repo

• export QS_REPO=https://github.com/andylytical/docker_puppet
• #export QS_GIT_BRANCH=branch_name (optional - specify a branch other than master)
• curl https://raw.githubusercontent.com/andylytical/quickstart/master/quickstart.sh | bash

Review .env settings

• vim .env

Start puppetserver

• docker-compose up -d
• Ensure all containers are started and healthy
  • watch "docker-compose ps"
  • Press Ctl-c to exit "watch" when all containers are healthy

Sample output when all containers are started and healthy:

       Name                       Command                  State               Ports
------------------------------------------------------------------------------------------------
pupperware_postgres_1   docker-entrypoint.sh postgres    Up (healthy)   5432/tcp
pupperware_puppet_1     dumb-init /docker-entrypoi ...   Up (healthy)   0.0.0.0:8140->8140/tcp
pupperware_puppetdb_1   dumb-init /docker-entrypoi ...   Up (healthy)   0.0.0.0:32779->8080/tcp,
                                                                        0.0.0.0:32778->8081/tcp

Configure ENC

• Review enc table layout
  • vim server/enc/tables.yaml
• Review enc config
  • vim server/enc/config.ini
• Install enc in the container
  • server/enc/setup.sh
• Verify enc setup
  • bin/enc_adm -l
  • bin/enc_adm --help

See also: ncsa/puppetserver-enc

Configure R10K

• Review r10k configuration
  • vim server/r10k/r10k.yaml
• Review r10k wrapper configuration
  • vim server/r10k/config.ini
• Apply r10k config in the container
  • server/r10k/setup.sh
• Verify r10k can access all the repos in it's config
  • bin/verify_repo_access
  • Resolve any errors before proceeding
  • See also: Non-interactive access to a private git server (behind a firewall)
• Run R10K
  • bin/r10k
  • No output means successful run. In the case of errors, view latest log file with:
  • bin/r10k_log

Other Actions

• Add nodes to the ENC
• Puppet agent in Vagrant VM
• Non-interactive access to a private git server (behind a firewall)
• Extras
• Add pupperware/bin to PATH:
  • server/bashrc/setup.sh