¿Estás manteniendo tus diagramas de infraestructura?
“¿Dónde está la última versión del diagrama de arquitectura?”.
Cuando un nuevo miembro se une a tu equipo y hace esa pregunta, ¿cuántos sitios de desarrollo pueden presentar un archivo con confianza? En muchos proyectos, los diagramas de draw.io o PowerPoint creados durante la fase de diseño inicial se dejan abandonados y desactualizados.
La razón es simple: “Es una molestia arreglarlo”.
Volver a conectar líneas manualmente, ajustar diseños y exportar como una imagen en un navegador: el coste es simplemente demasiado alto en el desarrollo moderno, donde la infraestructura cambia con frecuencia.
Crear diagramas “como si escribieras código”
Si podemos gestionar los diagramas como recursos basados en texto, al igual que gestionamos el código con Git, la frescura de nuestra documentación mejorará drásticamente. Por eso deberíamos fijarnos en Mermaid.js.
Simplemente defines las conexiones en texto y el navegador representa automáticamente el diagrama con un diseño óptimo. No hay razón para no usar este sistema “mágico”.
graph TD
Internet["Internet"] --> LB["Load Balancer"]
LB --> WebServer["Web Server"]
WebServer --> DB[("Database")]Un “editor visual” para evitar pelear con las herramientas
Dicho esto, memorizar y escribir a mano toda la sintaxis de Mermaid también es una tarea ardua. Quieres concentrarte en “pensar en la configuración de la infraestructura”, no quedarte atascado en “errores de sintaxis de Mermaid”.
El Constructor de diagramas de infraestructura de DevToolKits fue diseñado para ofrecerte lo mejor de ambos mundos.
Construye de forma intuitiva, exporta de forma inteligente
- Colocar nodos: añade componentes como servidores o bases de datos desde la interfaz de usuario.
- Conectar líneas: simplemente elige qué nodo se comunica con cuál.
- Copiar Mermaid: el diagrama terminado se puede copiar directamente como código.
Pega el código Mermaid resultante en un README de GitHub o en Notion, y se convertirá en tu “diagrama siempre actualizado”. Cuando sea necesario un arreglo, simplemente cambia una línea de código. Esta agilidad es como debería ser la verdadera “documentación”.
Conclusión
Los diagramas de infraestructura no son una “obra de arte” que se termina una vez. Son “seres vivos” que siguen cambiando de forma a medida que tu sistema crece.
Gradúate del “trabajo de apuntar y hacer clic” y muévete de forma más ligera y precisa.
Visualiza tus diseños con el poder del texto y mantén actualizada constantemente la comprensión común de tu equipo.
💡 Un caso de uso práctico: cuando envíes una solicitud de extracción (Pull Request) en GitHub, intenta actualizar el código Mermaid junto con los cambios en tu infraestructura. De esta manera, los cambios de configuración se pueden revisar junto con el código, evitando que la documentación quede obsoleta.