Skip to content
This repository has been archived by the owner on Dec 16, 2019. It is now read-only.

cliffano/breaker

Repository files navigation

Avatar

Build Status Dependencies Status Coverage Status Published Version
npm Badge

Breaker

Breaker is a utility tool for other server management tools.

This is handy when you want to remotely execute shell command via SSH on multiple hosts. Also useful when you want to format various host files (clusterssh config, Ansible inventory, SSH config) from a single .breaker.json configuration file.

Installation

npm install -g breaker 

Usage

Create sample Breaker hosts file:

breaker init

Format hosts info into clusterssh config:

breaker -t clusterssh format

Format hosts info into Ansible inventory:

breaker -t ansible format

Format hosts info into SSH config:

breaker -t sshconfig format

Format selected hosts info into clusterssh config:

breaker -t clusterssh -l label1,label2 format

Remotely execute shell command via SSH in series:

breaker ssh <command>

remember to wrap command in quotes, e.g. "pwd; df -kh; uname -a;"

Remotely execute shell command via SSH on selected hosts in series:

breaker -l label1,label2 ssh <command>

Filter label using regular expressions

breaker -l .*dev.*,^prod,backup$ ssh <command>

Configuration

.breaker.json contains an array of host objects.

For standard SSH (current user, default port, no key), only host needs to be specified, labels are useful for filtering hosts by labels:

[
  { "host": "dev1.com", "labels": [ "dev" ] },
  { "host": "dev2.com", "labels": [ "dev" ] },
  { "host": "prod1.com", "labels": [ "prod" ] }
]

For SSH with specific key, user, and port (all optionals):

[
  { "host": "dev1.com", "labels": [ "dev" ],
    "ssh":
      [
        { "user": "user1", "port": 2222, "key": "path/to/key1" },
        { "user": "user2", "port": 2223, "key": "path/to/key2" }
      ]
    }
]

Colophon

Developer's Guide

Build reports:

About

[retired] Utility tool for various server management tools

Resources

License

Stars

Watchers

Forks

Packages

No packages published