MrBlake
27cc25f648
- derive prefix from the first word of the site name - display prefix as the first data column - support NetBox 4.6.5 through 4.6.x - add packaging, installation documentation, and tests
49 lines
1.2 KiB
Markdown
49 lines
1.2 KiB
Markdown
# NetBox Site Prefix
|
|
|
|
Plugin für NetBox 4.6.5, das in den Geräte- und Rack-Listen eine Spalte
|
|
**Prefix** als erste Datenspalte anzeigt. Der Wert ist immer das erste Wort
|
|
des zugewiesenen Standortnamens (`Site.name`).
|
|
|
|
Beispiele:
|
|
|
|
| Standort | Prefix |
|
|
|---|---|
|
|
| `Berlin Campus West` | `Berlin` |
|
|
| `DC01 Frankfurt` | `DC01` |
|
|
| kein Standort | `—` |
|
|
|
|
Das Plugin benötigt keine Datenbankmigration und speichert keine eigenen
|
|
Daten.
|
|
|
|
## Installation
|
|
|
|
Im Python-Virtualenv von NetBox installieren:
|
|
|
|
```shell
|
|
/opt/netbox/venv/bin/pip install /pfad/zu/Netbox-Prefixes
|
|
```
|
|
|
|
Danach in `configuration.py` aktivieren:
|
|
|
|
```python
|
|
PLUGINS = [
|
|
# weitere Plugins ...
|
|
"netbox_site_prefix",
|
|
]
|
|
```
|
|
|
|
Anschließend NetBox neu starten. `upgrade.sh` ist nicht erforderlich, kann
|
|
aber wie bei anderen Plugin-Installationen ausgeführt werden.
|
|
|
|
Bei bestehenden Benutzern kann eine bereits gespeicherte persönliche
|
|
Spaltenauswahl Vorrang vor den Standardspalten haben. In diesem Fall in der
|
|
Geräte- bzw. Rack-Liste **Spalten konfigurieren** öffnen, **Prefix** auswählen
|
|
und an die erste Position schieben oder die gespeicherte Tabellenkonfiguration
|
|
zurücksetzen.
|
|
|
|
## Kompatibilität
|
|
|
|
- NetBox: 4.6.5 bis einschließlich 4.6.x
|
|
- Python: ab 3.12
|
|
|