Sobre o projeto

O netbox-pdm é um plugin do NetBox que traz o inventário do Proxmox Datacenter Manager (PDM) para o NetBox. É um complemento do netbox-proxbox e utiliza o backend proxbox-api para resolver endpoints e jobs do FastAPI. Quando o netbox-proxbox está instalado, ele reutiliza a resolução de endpoints e as convenções de jobs desse plugin; caso contrário, recorre às suas próprias configurações de proxbox_api_url e proxbox_api_key. O netbox-proxbox continua sendo um plugin complementar obrigatório em PLUGINS, embora não seja uma dependência de wheel do Python, permitindo que a stack Proxbox compartilhe uma linha Pydantic com o proxmox-sdk. A versão v0.0.2 fornece visualizações de endpoints PDM e inventário remoto, conexão de jobs de sincronização e um caminho de cliente PDM baseado em proxmox-sdk. A sincronização reconcilia apenas as linhas de inventário do NetBox; o plugin nunca escreve configurações de volta no PDM. Ele cria, atualiza e remove linhas PDMRemote, garantindo que remotos removidos do PDM não permaneçam como inventário obsoleto no NetBox. A sincronização de endpoints requer visibilidade do endpoint e a permissão core.add_job. Os segredos de token PDM não são renderizados de volta nos formulários de edição de endpoint; deixar o campo em branco preserva o segredo armazenado. A instalação utiliza pip install netbox-proxbox netbox-pdm, adiciona ambos os plugins ao PLUGINS e executa python manage.py migrate. A documentação é publicada no GitHub Pages, e bugs e solicitações de recursos são rastreados via GitHub Issues. O projeto possui licença Apache-2.0 e inclui metadados do PyPI, metadados de compatibilidade, CI do GitHub Actions, validação de release, publicação de docs, captura de screenshots e workflows de cobertura de página para o NetBox v4.6.4. O teste de fumaça de instalação Docker com digest fixo cobre o NetBox v4.7.0 GA, e testes de integração de fonte exata cobrem da v4.5.8 até a v4.6.6; a v4.7.1 e posteriores falham por padrão. Consulte COMPATIBILITY.md para níveis de versão e o procedimento de atualização da família Proxbox.