sweet

package module

v0.0.0-...-33b9329 Latest Latest Go to latest Published: May 22, 2015 License: BSD-3-Clause Imports: 18 Imported by: 1

Details

Valid go.mod file
Redistributable license
Tagged version
Stable version
Learn more about best practices

Repository

github.com/appliedtrust/sweet

Links

Open Source Insights

README ¶

Network device configuration backups and change alerts for the 21st century - inspired by RANCID!

See: http://gosweet.org

##Features:

Stores device configs in Git
Simple configuration file
Single binary - only runtime dependency is Git
Email notifications
Built-in web status dashboard
Embedded Cisco IOS/ASA and Juniper JunOS support
Supports external collection scripts (such as clogin, jlogin, etc.)
Currently supports Linux and OSX

##Quickstart:

Download the sweet binary for your system: https://github.com/AppliedTrust/sweet/releases
Make it executable: chmod 755 sweet32
Create a minimal sweet.conf file with device access info:

[router1.example.com]
method = cisco
user = sweetuser
pass = SecretPW4sweet

Start sweet with: sweet32 --web sweet.conf
Check out the web status at: http://localhost:5000

##Usage:

All command-line flags can also be set in the config file.
See the sample config for more options: https://github.com/AppliedTrust/sweet/blob/master/sweet-sample.conf

  sweet [options] <config>
  sweet -h --help
  sweet --version

Options:
  -w, --workspace <dir>     Specify workspace directory [default: ./workspace].
  -i, --interval <secs>     Collection interval in secs [default: 300].
  -c, --concurrency <num>   Concurrent device collections [default: 30].
  -t, --to <email@addr>     Send change notifications to this email.
  -f, --from <email@addr>   Send change notifications from this email.
  -s, --smtp <host:port>    SMTP server connection info [default: localhost:25].
  --insecure                Accept untrusted SSH device keys.
  --push                    Do a "git push" after committing changed configs.
  --syslog                  Send log messages to syslog rather than stdout.
  --timeout <secs>          Device collection timeout in secs [default: 60].
  --web                     Run an HTTP status server.
  --weblisten <host:port>   Host and port to use for HTTP status server [default: localhost:5000].
  --version                 Show version.
  -h, --help                Show this screen.

##Authors:

Randy Else: https://appliedtrust.com/randy
Trent R. Hein: https://appliedtrust.com/trent
Ned McClain: https://appliedtrust.com/ned

##Contributors:

jcollie: https://github.com/jcollie

Documentation ¶

Index ¶

func Asset(name string) ([]byte, error)
func AssetDir(name string) ([]string, error)
func AssetNames() []string
func RunCollectors(Opts *SweetOptions)
type Cisco
- func (collector Cisco) Collect(device DeviceConfig) (map[string]string, error)
type Collector
type ConfigDiff
type DeviceConfig
type DeviceStatus
type DeviceStatusState
type External
- func (collector External) Collect(device DeviceConfig) (map[string]string, error)
type JunOS
- func (collector JunOS) Collect(device DeviceConfig) (map[string]string, error)
type SSHCollector
type Status
- func (s *Status) Get(device string) DeviceStatus
- func (s *Status) GetAll() map[string]DeviceStatus
- func (s *Status) Set(stat DeviceStatus)
type SweetOptions
- func (Opts *SweetOptions) LogChanges(message string)
- func (Opts *SweetOptions) LogErr(message string)
- func (Opts *SweetOptions) LogFatal(message string)
- func (Opts *SweetOptions) LogInfo(message string)
type WebReport

Constants ¶

This section is empty.

Variables ¶

This section is empty.

Functions ¶

func Asset ¶

func Asset(name string) ([]byte, error)

Asset loads and returns the asset for the given name. It returns an error if the asset could not be found or could not be loaded.

func AssetDir ¶

func AssetDir(name string) ([]string, error)

AssetDir returns the file names below a certain directory embedded in the file by go-bindata. For example if you run go-bindata on data/... and data contains the following hierarchy:

data/
  foo.txt
  img/
    a.png
    b.png

then AssetDir("data") would return []string{"foo.txt", "img"} AssetDir("data/img") would return []string{"a.png", "b.png"} AssetDir("foo.txt") and AssetDir("notexist") would return an error AssetDir("") will return []string{"data"}.

func AssetNames ¶

func AssetNames() []string

AssetNames returns the names of the assets.

func RunCollectors ¶

func RunCollectors(Opts *SweetOptions)

// Kickoff collector runs

Types ¶

type Cisco ¶

type Cisco struct {
}

func (Cisco) Collect ¶

func (collector Cisco) Collect(device DeviceConfig) (map[string]string, error)

type Collector ¶

type Collector interface {
	Collect(device DeviceConfig) (map[string]string, error)
}

type ConfigDiff ¶

type ConfigDiff struct {
	Diff    string
	Added   int
	Removed int
	NewFile bool
}

type DeviceConfig ¶

type DeviceConfig struct {
	Hostname       string
	Method         string
	Target         string
	Timeout        time.Duration
	CommandTimeout time.Duration
	Config         map[string]string
}

DeviceAccess stores host access info

type DeviceStatus ¶

type DeviceStatus struct {
	Device       DeviceConfig
	State        DeviceStatusState
	When         time.Time
	Configs      map[string]string
	Diffs        map[string]ConfigDiff
	ErrorMessage string
}

type DeviceStatusState ¶

type DeviceStatusState int

const (
	StatePending DeviceStatusState = iota
	StateError
	StateTimeout
	StateSuccess
)

type External ¶

type External struct {
}

func (External) Collect ¶

func (collector External) Collect(device DeviceConfig) (map[string]string, error)

type JunOS ¶

type JunOS struct {
}

func (JunOS) Collect ¶

func (collector JunOS) Collect(device DeviceConfig) (map[string]string, error)

type SSHCollector ¶

type SSHCollector struct {
	Receive chan string
	Send    chan string
}

type Status ¶

type Status struct {
	Status map[string]DeviceStatus
	Lock   sync.Mutex
}

func (*Status) Get ¶

func (s *Status) Get(device string) DeviceStatus

func (*Status) GetAll ¶

func (s *Status) GetAll() map[string]DeviceStatus

func (*Status) Set ¶

func (s *Status) Set(stat DeviceStatus)

type SweetOptions ¶

type SweetOptions struct {
	Interval      time.Duration
	Timeout       time.Duration
	GitPush       bool
	Insecure      bool
	Concurrency   int
	HttpListen    string
	HttpEnabled   bool
	SmtpString    string
	Workspace     string
	ExecutableDir string
	ToEmail       string
	FromEmail     string
	UseSyslog     bool
	DefaultUser   string
	DefaultPass   string
	DefaultMethod string
	Syslog        *syslog.Writer
	Devices       []DeviceConfig
	Status        *Status
}

func (*SweetOptions) LogChanges ¶

func (Opts *SweetOptions) LogChanges(message string)

func (*SweetOptions) LogErr ¶

func (Opts *SweetOptions) LogErr(message string)

func (*SweetOptions) LogFatal ¶

func (Opts *SweetOptions) LogFatal(message string)

// logging convenience methods

func (*SweetOptions) LogInfo ¶

func (Opts *SweetOptions) LogInfo(message string)

type WebReport ¶

type WebReport struct {
	DeviceStatus
	Class          string
	CSSID          string
	EnableDiffLink bool
	EnableConfLink bool
}

ReportWebData options for formatting web status page.

Source Files ¶

View all Source files

Directories ¶

Path	Synopsis
cmd

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL