https://github.com/iamseth/pepper

A CLI front-end the salt-api written in Go.
https://github.com/iamseth/pepper

cli pepper salt saltstack

Last synced: 3 months ago
JSON representation

A CLI front-end the salt-api written in Go.

• Host: GitHub
• URL: https://github.com/iamseth/pepper
• Owner: iamseth
• License: mit
• Created: 2015-09-11T18:01:37.000Z (over 9 years ago)
• Default Branch: master
• Last Pushed: 2017-12-16T20:09:32.000Z (about 7 years ago)
• Last Synced: 2024-09-30T13:40:48.165Z (3 months ago)
• Topics: cli, pepper, salt, saltstack
• Language: Go
• Size: 5.86 KB
• Stars: 15
• Watchers: 2
• Forks: 4
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# pepper

Pepper is a small CLI tool written in Go to run Salt commands against the HTTP API. It's very thin and there's almost no logic to the script.

Both PAM and LDAP auth methods are supported.

## Installation

```bash

go get github.com/iamseth/pepper

go install github.com/iamseth/pepper

```

## Usage

```bash

NAME:

   pepper - pepper   [ARGUMENTS ...]

USAGE:

   pepper [global options] command [command options] [arguments...]

VERSION:

   0.1.0

COMMANDS:

   help, h	Shows a list of commands or help for one command

GLOBAL OPTIONS:

   --hostname, -H 	Salt API hostname. Should include http[s]//. [$SALT_HOST]

   --username, -u 	Salt API username. [$SALT_USER]

   --password, -p 	Salt API password. [$SALT_PASSWORD]

   --auth, -a "ldap"	Salt authentication method. [$SALT_AUTH]

   --help, -h		show help

   --version, -v	print the version

```

## Examples

```bash

pepper -H https://saltmaster -u salt_user -p password -a ldap '*' test.ping

```

Or, if you set the following environment variables:

```bash

$SALT_USER

$SALT_HOST

$SALT_AUTH

$SALT_PASSWORD

```

you can just do the following:

```bash

# Ping all your hosts

pepper '*' test.ping

# Restart Apache on your web servers

pepper 'web*' cmd.run 'service httpd restart'

# Run a highstate on your Redis boxes

pepper 'redis*' state.highstate

```