Modules are self-contained bundles of code and data. You can write your own modules, and you can can download pre-built modules from the Puppet Forge. In this guide, you'll install a Puppet module, the primary means by which PE configures and manages nodes.
While you can use any module available on the Forge, PE customers can take advantage of supported modules. These modules are designed to make common services easier, and are tested and maintained by Puppet. In this getting started guide, you'll install the puppetlabs-apache module, a Puppet Enterprise-supported module.
These instructions assume you've installed a monolithic PE deployment, and have installed at least one *nix agent node.
Step 1: Install a Forge module
The Puppet Forge contains thousands of modules that you can use in your own environment.
- Install the Apache module by running
puppet module install puppetlabs-apache.
The results look like this:
Preparing to install into /etc/puppetlabs/code/environments/production/modules ... Notice: Downloading from http://forgeapi.puppetlabs.com ... Notice: Installing -- do not interrupt ... /etc/puppetlabs/code/environments/production/modules └── puppetlabs-apache (v1.1.1)
- Visit the Puppet Forge to learn more about the apache module.
You have just installed a Puppet module! Modules contain classes, which are named chunks of Puppet code and are the primary means by which Puppet Enterprise configures and manages nodes.
Next, you'll use the
apacheclass included in puppetlabs-apache to manage Apache on your agent node with Puppet Enterprise.