Skip to content
This repository has been archived by the owner on Nov 18, 2022. It is now read-only.

Latest commit

 

History

History
124 lines (74 loc) · 3.42 KB

DEVELOPMENT.md

File metadata and controls

124 lines (74 loc) · 3.42 KB
Raw

Development

Usually one needs a puppet master completeley configured.

One can use the psick vargant PE environment and spin up a centos 7 based Puppet Enterprise Master.

Vagrant setup

The environment needs some vagrant plugins to be fully functional:

vagrant plugin install vagrant-hostmanager vagrant-vbguest vagrant-pe_build

PSICK - Puppet Systems Infrastructure Constructoin Kit

Now one can clone the psick repository.

git clone https://github.com/example42/psick
cd psick

Next on needs to install the modules. This is done by installing r10k ruby gem and running r10k. Therefore one must have a ruby installation at hand (we recommend using the ruby-version which is mentioned in .ruby-version file (2.5.8)

bundle install --path vendor

Now we can install the puppet modules:

bundle exec r10k puppetfile install -v

Now we can spin up the vargant based puppet master:

cd vagrant/environments/pe
vargant up puppet.pe.psick.io

Next one can log in into the system:

vagrant ssh puppet.pe.psick.io
sudo -i

Now a puppet access token must be generated:

# generate an access token - note: username: admin, password: puppetlabs
puppet-access login -l 2y

The token will be saved in /root/.puppetlabs/token

If this produces an error like Unhandled exception: locale::facet::_S_create_c_locale name not valid you want to check your locale settings by running locale. When logging in from a macOS System you have to unset the LC_CTYPE local: unset LC_CTYPE

Setting a localw can be done by running

export LANG=en_US.UTF-8

Mock certificate information

Create a new external fact file:

mkdir -p /etc/puppetlabs/facter/facts.d
echo -e "role=puppet\nzone=pe\nenv=devel\ndatacenter=vagrant\n" > /etc/puppetlabs/facter/facts.d/hdm.txt

Now run puppet agent to add new facts to puppetdb: puppet agent --test

HDM

Add required packages

yum install -y gcc-c++ sqlite-devel zlib-devel
wget https://kojipkgs.fedoraproject.org//packages/sqlite/3.8.11/1.fc21/x86_64/sqlite-devel-3.8.11-1.fc21.x86_64.rpm
wget https://kojipkgs.fedoraproject.org//packages/sqlite/3.8.11/1.fc21/x86_64/sqlite-3.8.11-1.fc21.x86_64.rpm
yum install -y sqlite-3.8.11-1.fc21.x86_64.rpm sqlite-devel-3.8.11-1.fc21.x86_64.rpm

Now one can clone the hdm repository:

cd
git clone https://github.com/example42/hdm.git
cd hdm/

install gems

/opt/puppetlabs/puppet/bin/gem install bundler
/opt/puppetlabs/puppet/bin/bundle install --path vendor

install nodejs and yarn

curl --silent --location https://rpm.nodesource.com/setup_14.x | sudo bash
sudo yum install -y nodejs
curl --silent --location https://dl.yarnpkg.com/rpm/yarn.repo | sudo tee /etc/yum.repos.d/yarn.repo
sudo rpm --import https://dl.yarnpkg.com/rpm/pubkey.gpg
sudo yum install -y yarn
yarn install --check-files

Create the database with:

bundle exec rails db:create
bundle exec rails db:migrate
bundle exec rails db:seed

Configure hdm:

cp config/hdm.yml.template config/hdm.yml

Edit config file:

development:
  read_only: false
  puppet_db:
    server: "http://localhost:8080"
  config_dir: "/etc/puppetlabs/code"

Start the webserver with:

bundle exec rails server -b 0.0.0.0

Login:

Puppet Enterprise: https://puppet.pe.psick.io

Login: admin Password: puppetlabs

HDM: http://puppet.pe.psick.io:3000

if this does not work you can use localhost: http://localhost:3000