jazigo alternatives and similar packages
Based on the "Networking" category.
Alternatively, view jazigo alternatives based on common mentions on social networks and blogs.
-
fasthttp
Fast HTTP package for Go. Tuned for high performance. Zero memory allocations in hot paths. Up to 10x faster than net/http -
Netmaker
Netmaker makes networks with WireGuard. Netmaker automates fast, secure, and distributed virtual networks. -
gnet
🚀 gnet is a high-performance, lightweight, non-blocking, event-driven networking framework written in pure Go. -
fortio
Fortio load testing library, command line tool, advanced echo server and web UI in go (golang). Allows to specify a set query-per-second load and record latency histograms and other useful stats. -
mqttPaho
The Paho Go Client provides an MQTT client library for connection to MQTT brokers via TCP, TLS or WebSockets. -
nbio
Pure Go 1000k+ connections solution, support tls/http1.x/websocket and basically compatible with net/http, with high-performance and low memory cost, non-blocking, event-driven, easy-to-use. -
gev
🚀Gev is a lightweight, fast non-blocking TCP network library / websocket server based on Reactor mode. Support custom protocols to quickly and easily build high-performance servers. -
gmqtt
Gmqtt is a flexible, high-performance MQTT broker library that fully implements the MQTT protocol V3.x and V5 in golang -
easytcp
:sparkles: :rocket: EasyTCP is a light-weight TCP framework written in Go (Golang), built with message router. EasyTCP helps you build a TCP server easily fast and less painful. -
peerdiscovery
Pure-Go library for cross-platform local peer discovery using UDP multicast :woman: :repeat: :woman: -
raw
DISCONTINUED. Package raw enables reading and writing data at the device driver level for a network interface. MIT Licensed. -
ethernet
Package ethernet implements marshaling and unmarshaling of IEEE 802.3 Ethernet II frames and IEEE 802.1Q VLAN tags. MIT Licensed.
CodeRabbit: AI Code Reviews for Developers
Do you think we are missing an alternative of jazigo or a related project?
Popular Comparisons
README
Table of Contents
- About Jazigo
- Supported Platforms
- Features
- Requirements
- Quick Start - Short version
- Quick Start - Detailed version
- Global Settings
- Importing Many Devices
- Using AWS S3
- Calling an external program
Created by gh-md-toc
About Jazigo
Jazigo is a tool written in Go for retrieving configuration for multiple devices, similar to rancid, fetchconfig, oxidized, Sweet.
Installation and usage are supposed to be dead simple. If you hit any surprising difficulty, please report.
Supported Platforms
Please send pull requests for new plataforms.
- Cisco ACI APIC
- Cisco IOS
- Cisco IOS XR
- Cisco NGA
- Datacom DmSwitch
- Fortigate FortiOS
- HTTP (collect output of http GET method)
- Huawei VRP
- Juniper JunOS
- Linux (collect output of SSH commands)
- Mikrotik
- Run (run external program and collect its output)
Features
- Written in Go. Single executable file. No runtime dependency.
- Straightforward usage: run the binary then point browser to web UI. Default settings should work out-of-the-box.
- Tool configuration is automatically saved as YAML. However one is NOT supposed to edit configuration file directly.
- Spawns multiple concurrent lightweight goroutines to quickly handle large number of devices.
- Very easy to add support for new platforms. See the Cisco IOS model as example.
- Backup files can be accessed from web UI.
- See file differences directly from the web UI.
- Support for SSH and TELNET.
- Can directly store backup files into AWS S3 bucket.
- Can call an external program and collect its output.
Requirements
- You need a system with the Go language in order to build the application. There is no special requirement for running it.
Quick Start - Short version
This is how to boot up Jazigo very quickly:
With Go Modules (starting from Go 1.11)
git clone https://github.com/udhos/jazigo ;# clone outside of GOPATH
cd jazigo
go install ./jazigo
mkdir etc repo log
JAZIGO_HOME=$PWD ~/go/bin/jazigo
Without Go Modules (before Go 1.11)
go get github.com/udhos/jazigo
cd ~/go/src/github.com/udhos/jazigo
./build.sh
mkdir etc repo log
JAZIGO_HOME=$PWD ~/go/bin/jazigo
Quick Start - Detailed version
Installation and usage are supposed to be dead simple. If you hit any surprising difficulty, please report.
If you want to build from source code, start from step 1.
If you downloaded the executable binary file, start from step 5.
1. Setup GOPATH as usual
Example:
#export GOPATH=~/go ;# starting from Go 1.8, GOPATH is no longer required
mkdir ~/go
2. Get dependencies
go get github.com/icza/gowut/gwu
go get github.com/udhos/lockfile
go get github.com/udhos/equalfile
go get github.com/udhos/difflib
go get gopkg.in/yaml.v2
go get golang.org/x/crypto/ssh
go get github.com/aws/aws-sdk-go
3. Get source code
go get github.com/udhos/jazigo
4. Compile and install
go install github.com/udhos/jazigo/jazigo
5. Decide where to store config, backup, log and static www files
Example:
export JAZIGO_HOME=$HOME/jazigo
mkdir $JAZIGO_HOME
cd $JAZIGO_HOME
mkdir etc repo log www
Hint: By default, Jazigo looks for directories 'etc', 'repo', 'log', and 'www' under $JAZIGO_HOME. If left undefined, JAZIGO_HOME defaults to /var/jazigo. See command line options to fine tune filesystem locations.
6. Copy static files (CSS and images) to $JAZIGO_HOME/www
Example:
# If you have downloaded jazigo using 'go get':
cp ~/go/src/github.com/udhos/jazigo/www/* $JAZIGO_HOME/www
# Otherwise get static files from https://github.com/udhos/jazigo/tree/master/www
cd $JAZIGO_HOME/www
wget https://raw.githubusercontent.com/udhos/jazigo/master/www/fail-small.png
wget https://raw.githubusercontent.com/udhos/jazigo/master/www/ok-small.png
wget https://raw.githubusercontent.com/udhos/jazigo/master/www/jazigo.css
wget https://raw.githubusercontent.com/udhos/jazigo/master/www/GitHub-Mark-32px.png
7. Run jazigo once (see -runOnce option)
$GOPATH/bin/jazigo -runOnce
Watch messages logged to standard output for errors.
Hint: Since root privileges are usually not needed, run Jazigo as a regular user.
8. Run jazigo forever
$GOPATH/bin/jazigo -disableStdoutLog
9. Open the web interface
Point web browser at: http://localhost:8080/jazigo
Global Settings
You might want to adjust global settings. See the Jazigo admin window under http://localhost:8080/jazigo/admin.
maxconfigfiles: 120
holdtime: 12h0m0s
scaninterval: 10m0s
maxconcurrency: 20
maxconfigloadsize: 10000000
maxconfigfiles: This option limits the amount of files stored per device. When this limit is reached, older files are discarded.
holdtime: When a successful backup is saved for a device, the software will only contact that specific device again after expiration of the 'holdtime' timer.
scaninterval: The interval between two device table scans. If the device table is fully processed before the 'scaninterval' timer, the software will wait idly for the next scan cycle. If the full table scan takes longer than 'scaninterval', the next cycle will start immediately.
maxconcurrency: This option limits the number of concurrent backup jobs. You should raise this value if you need faster scanning of all devices. Keep in mind that if your devices use a centralized authentication system (for example, Cisco Secure ACS), the authentication server might become a bottleneck for high concurrency.
maxconfigloadsize: This limit puts restriction into the amount of data the tool loads from a file to memory. Intent is to protect the servers' memory from exhaustion while trying to handle multiple very large configuration files.
Importing Many Devices
You can use the Web UI to add devices, but it is not designed for importing a large number of devices.
The easiest way to include many devices is by using the command line option -deviceImport.
1. Build a device table using this format:
$ cat table.txt
#
# model id hostport transports username password enable-password
#
cisco-ios lab1 router1905lab telnet san fran sanjose
cisco-ios lab2 router3925lab telnet san fran sanjose
junos auto ex4200lab ssh,telnet backup juniper1 not-used
junos auto 1.1.1.1:2222 ssh backup juniper1 not-used
$
Hint: The device id must be unique. You can generate a meaningful device id manually as you like. You can also let Jazigo create id's automatically by specifying the special id auto.
2. Then load the table with the option -deviceImport:
$ $GOPATH/bin/jazigo -deviceImport < table.txt
Using AWS S3
Quick recipe for using S3 bucket:
1. Create a bucket 'bucketname' on AWS region 'regionname'.
2. Authorize the client to access the bucket
An usual way is to create an IAM user, add key/secret, and put those credentials into ~/.aws/credentials:
$ cat ~/.aws/credentials
[default]
aws_access_key_id = key
aws_secret_access_key = secret
3. Run jazigo pointing its config and repository paths to S3 bucket ARN:
S3 bucket ARN: arn:aws:s3:regionname::bucketname/foldername
# Example
ARN=arn:aws:s3:regionname::bucketname/foldername
$GOPATH/bin/jazigo -configPathPrefix=$ARN/etc/jazigo.conf. -repositoryPath=$ARN/repo
Hint: You could point config and repository to distinct buckets.
Calling an external program
You can use the pseudo model run to call an external program to collect custom configuration.
Create a device using the model run, then specify the program arguments in the attribute runprog:
Example:
# This example calls: /bin/bash -c "env | egrep ^JAZIGO_"
runprog:
- /bin/bash
- -c
- env | egrep ^JAZIGO_
The external program invoked by the model run will receive its device authentication credentials as environment variables:
JAZIGO_DEV_ID=deviceid
JAZIGO_DEV_HOSTPORT=host[:port] -- port is optional
JAZIGO_DEV_USER=username
JAZIGO_DEV_PASS=password
The external program is expected to issue captured configuration to stdout and then to exit with zero exit status.