Saltar a contenido

NetBox

NetBox es la fuente de verdad de inventario para redes e infraestructura de iort: sitios, regiones, clusters, máquinas virtuales, IPs, prefijos, tags y metadatos operativos.

Este directorio es el espacio propio del proyecto netbox/ dentro del workspace. Aquí vive la configuración operativa y de uso de NetBox como producto. No es el código de despliegue.

Qué vive aquí

  • .env: variables locales y operativas del proyecto NetBox.
  • .env.example: plantilla sin secretos.
  • Manual de uso: guía de uso en español para técnicos, desarrolladores e ingenieros robóticos.
  • Cómo documentar y mantener sistemas en NetBox: playbook operativo para crear y editar inventario, pensado también para LLMs.

Qué no vive aquí

  • el stack Pulumi de despliegue;
  • templates de systemd/nginx;
  • bootstrap del VPS;
  • documentación técnica del despliegue.

Eso vive en:

  • ../infra/netbox/README.md
  • ../docs/netbox/bootstrap.md
  • ../docs/netbox/deploy.md
  • ../docs/netbox/mcp-access.md
  • ../docs/netbox/information-model.md

Estado actual

El NetBox operativo de iort está desplegado en iort-netbox y publicado solo por Tailscale.

Puntos de acceso actuales:

  • UI/API privada: https://iort-netbox.tailf75db9.ts.net
  • MCP privado: https://iort-netbox.tailf75db9.ts.net/mcp
  • Chat privado con LibreChat: https://iort-netbox.tailf75db9.ts.net/chat

Convención

  • usa este directorio para lo específico de la operación y el consumo de NetBox;
  • usa ../infra/netbox/ para IaC y despliegue;
  • usa ../docs/netbox/ para runbooks y modelado.

Empieza por aquí

Si vas a usar NetBox como técnico, desarrollador o ingeniero robótico, empieza por:

Si vas a tocar despliegue, secretos o bootstrap, ve después a:

  • ../infra/netbox/README.md
  • ../docs/netbox/

Variables esperadas

El .env de este directorio está pensado para reunir:

  • URLs privadas de NetBox, MCP y chat;
  • nombres de site, región, cluster y VM de referencia;
  • prefijo de secretos en Google Secret Manager;
  • credenciales operativas de uso humano o de scripts locales.

No pongas aquí secretos globales de infraestructura ajenos a NetBox.