Man page - bw(1)

Packages contains this manual

Package:  bundlewrap
apt-get install bundlewrap

Manuals in package:
• bw(1)
Documentations in package:
• bundlewrap

Manual

Bundlewrap

NAME
SYNOPSIS
DESCRIPTION
OPTIONAL ARGUMENTS
SUBCOMMANDS:
REPORTING BUGS
AUTHORS

---

NAME

bundlewrap - Decentralized configuration management system with Python

SYNOPSIS

bundlewrap [-h] [-a] [-A] [-d] [-r DIRECTORY] [--version] {apply, debug, groups, hash, items, lock, metadata, nodes, plot, repo, run, stats, test, verify, zen} ...

DESCRIPTION

BundleWrap fills the gap between complex deployments using Chef or Puppet and old school system administration over SSH. You do not need to know any Python in order to use Bundlewrap, but you can easily extend your bundles using Python.

While most other config management systems rely on a client-server architecture, BundleWrap works off a repository cloned to your local machine.

It then automates the process of SSHing into your servers and making sure everything is configured the way it’s supposed to be. You won’t have to install anything on managed servers.

OPTIONAL ARGUMENTS

-h, --help show this help message and exit
-a, --add-host-keys

set StrictHostKeyChecking=no instead of yes for SSH

-A, --adhoc-nodes

treat unknown node names as adhoc ’virtual’ nodes that receive configuration only through groups whose member_patterns match the node name given on the command line (which also has to be a resolvable hostname)

-d, --debug

print debugging info (implies -v)

-r DIRECTORY, --repo-path DIRECTORY

Look for repository at this path (defaults to current working directory)

--version

show program’s version number and exit

SUBCOMMANDS:

use ’bw <subcommand> --help’ for more info

	apply		Applies the configuration defined in your repository to your nodes
	debug		Start an interactive Python shell for this repository
	groups		Lists groups in this repository (deprecated, use ‘bw nodes -a‘)
	hash		Shows a SHA1 hash that summarizes the entire configuration for this repo, node, group, or item.
	items		List and preview items for a specific node
	lock		Manage locks on nodes used to prevent collisions between BundleWrap users

metadata

View a JSON representation of a node’s metadata

	nodes		List all nodes in this repository
	plot		Generates DOT output that can be piped into ‘dot -Tsvg -ooutput.svg‘. The resulting output.svg can be viewed using most browsers.
	repo		Various subcommands to manipulate your repository
	run		Run a one-off command on a number of nodes
	stats		Show some statistics about your repository
	test		Test your repository for consistency (you can use this with a CI tool like Jenkins)
	verify		Inspect the health or ’correctness’ of a node without changing it

REPORTING BUGS

Bundlewrap bug tracker: https://github.com/bundlewrap/bundlewrap/issues

AUTHORS

This manual page was written by Jonathan Carter <jcarter@linux.com> Bundlewrap was written by Torsten Rehn <torsten@rehn.email>

---