Os presento inventariographdrawio
: De vuestro Azure a un Diagrama, Automáticamente
¡Hola a todos! Como muchos profesionales que trabajáis día a día con la nube, seguro que os habéis enfrentado al mismo reto que yo una y otra vez: mantener una documentación visual de la infraestructura que sea fiel a la realidad. Dibujar diagramas a mano es tedioso y, peor aún, quedan obsoletos casi al instante.
Cansado de esta tarea manual y de la eterna duda de si un diagrama reflejaba o no el estado real de los recursos, decidí que tenía que haber una forma mejor de hacerlo.
Por eso, hoy quiero presentaros con mucha ilusión un proyecto personal en el que he estado trabajando: inventariographdrawio.
¿Qué es inventariographdrawio
?
Es una herramienta de línea de comandos que he creado para solucionar este problema de raíz. Se conecta a una suscripción de Microsoft Azure, analiza los recursos que tienes desplegados y genera automáticamente un diagrama limpio y organizado en formato Draw.io (diagrams.net).
En pocas palabras, es mi solución para pasar de la infraestructura real en Azure a un diagrama editable, sin esfuerzo y en segundos.
¿Por qué lo creé? (Mis Objetivos Principales)
Cuando empecé a desarrollar esta herramienta, tenía varios objetivos en mente:
- Ahorrar tiempo: Mi primer objetivo era eliminar las horas que todos perdemos en tareas de documentación repetitivas. Quería que el análisis y el dibujo lo hiciera una máquina, para poder dedicar mi tiempo a lo que de verdad importa: diseñar y mejorar la arquitectura.
- Tener una fuente de la verdad: Necesitaba un diagrama en el que pudiera confiar. Con
inventariographdrawio
, el resultado es un reflejo exacto de lo que hay desplegado, perfecto para auditorías, revisiones o para explicarle la arquitectura a un nuevo compañero. - Mejorar la visibilidad: A veces, en el portal de Azure es difícil ver el "big picture". Representar los recursos de forma gráfica me ayuda a entender las dependencias y la estructura general de un solo vistazo.
- Enfocarme en Azure: Decidí centrarme exclusivamente en Azure para poder ofrecer un buen nivel de detalle y precisión en los recursos y servicios específicos de la plataforma, que es donde trabajo principalmente.
¿Cómo podéis empezar a usarlo?
He intentado que sea lo más sencillo posible. Solo tenéis que seguir estos pasos:
-
Clonar el repositorio:
-
Instalar las dependencias: La herramienta tiene unas pocas dependencias que podéis instalar fácilmente (revisad el fichero
README.md
para las instrucciones exactas). -
Configurar el acceso a Azure: Aseguraos de tener vuestra sesión de Azure activa (por ejemplo, con
az login
desde Azure CLI) para que la herramienta pueda autenticarse y leer los recursos. -
Ejecutar y ¡listo! Lanzad el script y veréis cómo aparece un nuevo fichero
.drawio
en la carpeta del proyecto, listo para abrir y editar.
Aquí un ejemplo navegable de un diagrama de Azure con iconos, creado con draw.io y exportado como un enlace para visualizarlo directamente en el navegador, es navegable:
Microsoft Entra Domain Services con Replica Set en una vpn Vnet2Vnet
El futuro
Este es solo el comienzo del proyecto. Mi idea es seguir ampliándolo para que sea compatible con más servicios de Azure y añadir nuevas funcionalidades que lo hagan aún más útil.
Al ser un proyecto de código abierto, cualquier ayuda es bienvenida. Si os animáis, podéis abrir issues con sugerencias o incluso enviar vuestros propios pull requests.
Espero de corazón que esta herramienta os resulte útil y os ahorre tanto tiempo como a mí.
¡Gracias por leer!