Getting Started

Getting Started

This guide will help you set up your local development environment.

Prerequisites

• Vagrant with Parallels provider
• rbenv for Ruby version management
• Bundler for Ruby dependencies

Ruby Setup

This project uses Ruby 3.2.8 (pinned in .ruby-version) to match Puppet Enterprise. Set it up with rbenv:

rbenv install 3.2.8    # Install the required Ruby version
ruby -v                # Verify: should show ruby 3.2.8

Starting the Vagrant Environment

vagrant up              # Start all VMs (puppet, agent01, agent02)
vagrant ssh puppet      # SSH to the Puppet master
vagrant ssh agent01     # SSH to CentOS agent
vagrant ssh agent02     # SSH to Ubuntu agent
vagrant provision       # Re-run provisioning

The control-repo is synced to /etc/puppetlabs/code/environments/production on the Puppet master.

Running Puppet on Agents

From within an agent VM:

sudo /opt/puppetlabs/bin/puppet agent -t

Installing Forge Modules

On the Puppet master:

/opt/puppetlabs/puppet/bin/r10k puppetfile install

Next Steps

• Testing - Learn how to run tests
• Architecture - Understand the codebase structure