Diagramas de despliegue UML

Un diagrama de despliegue asigna software a hardware. Es el único diagrama UML sobre el mundo físico - máquinas, contenedores, enlaces de red - y responde una pregunta que ningún otro responde: si esta caja se quema, ¿qué deja de funcionar?

Es además el diagrama que con más probabilidad pedirá alguien que no programa. Las revisiones de seguridad, los planes de recuperación ante desastres, las preguntas sobre dónde residen los datos y las conversaciones de coste empiezan todas por «dónde corre esto exactamente y qué habla con qué».

Los diagramas de despliegue se pudren más rápido que ningún otro tipo, porque la infraestructura cambia cada semana y los diagramas no. La forma de mantener uno útil es dibujarlo a la altura que cambia despacio.

Dibuje topología, no inventario.«Clúster de Kubernetes» seguirá siendo cierto durante años. «Tres instancias m5.large en eu-central-1b» será falso el trimestre que viene y pertenece al repositorio de infraestructura como código, el único sitio donde puede estar bien.

Etiquete los enlaces. Una línea que no dice nada casi no vale nada; una línea que dice TCP 5432, HTTPS o AMQP over TLS es la razón por la que un revisor de seguridad lee el diagrama. Lo mismo con las fronteras de confianza: si un enlace sale de su red hacia la de otro, dígalo.

Dibuje la multiplicidad donde importa. Un nodo puede llevar multiplicidad igual que una clase. Poner 1..* en el nodo de aplicación y 1 en la base de datos dice algo real sobre los modos de fallo del sistema.

1. Caminos de comunicación sin etiquetar.El protocolo y el puerto son el contenido. Sin ellos una línea solo dice «estos están conectados».
2. Componentes dibujados donde van los artefactos. Los nodos alojan archivos. Ponga checkout.jar en el nodo y deje Checkout para el diagrama de componentes.
3. Detalle de instancias que no puede seguir siendo cierto. Los nombres de host y los tamaños de instancia van en el código, no en un diagrama.
4. Sin fronteras de confianza. Si algunos nodos son suyos y otros de un tercero, esa distinción suele ser lo más importante de la página.
5. Un diagrama por entorno. Dibuje producción. Anote las diferencias en el texto; no dibuje cuatro diagramas casi idénticos que acabarán divergiendo.