| single |
# Netbox Configuration Backup
A configuration backup system using netbox and napalm to backup devices
into a git repository
# Features
* Connects to any device that supports napalm and provides both a running
configuration and startup configuration
* Stores backups in a git repository
* Runs as a scheduled task through Django RQ
* Only displays backups with changes
* Provides both configuration download and diffs for point-in-time backups
# Future
* Allow github repositories
* Add job "discovery" based on specific criteria (napalm enabled, device
role switch, has primary ip as an example)
* Add RQ job to ensure all backups are queued
* Allow manual queueing of job
* Add API endpoint to trigger backup
* Add signal(s) to trigger backup
# Installation
1. Install from PyPI (`pip install netbox-config-backup`)
2. Edit netbox configuration:
```pyython
PLUGINS = [
'netbox_config_backup',
# Other plugins here
]
PLUGINS_CONFIG = {
'netbox_config_backup': {
# Parent folder must exist and be writable by your RQ worker and
readable by the WSGI process
'repository': '/path/to/git/repository',
'committer': 'User ',
'author': 'User ',
# Freqency of backups in seconds, can be anywhere 0+ (Recommended
is 1800 (30 minutes) or 3600 (1 hr)
'frequency': 3600
}
}
```
3. Migrate: `python3 netbox/manage.py migrate`
4. Create your first device backup
### Cleanup Old Version
If you are coming from an older version, please remove the custom RQ worker
as it is no longer required
## Logging
To enable logging, add the following to your configuration.py under
LOGGING:
```python
'netbox_config_backup': {
'handlers': ['enter_your_handlers_here'],
'level': 'desired_log_level',
'propagate': True,
},
```
|