Bolt is a Ruby command-line tool for executing commands, scripts, and tasks on remote systems using SSH and WinRM.
- Executes commands on remote nix and Windows systems.
- Distributes and execute scripts, such as Bash, PowerShell, Python.
- Scales to more than 1000 concurrent connections.
- Supports industry standard protocols (SSH/SCP, WinRM/PSRP) and authentication methods (password, publickey).
Installing bolt from a gem is not recommended since core modules will not be available. Please install bolt as a package
This repository is an example skeleton Bolt project. A Bolt project contains all of the configuration, code, and data loaded by Bolt. Read about Bolt projects to learn more.
├── .modules
├── bolt-project.yaml
├── data
│ └── common.yaml
├── hiera.yaml
├── inventory.yaml
├── modules
├── Puppetfile
├── README.md
├── manifests
│ └── init.pp
├── plans
│ └── init.pp
└── tasks
├── init.json
└── init.sh
The bolt-project.yaml
file sets configuration options in the context of the bolt project. bolt-project.yaml reference
The data
directory is the default location to add hiera
data for the project. Hiera reference
The default location for hiera configuration. Hiera configuration reference
The inventory.yaml
file contains information about targets. You can group targets and define connection configuration. inventory.yaml reference
The Puppetfile
acts as a lock file for modules listed in bolt-project.yaml
. Bolt generates a
Puppetfile each time you modify your modules with a Bolt command. Do not edit the Puppetfile
directly. Instead, use Bolt commands to manage your modules, and rely on Bolt to manage the
Puppetfile.
This is where modules defined in bolt-project.yaml
are installed.
The modules
directory contains project-specific Bolt
modules, such as custom modules under
development.
The manifests
directory is used for Puppet manifest code that may be applied with Bolt.
The plans
directory contains plans. Plans reference
The tasks
directory contains tasks. Tasks reference
- #bolt on Slack - Join the Bolt developers and community