Tasks and plans are packaged in Puppet modules, so you can install them as you would any module and manage them with a Puppetfile.
Bolt is packaged with a collection of useful modules to support common workflows.
Modules with useful task and plan content
Core Puppet providers
augeas_core: Manage configuration files using Augeas.
host_core: Manage host entries in a hosts file.
scheduled_task: Provider capable of using the Version 2 Windows API for task management.
cron_core: Install and manage
mount_core: Manage mounted filesystems and mount tables.
selinux_core: Manage Security-Enhanced Linux.
yumrepo_core: Manage client yum repo configurations by parsing INI configuration files.
zone_core: Manage Solaris zone resources.
Bolt specific modules that are not available on the Forge
Set up Bolt to download and install modules
Before you can use Bolt to install modules, you must first create a Puppetfile. A Puppetfile is a formatted text file that contains a list of modules and their versions. It can include modules from the Forge or a Git repository.
For modules that require Ruby gems, see Install gems with Bolt packages
For more details about specifying modules in a Puppetfile, see the Puppetfile documentation.
- Create a file named Puppetfile and store it in the Boltdir, which can be a directory named Boltdir at the root of your project or a global directory in
- Open the Puppetfile in a text editor and add the modules and versions that you want to install. If the modules have dependencies, list those as well.
# Modules from the Puppet Forge. mod 'puppetlabs-package', '0.3.0' mod 'puppetlabs-service', '0.4.0' mod 'puppetlabs-puppet_conf', '0.3.0' mod 'puppetlabs-facts', '0.3.1' # Modules from a Git repository. mod 'puppetlabs/puppetlabs-facter_task', git: 'firstname.lastname@example.org:puppetlabs/puppetlabs-facter_task.git', ref: 'master' mod 'puppet_agent', git: 'https://github.com/puppetlabs/puppetlabs-puppet_agent', ref: '319ce44a65e73bcf2712ad17be01f9636f0673c9'
- Add any task or plan modules stored locally in Boltdir to the list. If these modules are not listed in the Puppetfile, they are deleted.
mod 'myteam/app_foo', local: true
Alternately, any modules that you don't want to manage with the Puppetfile you can install to a different subdirectory in the Boltdir, such as
- From a terminal, install the modules listed in the Puppetfile:
bolt puppetfile install.
By default, Bolt installs modules to the modules subdirectory inside the Boltdir. To override this location, update the modulepath setting in the Bolt configuration file.