# Buildsheet autogenerated by ravenadm tool -- Do not edit.

NAMEBASE=		python-netbox-config-backup
VERSION=		2.1.8
KEYWORDS=		python
VARIANTS=		v12 v13
SDESC[v12]=		NetBox Switch Configuration Backup Plugin (3.12)
SDESC[v13]=		NetBox Switch Configuration Backup Plugin (3.13)
HOMEPAGE=		https://github.com/dansheps/netbox-config-backup
CONTACT=		Python_Automaton[python@ironwolf.systems]

DOWNLOAD_GROUPS=	main
SITES[main]=		PYPIWHL/eb/06/f9a536b73798243a3fb6796755f7733555f8553fb6777847e4f3d2d13738
DISTFILE[1]=		netbox_config_backup-2.1.8-py3-none-any.whl:main
DIST_SUBDIR=		python-src
DF_INDEX=		1
SPKGS[v12]=		single
SPKGS[v13]=		single

OPTIONS_AVAILABLE=	PY312 PY313
OPTIONS_STANDARD=	none
VOPTS[v12]=		PY312=ON PY313=OFF
VOPTS[v13]=		PY312=OFF PY313=ON

DISTNAME=		netbox_config_backup-2.1.8.dist-info

GENERATED=		yes

[PY312].RUN_DEPENDS_ON=			python-netbox-napalm-plugin:single:v12
					python-netmiko:single:v12
					python-napalm:single:v12
					python-uuid:single:v12
					python-dulwich:single:v12
					python-PyDriller:single:v12
					python-deepdiff:single:v12
[PY312].USES_ON=			python:v12,wheel

[PY313].RUN_DEPENDS_ON=			python-netbox-napalm-plugin:single:v13
					python-netmiko:single:v13
					python-napalm:single:v13
					python-uuid:single:v13
					python-dulwich:single:v13
					python-PyDriller:single:v13
					python-deepdiff:single:v13
[PY313].USES_ON=			python:v13,wheel

[FILE:1841:descriptions/desc.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 <email>',
        'author': 'User <email>',
        # 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,
        },
```


[FILE:133:distinfo]
e0aababeac265625f9e6feb8f905eb6067640357656a51cfb5da029859caa90c        59684 python-src/netbox_config_backup-2.1.8-py3-none-any.whl