1. Plugin aus git.mrblake.cc installieren

Trage das Plugin dauerhaft in /opt/netbox/local_requirements.txt ein. Die empfohlene HTTPS-Archivvariante benötigt kein lokal installiertes Git. Für reproduzierbare Installationen solltest du main durch einen geprüften Commit-SHA ersetzen.

sudo sh -c 'line="netbox-plugin-store @ https://git.mrblake.cc/MrBlake/Netbox-Store/archive/main.tar.gz#subdirectory=netbox_plugin"; grep -Fqx "$line" /opt/netbox/local_requirements.txt || printf "%s\n" "$line" >> /opt/netbox/local_requirements.txt'
sudo /opt/netbox/upgrade.sh

Alternative mit Git

Wenn du stattdessen eine git+https-Requirement verwendest, muss das Programm git vor dem NetBox-Upgrade installiert sein:

sudo apt update
sudo apt install -y git

# Requirement:
netbox-plugin-store @ git+https://git.mrblake.cc/MrBlake/Netbox-Store.git@main#subdirectory=netbox_plugin

2. API-Token-Pepper konfigurieren

NetBox 4.6 warnt beim Start, wenn kein Pepper für v2-API-Tokens vorhanden ist. Erzeuge einmalig einen zufälligen Wert:

sudo /opt/netbox/venv/bin/python /opt/netbox/netbox/generate_secret_key.py

Übernimm die Ausgabe anschließend in /opt/netbox/netbox/netbox/configuration.py. Die Ganzzahl 1 ist die Pepper-ID:

API_TOKEN_PEPPERS = {
    1: "HIER_DEN_GENERIERTEN_WERT_EINTRAGEN",
}

3. Plugin in NetBox aktivieren

Ergänze die NetBox-Konfiguration:

PLUGINS = [
    "netbox_plugin_store",
]

PLUGINS_CONFIG = {
    "netbox_plugin_store": {
        "store_url": "https://netbox.mrblake.cc",
        "allowed_store_urls": ["https://netbox.mrblake.cc"],
        "allowed_artifact_urls": [
            "https://git.mrblake.cc",
            "https://github.com",
            "https://codeload.github.com",
        ],
        "execution_mode": "dry_run",
    }
}

Führe danach Migrationen und statische Dateien aus und starte NetBox neu:

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

4. Sicheren Host-Agent einrichten

dry_run verändert das System nicht. Für Installieren, Aktualisieren, Aktivieren und Entfernen wird der mitgelieferte Linux Host-Agent benötigt. Installiere ihn aus host_agent/, prüfe /etc/netbox-store-agent/agent.toml und stelle anschließend execution_mode auf agent.

Source-Kandidaten werden nur nach Admin-Freigabe verarbeitet. Der Agent prüft Commitbindung, Größe und SHA-256, baut daraus lokal ein Wheel und installiert nicht direkt aus einem beweglichen Branch.