- Description
- Setup - The basics of getting started with
puppet
- Usage - Configuration options and additional functionality
- Limitations - OS compatibility, etc.
- Development - Guide for contributing to the module
This Puppet module is primarily designed to manage the Puppet server itself, automating its configuration, deployment, and maintenance tasks. This ensures the Puppet server operates efficiently and remains up-to-date.
Additionally, the module includes functionality to manage the Puppet agent as well.
This module can be utilized in two primary ways:
-
As a Regular Puppet Module (e.g., included in a Puppetfile)
For direct inclusion in your Puppet environment, specify the module in your Puppetfile as follows:
mod 'puppet', git: 'https://github.com/aursu/puppet-puppet.git', tag: 'v0.19.1'
Alternatively, you can specify the version directly if itβs available from the module repository on Puppet Forge:
mod 'aursu/puppet', '0.19.1'
-
As a Puppet Server Bootstrap Tool Using Puppet Bolt
The module includes a Bolt project located in the
bootstrap/bolt
subfolder. Within this project, there is a Bolt plan namedpuppet_bootstrap::server
that is specifically designed for bootstrapping a Puppet server.Using this setup with Puppet Bolt facilitates a more efficient and straightforward installation process for the Puppet server. This method provides a predefined sequence of actions that automate much of the manual setup, streamlining the deployment of Puppet server environments. It also significantly reduces the complexity of the initial server configuration.
Initiate the bootstrapping and subsequent Puppet agent run in the production environment with the following commands:
bolt plan run puppet_bootstrap::server -t puppetservers bolt plan run puppet_agent::run -t puppetservers environment=production
For a more detailed description, refer to the
bootstrap
directory.
When integrated into a Puppet catalog to configure a Puppet server, the puppet
module offers comprehensive control over several crucial configurations and components of both the Puppet server and the overall Puppet infrastructure: