NetBox-Export ist ein Plugin für NetBox 4.6.x. Es exportiert einen abgegrenzten Mandanten- oder Standortbereich als portables ZIP-Archiv und importiert ihn in eine zweite NetBox-Instanz.

Unterstützte Startpunkte:

Mandantengruppe einschließlich Untergruppen und Mandanten
einzelner Mandant
Region einschließlich Unterregionen und Standorten
einzelner Standort
Lokation einschließlich Unterlokationen

Der Export folgt den Besitzbeziehungen zu DCIM-, IPAM-, Circuit-, Virtualisierungs-, VPN-, Wireless-, Kontakt-, Tag- und Bilddaten. Benötigte Stammdaten werden als Abhängigkeiten mitgenommen. Primärschlüssel der Quellinstanz werden nie direkt als Zielschlüssel verwendet.

Installation

Das Plugin muss auf beiden NetBox-Instanzen installiert sein.

cd /opt/netbox
source venv/bin/activate
pip install --upgrade --force-reinstall \
  "git+https://git.mrblake.cc/MrBlake/NetBox-Export.git@main"

# Prüfen, ob das Modul im NetBox-venv verfügbar ist
python -c "import netbox_export; print(netbox_export.__file__)"

In configuration.py ergänzen:

PLUGINS = [
    "netbox_export",
]

PLUGINS_CONFIG = {
    "netbox_export": {
        "max_objects": 50000,
        "max_archive_size_mb": 250,
        "query_batch_size": 500,
        # Auf beiden Instanzen identisch setzen, um Archive zu signieren.
        "archive_signing_key": "eine-lange-zufaellige-geheime-zeichenfolge",
    },
}

Anschließend:

cd /opt/netbox/netbox
python manage.py migrate netbox_export
python manage.py collectstatic --no-input
sudo systemctl restart netbox netbox-rq

Falls ModuleNotFoundError: No module named 'netbox_export' erscheint, wurde das Paket nicht in /opt/netbox/venv installiert. In diesem Fall den obigen Installationsblock erneut ausführen und darauf achten, dass /opt/netbox/venv/bin/python verwendet wird:

/opt/netbox/venv/bin/python -m pip install --upgrade --force-reinstall \
  "git+https://git.mrblake.cc/MrBlake/NetBox-Export.git@main"
/opt/netbox/venv/bin/python -c \
  "import netbox_export; print(netbox_export.__file__)"

Bei einer Docker-Installation wird das Paket in das eigene NetBox-Image aufgenommen; danach wird der Container mit dem aktivierten Plugin neu gebaut und die Migration ausgeführt.

Verwendung

Die Oberfläche liegt unter Plugins > NetBox-Export > Export / Import und ist aus Sicherheitsgründen nur für Superuser sichtbar.

Auf Instanz A den Typ und das konkrete Objekt wählen und das ZIP exportieren.
Auf Instanz B das ZIP zunächst mit Nur prüfen verarbeiten.
Nach erfolgreichem Prüflauf Nur prüfen deaktivieren, den schreibenden Import bestätigen und das Archiv erneut hochladen.

Der Import läuft atomar. Bei einem Fehler werden alle Datenbankänderungen zurückgerollt. Die Konfliktstrategie Aktualisieren nutzt zuerst die dauerhaft gespeicherte Zuordnung aus Quellinstanz, Modell und Quell-ID; bei einem ersten Import werden vorhandene Objekte über ihre eindeutigen Fachschlüssel erkannt.

Verhalten und Grenzen

Quelle und Ziel müssen NetBox 4.6.x und dieselben Plugins/Modelle verwenden.
Benutzerkonten und Berechtigungen werden nicht exportiert. Fehlende oder nicht eindeutige Referenzen auf Benutzer und Gruppen werden ausgelassen und nach dem Import als Warnung angezeigt. Benötigt ein neuer Datensatz zwingend eine solche Referenz, wird nur dieser Datensatz übersprungen.
Der Import erstellt und aktualisiert Objekte. Zielobjekte, die im Archiv nicht vorkommen, werden bewusst nicht gelöscht.
Fehlende Bilddateien werden im Archiv vermerkt, können aber nicht rekonstruiert werden.
Große Exporte werden synchron verarbeitet. max_objects begrenzt Laufzeit und Speicherverbrauch.
query_batch_size steuert die Größe gebündelter Datenbankabfragen. Der Standardwert 500 ist für typische PostgreSQL-Installationen geeignet; Werte zwischen 250 und 1000 erlauben eine Anpassung an Arbeitsspeicher und Datenbankleistung.

Plugin-Kompatibilität

Der Exportgraph berücksichtigt installierte, mandantenbezogene Modelle und Dateien aus NetBox-SLM, Netbox-DokiWiki und NetBox-VM-Import. Private oder temporäre Plugin-Modelle werden nicht exportiert. Die von Netbox-Utilities erzwungene Mandantenpflicht wird beim Import berücksichtigt: Das Zielobjekt wird erst gespeichert, nachdem sein Mandant importiert und zugeordnet wurde. Ist kein Mandant auflösbar, wird automatisch ein vorhandener Mandant Auto-Import verwendet oder neu angelegt. Der Importbericht weist darauf hin.

Auf Quelle und Ziel müssen jeweils dieselben Plugin-Versionen und Migrationen installiert sein. Verschlüsselte Zugangsdaten von NetBox-VM-Import sind nur bei identischem Django-SECRET_KEY direkt nutzbar; andernfalls muss das Kennwort am Ziel neu gesetzt werden.

Tests

python -m pytest