프로젝트 소개

netbox-pdm은 Proxmox Datacenter Manager(PDM) 인벤토리를 NetBox로 가져오는 NetBox 플러그인입니다. 이 플러그인은 netbox-proxbox의 형제 프로젝트이며, FastAPI 엔드포인트와 작업을 처리하기 위해 proxbox-api 백엔드를 사용합니다. netbox-proxbox가 설치된 경우 해당 플러그인의 엔드포인트 해석 및 작업 컨벤션을 재사용하며, 그렇지 않은 경우 자체 proxbox_api_url 및 proxbox_api_key 설정을 사용합니다. netbox-proxbox는 Python wheel 의존성은 아니지만 PLUGINS 설정에서 필수 피어 플러그인으로 유지되어야 하므로, Proxbox 스택은 proxmox-sdk와 Pydantic 라인을 공유할 수 있습니다. v0.0.2 릴리스는 PDM 엔드포인트 및 원격 인벤토리 뷰, 동기화 작업 연결, 그리고 proxmox-sdk 기반의 PDM 클라이언트 경로를 제공합니다. 동기화는 NetBox 인벤토리 행만 조정하며, 플러그인이 PDM으로 설정을 다시 쓰지는 않습니다. PDMRemote 행을 생성, 업데이트 및 정리하므로 PDM에서 제거된 원격지가 NetBox 인벤토리에 오래된 데이터로 남지 않습니다. 엔드포인트 동기화에는 엔드포인트 가시성과 core.add_job 권한이 필요합니다. PDM 토큰 비밀값은 엔드포인트 수정 폼에 다시 표시되지 않으며, 해당 필드를 비워두면 저장된 비밀값이 유지됩니다. 설치는 pip install netbox-proxbox netbox-pdm을 사용하고, 두 플러그인을 PLUGINS에 추가한 후 python manage.py migrate를 실행합니다. 문서는 GitHub Pages에 게시되며, 버그 및 기능 요청은 GitHub Issues를 통해 추적됩니다. 이 프로젝트는 Apache-2.0 라이선스를 따르며 PyPI 메타데이터, 호환성 메타데이터, GitHub Actions CI, 릴리스 검증, 문서 게시, 스크린샷 캡처 및 NetBox v4.6.4를 위한 페이지 커버리지 워크플로우를 포함합니다. Digest-pinned Docker 설치 스모크 테스트는 NetBox v4.7.0 GA를 지원하며, 정확한 소스 통합 테스트는 v4.5.8부터 v4.6.6까지 지원합니다. 4.7.1 및 이후 버전은 fail closed 처리됩니다. 버전 티어 및 Proxbox 제품군 업그레이드 절차는 COMPATIBILITY.md를 참조하십시오.