Installing Bolt and Creating a Project

Difficulty: Basic

Time: Approximately 10 minutes

In this exercise you will install Bolt and create a Bolt project directory so you can get started with Bolt.

Installing Bolt

Bolt is packaged for the major operating systems. Please refer to the installation documentation to install Bolt for the OS you are using.

Note For this lab and for most use cases it is recommended that bolt is NOT installed as a Ruby Gem. This is because optional (but highly useful) supporting modules are only included in packages and must be installed manually when using the Gem.

Creating a Bolt Project Directory

By default $HOME/.puppetlabs/bolt/ is the base directory for user-supplied data such as the configuration and inventory files. It is effectively the default Bolt project directory. You may find it useful to maintain a project specific Bolt project directory. When you commit a Bolt project directory to a project you can share Bolt configuration and code between users.

Bolt treats a directory containing a subdirectory called Boltdir as a project directory, and will traverse parents of the current directory until it finds a directory containing a Boltdir. You can read the official documentation to learn more about additional types of project directories.

To get started, create a directory called Boltdir within your project directory. Within the Boltdir you should also create a modules/ subdirectory, which holds modules from the Puppet Forge and code repositories, and a site-modules/ subdirectory, which holds project-specific modules. These two subdirectories are where Bolt will look for tasks, plans, and manifests.

If you are using the files included with this lab your project directory will end up looking like:

├── Boltdir
│   ├── inventory.yaml
│   ├── modules
│   │   └── ...
│   └── site-modules
│       └── ...
├── docker-compose.yml
├── Dockerfile
├── src/
└── Vagrantfile

Next Steps

Now that you have Bolt installed and have created a Bolt project directory you can move on to:

Setting Up Test Targets