Add docker support for experimentation

.fixtures.yml

@@ -8,5 +8,6 @@ fixtures:
     node_manager: 'https://github.com/WhatsARanjit/puppet-node_manager'
     apply_helpers: 'https://github.com/puppetlabs/puppetlabs-apply_helpers'
     bolt_shim: 'https://github.com/puppetlabs/puppetlabs-bolt_shim'
+    debug: 'https://github.com/nwops/puppet-debug'
   symlinks:
     "peadm": "#{source_dir}"

.gitignore

@@ -25,4 +25,5 @@
 .project
 .envrc
 /inventory.yaml
-.rerun.json
+.rerun.json
+*.tar.gz

.ruby-version

@@ -0,0 +1 @@
+2.6.5

README.md

@@ -23,3 +23,4 @@ Reference:
 * [Classification](documentation/classification.md)
 * [Architectures](documentation/architectures.md)
 * [Testing](documentation/pre_post_checks.md)
+* [Docker Based Examples](documentation/docker_examples.md)

documentation/docker_examples.md

@@ -0,0 +1,80 @@
+## Docker Based Examples
+This module provides docker compose files for the various architectures for experimentation purposes. This gives you the ability to stand up an entire PE stack in order to learn how this module and HA works. If you have docker and docker-compose you can start up a full Puppet architecture with a single command.  Please note that Puppet does not support PE on containers in production.  
+
+In order to decouple Bolt from a dev system, a special bolt container is created that will run all the bolt commands.  This is
+required to achieve maximum portability.  Should you want to run bolt commands against the PE stack you must
+first login to this bolt container via ssh, docker or docker-compose.
+
+Example: `docker-compose run --entrypoint=/bin/bash bolt`
+
+### Requirements
+To run the container based examples you will need the following requirements:
+
+2. Docker
+3. Docker compose
+4. 16GB memory, 24GB+ for XL and XL-HA architectures
+5. CPU with many cores (Tested with Core i7 6700)
+
+### Starting the example
+We have provided a provision.sh script to help making these examples simple.
+To use perform the following:
+
+1. cd spec/docker
+2. bash provision.sh
+3. select desired architecture when prompted (ie. extra-large-ha )
+4. Wait 10-20 minutes for provisioning to complete
+
+```
+Please choose a PE architecture to build: 
+1) extra-large/     3) large/           5) standard/
+2) extra-large-ha/  4) large-ha/        6) standard-ha/
+#?  
+```
+
+### Stopping the example
+In order to stop and remove the containers you will need to perform the following.
+
+1. cd spec/docker
+2. `cd <chosen architecture>` 
+3. docker-compose down
+
+### Logging into the console
+You can login to the PE Console after successful provision.  However, first you will need to 
+grab the mapped port number of the PE console.  The port numbers are mapped dynamically as to not
+cause port conflicts on your system. To see how the ports are mapped you can view them via:
+
+1. docker ps
+    ```
+    80c6f0b5525c        pe-base             "/sbin/init"        2 hours ago         Up 2 hours          0.0.0.0:32774->22/tcp, 0.0.0.0:32773->443/tcp, 0.0.0.0:32772->4433/tcp, 0.0.0.0:32771->8080/tcp, 0.0.0.0:32770->8081/tcp, 0.0.0.0:32769->8140/tcp, 0.0.0.0:32768->8443/tcp   pe-lg.puppet.vm
+    ```
+2. Note the mapped port for 443, which in this case is 32773
+3. Visit https://localhost:32773 in your browser
+4. Accept security risk (self signed cert)
+5. Login: admin/puppetlabs
+
+### Logging into any of the containers
+Ssh is running in all the containers so you can use ssh if you grab the mapped ssh port number. `ssh root@localhost -p 32774`
+
+Login: root/test
+
+You can also bypass ssh and run docker exec or docker-compose exec
+
+1. cd spec/docker/extra-large
+2. docker-compose exec pe_xl_core /bin/bash
+
+**Note:** pe_xl_core is the name of the service defined in the respective docker-compose file.
+
+This will run an interactive bash shell in the running container.
+
+### Upgrades
+There is also a upgrade.sh script that is similar to the provision.sh script.  This script will upgrade an already provisioned PE stack to the version specified in the update_params.json file.
+
+### Other notes
+1. The provision plan is not fully idempotent.
+2. Some tasks may fail when run due to resource constraints.
+3. You can rerun the provision.sh script on the same architecture without destroying the containers.  This can sometimes complete the provision process successfully. 
+4. Rerunning the provision script may result in errors due to idempotency issues with tasks and plans.
+5. Please remember you are starting the equilivent of 3-6 VMs on a single system.  
+6. You can use top to view all the processes being run in the containers.
+7. Docker will use the privilege mode option when running these examples (systemd support)
+8. Systemd is running inside these containers!  The real systemd, not the fake one.

spec/docker/Dockerfile

@@ -0,0 +1,25 @@
+# In order to run this with systemd you must do one of the following
+# use  --privileged  when running the container
+# mount the volume when running the container -v /sys/fs/cgroup:/sys/fs/cgroup:ro
+# docker run –privileged -ti -v /sys/fs/cgroup:/sys/fs/cgroup:ro -p 2222:22 
+FROM centos:7
+EXPOSE 22
+ENV LC_ALL="en_US.UTF-8" LANG="en_US.UTF-8" LANGUAGE="en_US.UTF-8"
+RUN echo "LANG=en_US.UTF-8" > /etc/locale.conf
+STOPSIGNAL SIGRTMIN+3
+RUN yum -y install systemd openssh openssh-server openssh-clients anacron sudo curl openssl; yum clean all;
+RUN (cd /lib/systemd/system/sysinit.target.wants/; for i in *; do [ $i == systemd-tmpfiles-setup.service ] || rm -f $i; done); \ 
+  rm -f /lib/systemd/system/multi-user.target.wants/*; \
+  rm -f /etc/systemd/system/*.wants/*; \
+  rm -f /lib/systemd/system/local-fs.target.wants/*; \
+  rm -f /lib/systemd/system/sockets.target.wants/*udev*; \
+  rm -f /lib/systemd/system/sockets.target.wants/*initctl*; \
+  rm -f /lib/systemd/system/basic.target.wants/*; \
+  rm -f /lib/systemd/system/anaconda.target.wants/*; \
+  rm -rf /var/cache/yum; \
+  echo "root:test" | chpasswd; \
+  useradd -m -s /bin/bash centos && echo "centos:test" | chpasswd; \
+  ln -s '/usr/lib/systemd/system/sshd.service' '/etc/systemd/system/multi-user.target.wants/sshd.service'
+VOLUME [ “/sys/fs/cgroup” ]
+CMD /sbin/init
+# ENTRYPOINT [ "/sbin/init" ]

spec/docker/Dockerfile_bolt

@@ -0,0 +1,7 @@
+FROM puppet/puppet-bolt
+ENV LC_ALL="en_US.UTF-8" LANG="en_US.UTF-8" LANGUAGE="en_US.UTF-8"
+RUN echo "LANG=en_US.UTF-8" > /etc/locale.conf
+RUN apt-get update && apt-get install -y ssh sudo curl; \
+   /opt/puppetlabs/bolt/bin/gem install bundler puppet-debugger -N -q
+CMD /bin/bash
+ENTRYPOINT [ "/opt/puppetlabs/bin/bolt" ]

spec/docker/extra-large-ha/docker-compose.yaml

@@ -0,0 +1,120 @@
+version: "3"
+services:
+  bolt:
+    build:
+      dockerfile: '../Dockerfile_bolt'
+      context: .
+    image: pe-bolt
+    hostname: bolter.puppet.vm
+    container_name: bolter.puppet.vm
+    volumes:
+      - .:/app
+    working_dir: /app
+    depends_on:
+      - pe_xl_core_0
+  compiler1:
+    depends_on:
+      - pe_xl_core_0
+    build:
+      dockerfile: '../Dockerfile'
+      context: .
+    entrypoint: /sbin/init
+    image: pe-base
+    privileged: true # required for systemd
+    ports:
+      - "22"
+      - "8140"
+    hostname: pe-xl-compiler-0.puppet.vm
+    container_name: pe-xl-compiler-0.puppet.vm
+    stop_signal: SIGRTMIN+3
+    tmpfs:
+      - /run
+      - /tmp
+    volumes:
+      - '/sys/fs/cgroup:/sys/fs/cgroup:ro'  
+  pe_pdb:
+    depends_on:
+      - pe_xl_core_0
+    build:
+      dockerfile: '../Dockerfile'
+      context: .
+    entrypoint: /sbin/init
+    image: pe-base
+    privileged: true # required for systemd
+    ports:
+      - "22"
+    hostname: pe-xl-db-0.puppet.vm
+    container_name: pe-xl-db-0.puppet.vm
+    stop_signal: SIGRTMIN+3
+    tmpfs:
+      - /run
+      - /tmp
+    volumes:
+      - '/sys/fs/cgroup:/sys/fs/cgroup:ro' 
+  pe_pdb-replica:
+    depends_on:
+      - pe_xl_core_0
+    build:
+      dockerfile: '../Dockerfile'
+      context: .
+    entrypoint: /sbin/init
+    image: pe-base
+    privileged: true # required for systemd
+    ports:
+      - "22"
+    hostname: pe-xl-db-1.puppet.vm
+    container_name: pe-xl-db-1.puppet.vm
+    stop_signal: SIGRTMIN+3
+    tmpfs:
+      - /run
+      - /tmp
+    volumes:
+      - '/sys/fs/cgroup:/sys/fs/cgroup:ro'       
+  pe_xl_core_1:
+    depends_on:
+      - pe_xl_core_0
+    build:
+      dockerfile: '../Dockerfile'
+      context: .
+    entrypoint: /sbin/init
+    image: pe-base
+    privileged: true # required for systemd
+    ports:
+      - "22"
+      - "8140"
+      - "8443"
+      - "8080"
+      - "8081"
+      - "4433"
+      - "443"
+    container_name: pe-xl-core-1.puppet.vm
+    hostname: pe-xl-core-1.puppet.vm
+    stop_signal: SIGRTMIN+3
+    tmpfs:
+      - /run
+      - /tmp
+    volumes:
+      - '/sys/fs/cgroup:/sys/fs/cgroup:ro'      
+  pe_xl_core_0:
+    build:
+      dockerfile: '../Dockerfile'
+      context: .
+    entrypoint: /sbin/init
+    image: pe-base
+    privileged: true # required for systemd
+    ports:
+      - "22"
+      - "8140"
+      - "8443"
+      - "8080"
+      - "8081"
+      - "4433"
+      - "443"
+    hostname: pe-xl-core-0.puppet.vm
+    container_name: pe-xl-core-0.puppet.vm
+    stop_signal: SIGRTMIN+3
+    tmpfs:
+      - /run
+      - /tmp
+    volumes:
+      - '/sys/fs/cgroup:/sys/fs/cgroup:ro'    

spec/docker/extra-large-ha/inventory.yaml

@@ -0,0 +1,18 @@
+---
+groups:
+  - name: puppet-enterprise-nodes
+    config:
+      transport: ssh
+      ssh:
+        tmpdir: /root
+        script-dir: test123
+        host-key-check: false
+        user: root
+        password: test
+        tty: true
+    targets:
+      - pe-xl-compiler-0.puppet.vm
+      - pe-xl-db-0.puppet.vm
+      - pe-xl-db-1.puppet.vm
+      - pe-xl-core-0.puppet.vm
+      - pe-xl-core-1.puppet.vm

spec/docker/extra-large-ha/params.json

@@ -0,0 +1,12 @@
+{
+  "master_host": "pe-xl-core-0.puppet.vm",
+  "puppetdb_database_host": "pe-xl-db-0.puppet.vm",
+  "puppetdb_database_replica_host": "pe-xl-db-1.puppet.vm",
+  "master_replica_host": "pe-xl-core-1.puppet.vm",
+  "compiler_hosts": ["pe-xl-compiler-0.puppet.vm"],
+  "console_password": "puppetlabs",
+  "dns_alt_names": [ "puppet", "pe-xl-core-0.puppet.vm", "puppet-xl.vm" ],
+  "version": "2019.1.1",
+  "compiler_pool_address": "puppet-xl.vm",
+  "stagingdir": "/downloads"
+}

spec/docker/extra-large-ha/upgrade_params.json

@@ -0,0 +1,9 @@
+{
+    "master_host": "pe-xl-core-0.puppet.vm",
+    "puppetdb_database_host": "pe-xl-db-0.puppet.vm",
+    "puppetdb_database_replica_host": "pe-xl-db-1.puppet.vm",
+    "master_replica_host": "pe-xl-core-1.puppet.vm",
+    "compiler_hosts": ["pe-xl-compiler-0.puppet.vm"],
+    "version": "2019.5.0",
+    "stagingdir": "/downloads"
+}

spec/docker/extra-large/docker-compose.yaml

@@ -0,0 +1,76 @@
+version: "3"
+services:
+  bolt:
+    build:
+      dockerfile: '../Dockerfile_bolt'
+      context: .
+    image: pe-build
+    hostname: bolter.puppet.vm
+    container_name: bolter.puppet.vm
+    volumes:
+      - .:/app
+    working_dir: /app
+    depends_on:
+      - pe_xl_core
+  compiler1:
+    depends_on:
+      - pe_xl_core
+    build:
+      dockerfile: '../Dockerfile'
+      context: .
+    entrypoint: /sbin/init
+    image: pe-base
+    privileged: true # required for systemd
+    ports:
+      - "22"
+      - "8140"
+    hostname: pe-xl-compiler-0.puppet.vm
+    container_name: pe-xl-compiler-0.puppet.vm
+    stop_signal: SIGRTMIN+3
+    tmpfs:
+      - /run
+      - /tmp
+    volumes:
+      - '/sys/fs/cgroup:/sys/fs/cgroup:ro'  
+  pe_pdb:
+    depends_on:
+      - pe_xl_core
+    build:
+      dockerfile: '../Dockerfile'
+      context: .
+    entrypoint: /sbin/init
+    image: pe-base
+    privileged: true # required for systemd
+    ports:
+      - "22"
+    hostname: pe-xl-db-0.puppet.vm
+    container_name: pe-xl-db-0.puppet.vm
+    stop_signal: SIGRTMIN+3
+    tmpfs:
+      - /run
+      - /tmp
+    volumes:
+      - '/sys/fs/cgroup:/sys/fs/cgroup:ro'  
+  pe_xl_core:
+    build:
+      dockerfile: '../Dockerfile'
+      context: .
+    entrypoint: /sbin/init
+    image: pe-base
+    privileged: true # required for systemd
+    ports:
+      - "22"
+      - "8140"
+      - "8443"
+      - "8080"
+      - "8081"
+      - "4433"
+      - "443"
+    hostname: pe-xl-core-0.puppet.vm
+    container_name: pe-xl-core-0.puppet.vm
+    stop_signal: SIGRTMIN+3
+    tmpfs:
+      - /run
+      - /tmp
+    volumes:
+      - '/sys/fs/cgroup:/sys/fs/cgroup:ro'    

spec/docker/extra-large/inventory.yaml

@@ -0,0 +1,16 @@
+---
+groups:
+  - name: puppet-enterprise-nodes
+    config:
+      transport: ssh
+      ssh:
+        tmpdir: /root
+        script-dir: test123
+        host-key-check: false
+        user: root
+        password: test
+        tty: true
+    targets:
+      - pe-xl-compiler-0.puppet.vm
+      - pe-xl-db-0.puppet.vm
+      - pe-xl-core-0.puppet.vm