mirror of
https://gitverse.ru/kpa39l/netbox.git
synced 2026-09-29 09:55:11 +00:00
chore: upgrade all 14 plugins, fix config-diff key, pin netbox base image
- plugin_requirements.txt: pinned ==versions (10 plugins updated vs PyPI) - Dockerfile-Plugins: FROM netbox:latest -> netbox:v4.6-5.0.2 (reproducible) - configuration/plugins.py: fix netbox-config-diff -> netbox_config_diff key (required_settings USERNAME/PASSWORD) - docker-compose.yml: VERSION default v4.6-5.0.1 -> v4.6-5.0.2 - README-NETBOX-MCP.md: fix NetBox version 6.0.4 -> 4.6.10, mark plugins TODO done - NetBox 4.6.0 -> 4.6.10; all 14 plugins now load (config_diff, secrets, qrcode, floorplan revived) NOTE: docker-compose.override.yml (housekeeping DB env fix) is gitignored - kept local
This commit is contained in:
+32
-2
@@ -30,6 +30,7 @@ mcp_servers:
|
||||
## Доступ к NetBox
|
||||
|
||||
- NetBox работает в docker (контейнер `netbox-netbox-1`, порт `8080` на хосте).
|
||||
- Версия NetBox: **4.6.10** (Community, netbox-docker `v4.6-5.0.2`), образ `netbox-kupazh:latest` (кастомный, с плагинами), базовый `netboxcommunity/netbox:v4.6-5.0.2`.
|
||||
- Внутри docker-сети `netbox_default` контейнер доступен по имени `netbox-netbox-1` (IP 172.19.0.5).
|
||||
- С хоста прямой доступ к API по `127.0.0.1:8080` даёт 403 (ALLOWED_HOSTS/прокси), поэтому MCP-сервер ходит по docker-IP.
|
||||
- Аутентификация: **v1 API токен** (`Authorization: Token <40-символов>`), т.к. v2-токены в этой кастомной модели имеют ограничение key ≤12 символов и HMAC-дигест — с ними были проблемы в CLI-тестах.
|
||||
@@ -73,10 +74,39 @@ cd /opt/netbox-mcp-server && echo '{"jsonrpc":"2.0","id":1,"method":"initialize"
|
||||
## Замечания
|
||||
|
||||
- Плагины NetBox (netbox-dns и др.) не включены в discovery (`ENABLE_PLUGIN_DISCOVERY=false`) — при необходимости включить отдельно; их запись управляется `PLUGIN_WRITE_RULES`.
|
||||
- Многие плагины (netbox_secrets, netbox_qrcode, netbox_floorplan) не загружаются — требуют NetBox ≤4.5.99, а тут 6.0.4.
|
||||
- Многие плагины (netbox_secrets, netbox_qrcode, netbox_floorplan) не загружались — требовали NetBox ≤4.5.99; **после обновления плагинов (2026-09-03) все 14 загружаются** (см. историю изменений).
|
||||
|
||||
## История изменений
|
||||
|
||||
### 2026-09-03 — Обновление плагинов
|
||||
|
||||
Обновлены все 14 установленных плагинов до актуальных версий на PyPI (совместимых с NetBox 4.6), NetBox обновлён с 4.6.0 до 4.6.10 (базовый образ `netboxcommunity/netbox:latest` → зафиксирован `v4.6-5.0.2`).
|
||||
|
||||
| Плагин | Было | Стало |
|
||||
|---|---|---|
|
||||
| netbox-plugin-prometheus-sd | 1.3.0 | 2.0.0 (устранены N+1 запросы) |
|
||||
| netbox-lists | 4.0.4 | 4.0.4 (=) |
|
||||
| netbox-inventory | 2.6.0 | 2.6.1 |
|
||||
| netbox-interface-synchronization | 4.5.8 | 4.5.8 (=) |
|
||||
| netbox-documents | 0.8.2 | 0.8.5 |
|
||||
| netbox-contract | 2.4.5 | 2.4.7 |
|
||||
| netbox-data-flows | 1.5.2 | 1.5.4 |
|
||||
| netbox-config-diff | 2.14.2 | 2.15.2 |
|
||||
| netbox-attachments | 11.2.1 | 11.3.1 |
|
||||
| netbox-topology-views | 4.5.1 | 4.5.1 (=) |
|
||||
| netbox-reorder-rack | 1.1.4 | 1.1.4 (=) |
|
||||
| netbox-secrets | 3.0.2 | 3.1.1 |
|
||||
| netbox-qrcode | 0.0.20 | 0.0.21 |
|
||||
| netbox-floorplan-plugin | 0.9.1 | 0.9.2 |
|
||||
|
||||
Ключевые результаты:
|
||||
|
||||
1. **Исправлена скрытая поломка конфига config-diff**: ключ в `PLUGINS_CONFIG` был `"netbox-config-diff"` (с дефисом) вместо `"netbox_config_diff"` (с подчёркиванием). Новая версия 2.15.2 жёстко требует `USERNAME`/`PASSWORD` (required_settings) — из-за неправильного ключа сборка падала на collectstatic. Ключ исправлен, значения прописаны.
|
||||
2. **Ожили 4 плагина**: netbox_config_diff, netbox_secrets, netbox_qrcode, netbox_floorplan раньше не загружались (требовали NetBox ≤4.5.99). Обновлённые версии поддерживают 4.6 — теперь **все 14 плагинов активны** (миграции накатаны).
|
||||
3. **netbox-qrcode**: пропущен 1.0.0 (таргетит NetBox 4.7) — взят 0.0.21 (последний с поддержкой 4.6.x).
|
||||
4. **Исправлен housekeeping**: в `docker-compose.override.yml` у сервиса не было `DB_HOST`/`DB_NAME`/`DB_USER`/`DB_PASSWORD` — контейнер падал с «connection refused» к postgres. Добавлены переменные (как у netbox). Теперь housekeeping успешно выполняется.
|
||||
5. **plugin_requirements.txt** теперь с жёсткими пинами `==` (было без версий) — воспроизводимая сборка. Бэкап-тег образа: `netbox-kupazh:pre-upgrade-20260903`.
|
||||
|
||||
### 2026-09-03 — Развёртывание и отладка
|
||||
|
||||
Развёрнут MCP-сервер (read-only). Ключевые находки при отладке:
|
||||
@@ -90,6 +120,6 @@ cd /opt/netbox-mcp-server && echo '{"jsonrpc":"2.0","id":1,"method":"initialize"
|
||||
## TODO (ожидающие задачи)
|
||||
|
||||
- [ ] Включить write-режим: write-токен (`write_enabled=True`), ObjectPermission с actions `['view','add','change','delete']` на нужные типы, сменить `NETBOX_TOKEN` в конфиге Hermes, проверить на тестовых объектах (site/tag).
|
||||
- [ ] **Обновление плагинов**: проверить, какие версии установленных плагинов (см. `/opt/netbox/plugin_requirements.txt`) устарели относительно PyPI, чтобы решить, стоит ли пересобирать образ `netbox-kupazh:latest` (базовый `netboxcommunity/netbox:4.6-5.0.1`).
|
||||
- [x] **Обновление плагинов**: сверить версии с PyPI, пересобрать образ, проверить загрузку. Выполнено 2026-09-03: все 14 плагинов обновлены до свежих версий (совместимых с NetBox 4.6), NetBox 4.6.0 → 4.6.10. Детали в истории изменений.
|
||||
- [ ] (Опция) Включить plugin discovery (`ENABLE_PLUGIN_DISCOVERY=true`) и `PLUGIN_WRITE_RULES` для плагинов (netbox-dns и др.), после отладки core.
|
||||
- ~~(Отклонено) HTTP-транспорт для внешних клиентов~~ — не планируется, интеграция только через Hermes (stdio).
|
||||
Reference in New Issue
Block a user