technofy/netbox

自定义Netbox镜像文档

镜像概述

本镜像基于官方Netbox（https://github.com/digitalocean/netbox%EF%BC%89%E6%9E%84%E5%BB%BA%EF%BC%8C%E6%96%B0%E5%A2%9E%E7%AB%AF%E5%8F%A3%E6%A8%A1%E6%9D%BF%E5%8A%9F%E8%83%BD%E4%BB%A5%E5%A2%9E%E5%BC%BA%E7%BD%91%E7%BB%9C%E7%AE%A1%E7%90%86%E8%83%BD%E5%8A%9B%E3%80%82%E4%B8%BB%E8%A6%81%E7%94%A8%E4%BA%8E%E5%9C%A8minikube Kubernetes环境中部署Netbox，提供完整的网络管理解决方案。由于官方社区未提供minikube部署的完整清单，本镜像配套生成了ConfigMap和kub8 stack自定义部署资源，并需配合nginx和postgres镜像使用。

核心功能与特性

• 端口模板功能：扩展Netbox原生功能，支持端口模板配置，简化网络设备端口管理流程
• minikube适配：提供自定义部署清单（ConfigMap、kub8 stack），解决官方部署资源缺失问题
• 组件兼容性：需搭配nginx（反向代理）和postgres（数据库）镜像使用，构建完整服务架构
• 测试验证：所有部署流程均在minikube环境中测试通过，部署方案参考GitHub仓库（https://github.com/mariopoeta/netbox-kubernetes%EF%BC%89

使用场景

适用于需要在minikube Kubernetes环境中部署Netbox的网络管理场景，特别适合需要通过端口模板功能简化网络设备端口配置与管理的用户。

使用方法与配置说明

部署要求

• 已部署minikube
• 已安装docker-compose

部署步骤

1. 准备自定义部署清单
   根据官方文档（https://github.com/netbox-community/netbox-docker%EF%BC%89%E7%94%9F%E6%88%90%E5%8C%85%E5%90%AB%E7%AB%AF%E5%8F%A3%E6%A8%A1%E6%9D%BF%E5%8A%9F%E8%83%BD%E7%9A%84ConfigMap%E5%92%8Ckub8 stack部署清单。

2. 部署依赖组件
   部署nginx和postgres镜像，配置数据库连接参数及反向代理规则。

3. 应用部署清单
   使用kubectl命令应用自定义部署清单，完成Netbox在minikube上的部署：

   bash
   kubectl apply -f custom-netbox-manifests/
   

配置说明

• 依赖镜像：必须同时部署nginx和postgres镜像，确保网络服务与数据存储正常运行
• ConfigMap配置：需在ConfigMap中设置数据库连接信息（如POSTGRES_HOST、POSTGRES_USER、POSTGRES_PASSWORD）、端口模板参数等关键配置
• 端口映射：通过kub8 stack清单配置容器端口与minikube节点端口的映射关系，确保外部可访问Netbox服务