Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/jeff1evesque/puppet-demonstration
Foreman synched with puppetagent(s) ready for demonstration
https://github.com/jeff1evesque/puppet-demonstration
Last synced: 3 days ago
JSON representation
Foreman synched with puppetagent(s) ready for demonstration
- Host: GitHub
- URL: https://github.com/jeff1evesque/puppet-demonstration
- Owner: jeff1evesque
- License: other
- Created: 2016-10-08T01:02:01.000Z (about 8 years ago)
- Default Branch: master
- Last Pushed: 2020-03-03T01:59:00.000Z (almost 5 years ago)
- Last Synced: 2024-11-08T06:06:12.864Z (about 2 months ago)
- Language: Shell
- Homepage:
- Size: 152 KB
- Stars: 3
- Watchers: 2
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Contributing: contributing.md
- License: license.md
Awesome Lists containing this project
README
# Puppet Demonstration [](https://travis-ci.org/jeff1evesque/puppet-demonstration)
This repository is a simple demonstration of virtualized environments
([vagrant](https://www.vagrantup.com/) + [virtualbox](https://www.virtualbox.org/)),
tailored to exhibit the [puppetserver](https://docs.puppet.com/puppetserver/latest/services_master_puppetserver.html)
/ [puppetagent](https://docs.puppet.com/puppet/latest/reference/man/agent.html) ecosystem,
contained within [Centos 7x](https://www.centos.org/) operating systems.
Specifically, a custom vagrant [base box](https://www.vagrantup.com/docs/boxes/base.html),
has been created from a [minimal iso](http://isoredirect.centos.org/centos/7/isos/x86_64/CentOS-7-x86_64-Minimal-1511.iso),
which vagrant provisions via the [`Vagrantfile`](https://github.com/jeff1evesque/puppet-demonstration/blob/master/Vagrantfile),
using corresponding [install scripts](https://github.com/jeff1evesque/puppet-demonstration/tree/master/utility).
Though, it is recommended to use Centos 7x for both the puppetserver, and
additional puppetagents, the [install scripts](https://github.com/jeff1evesque/puppet-demonstration/tree/master/utility)
are flexible enough to allow puppetagent's to reside in [Centos 6x](https://wiki.centos.org/Download)
operating systems. Regardless of implementation, when vagrant completes
provisioning, a puppetserver, with a corresponding [foreman](https://theforeman.org/)
gui, is available on the host via the ip `192.168.0.10`, which can be used to manage various puppetagent nodes:
---
**Note:** the provided [install scripts](https://github.com/jeff1evesque/puppet-demonstration/tree/master/utility),
used to provision the corresponding vagrant virtual machine(s), can also be
used on production-like environments, just remember to replace the default ssl
keys, along with other system specific configurations.
## Configuration
Fork this project in your GitHub account. Then, clone your repository, with
one of the following approaches:
- [simple clone](https://github.com/jeff1evesque/machine-learning/blob/master/documentation/configuration/setup_clone.rst#simple-clone):
clone the remote master branch.
- [commit hash](https://github.com/jeff1evesque/machine-learning/blob/master/documentation/configuration/setup_clone.rst#commit-hash):
clone the remote master branch, then checkout a specific commit hash.
- [release tag](https://github.com/jeff1evesque/machine-learning/blob/master/documentation/configuration/setup_clone.rst#release-tag):
clone the remote branch, associated with the desired release tag.
## Installation
In order to proceed with the installation for this project, three dependencies
need to be installed:
- [Vagrant](https://www.vagrantup.com/)
- [Virtualbox 5.1.2](http://download.virtualbox.org/virtualbox/5.1.2/) (or higher)
- [Extension Pack 5.1.2](http://download.virtualbox.org/virtualbox/5.1.2/) (required)
Once the necessary dependencies have been installed, execute the following
command to build the puppetserver:
```bash
cd /path/to/puppet-demonstration/
vagrant up
```
**Note:** an alternative syntax to `vagrant up`, is to run `vagrant up puppetserver`.
Depending on the network speed, the build can take between 10-15 minutes. So,
grab a cup of coffee, and perhaps enjoy a danish while the virtual machine
builds.
**Note:** a more complete refresher on virtualization, can be found within the
vagrant [wiki page](https://github.com/jeff1evesque/machine-learning/wiki/Vagrant).
When `vagrant up` completes, a `puppetserver` will be installed on the
[primary machine](https://github.com/jeff1evesque/puppet-demonstration/blob/3145a783e3822e465419606e8ff96899bd2b116e/Vagrantfile#L31-L32).
Next, a single `puppetagent`, can be configured, to the latter `puppetserver`:
```bash
cd /path/to/puppet-demonstration/
vagrant up puppetagent
```
Though, the implemented [install scripts](https://github.com/jeff1evesque/puppet-demonstration/tree/master/utility)
can be used to provision vagrant, it can be run on non-vagrant systems.
However, some assumptions are required. For example,
[`install_foreman`](https://github.com/jeff1evesque/puppet-demonstration/blob/7f08b038c1d9b54c2a464e6f8dc7c85834e25d2b/utility/install_foreman#L23-L27)
assumes the containing virtual machine, has a defined [proxy](https://en.wikipedia.org/wiki/Proxy_server):
```bash
...
## acquire proxy ip
read -p 'Enter your proxy ip > ' PROXY_IP
## acquire proxy port
read -p 'Enter your proxy port > ' PROXY_PORT
...
```
**Note:** the vagrant implementation does not require a proxy, which is why the
same install script, does not prompt, nor make such definitions.
The [install scripts](https://github.com/jeff1evesque/puppet-demonstration/tree/master/utility)
can easily be run on corresponding virtual machines:
```bash
# virtual machine for puppetserver
./install_foreman
# virual machine for puppetagent
./install_puppet_agent
```
**Note:** when running the above [install scripts](https://github.com/jeff1evesque/puppet-demonstration/tree/master/utility)
on non-vagrant environments, simply follow the bash prompts.
## Testing / Execution
Once the [installation](https://github.com/jeff1evesque/puppet-demonstration/blob/master/README.md#installation)
is complete, the `puppetserver` can provision various `puppetagent` nodes,
using the foreman gui, as a middle layer between the two. However, each
`puppetagent` must be synchronized to the `puppetserver`:
```bash
$ vagrant ssh puppetagent
==> puppetagent: The machine you're attempting to SSH into is configured to use
==> puppetagent: password-based authentication. Vagrant can't script entering the
==> puppetagent: password for you. If you're prompted for a password, please enter
==> puppetagent: the same password you have configured in the Vagrantfile.
Enter passphrase for key '/c/Users/jeff1evesque/.ssh/id_rsa':
[email protected]'s password:
Last login: Sun Oct 16 12:30:18 2016 from gateway
[provisioner@localhost ~]$ sudo su
[root@localhost provisioner]# puppet agent -t
Info: Creating a new SSL key for localhost.localdomain
Info: csr_attributes file loading from /etc/puppetlabs/puppet/csr_attributes.yaml
Info: Creating a new SSL certificate request for localhost.localdomain
Info: Certificate Request fingerprint (SHA256): 1B:A2:76:58:9D:C8:D2:59:A2:5B:CC:E3:C9:2F:6E:C7:62:72:3A:6E:AE:B0:B6:AE:02:ED:87:8F:CA:30:8D:20
Info: Caching certificate for localhost.localdomain
Info: Caching certificate_revocation_list for ca
Info: Caching certificate for localhost.localdomain
Info: Using configured environment 'production'
Info: Retrieving pluginfacts
Info: Retrieving plugin
Info: Caching catalog for localhost.localdomain
Info: Applying configuration version '1476635580'
Info: Creating state file /opt/puppetlabs/puppet/cache/state/state.yaml
Notice: Applied catalog in 0.02 seconds
```
Now, the foreman gui can be used to manage the corresponding agent node, via an
[internal network](https://github.com/jeff1evesque/puppet-demonstration/blob/3145a783e3822e465419606e8ff96899bd2b116e/Vagrantfile#L99),
on `192.168.0.10`.
**Note:** some general [modules](https://github.com/jeff1evesque/puppet-demonstration/tree/master/code/modules)
have been included, as an exercise, to the foreman implementation.