From aa65f0419aa7694abdacb7e28628656b5e4c89c7 Mon Sep 17 00:00:00 2001 From: Fernando Machado Date: Thu, 20 Jun 2024 12:54:49 -0300 Subject: [PATCH 1/2] Added deployment diagrams --- .../2_2_1_Diagramas_de_despliegue_UML.md | 107 +++++++++++++++++- diagrams/Deployment_Diagram_Example.drawio | 97 ++++++++++++++++ diagrams/Deployment_Diagram_Example.svg | 1 + 3 files changed, 203 insertions(+), 2 deletions(-) create mode 100644 diagrams/Deployment_Diagram_Example.drawio create mode 100644 diagrams/Deployment_Diagram_Example.svg diff --git a/2_Tecnicas_y_herramientas/2_2_1_Diagramas_de_despliegue_UML.md b/2_Tecnicas_y_herramientas/2_2_1_Diagramas_de_despliegue_UML.md index f59d42c..f45c3a7 100644 --- a/2_Tecnicas_y_herramientas/2_2_1_Diagramas_de_despliegue_UML.md +++ b/2_Tecnicas_y_herramientas/2_2_1_Diagramas_de_despliegue_UML.md @@ -4,5 +4,108 @@ ### 2.2.1 Diagramas de despliegue UML -TODO: Completa esta página de diagramas de despliegue en forma análoga a los -demás diagramas +Los diagramas de despliegue UML modelan la arquitectura física de un sistema. +Estos diagramas muestran las relaciones entre los componentes de software y +hardware del sistema, es decir, la disposición física de los nodos en un sistema +distribuido, los artefactos que se almacenan en cada nodo y los componentes y +otros elementos que implementan los artefactos, así como las rutas de +comunicación y las relaciones de implementación entre esos elementos. + +Este documento está basado en UML 2.5.1[^1]. + +Los diagramas de despliegue tienen estos elementos: + +* Nodos, que se representan con un rectángulo tridimensional con el estereotipo + `≪node≫`; ese rectángulo contiene el nombre del nodo, que describe la pieza de + hardware que representa. En lugar de estereotipo `≪node≫` es posible usar + estereotipos más específicos como `≪mainframe≫`, `≪pc≫`, `≪database server≫`, + etc.; además se puede usar un ícono para representar visualmente estos + estereotipos. + + Los nodos son elementos del modelo que representan los recursos + computacionales en los que se puede desplegar artefactos —la definición de + artefacto está más abajo—. Los nodos pueden contener otros nodos. Hay dos + tipos más específicos de nodo, los ambientes de ejecución y los dispositivos + —que están definidos también más abajo—. + +* Instancias de nodos, que representan una ocurrencia real de un nodo. Las + instancias de nodo se basan en nodos existentes. El nombre de la instancia va + delante del nombre del nodo separado por `:` y subrayado. + +* Ambientes de ejecución —*execution environment*—, que son un tipo más + específico de nodo, y que se representan como un nodo pero con el estereotipo + `≪executionEnvironment≫`; el nombre del nodo, que describe el ambiente de + ejecución que representa. + + Estos ambientes de ejecución modelan un ambiente de ejecución particular, como + un sistema operativo o un sistema de gestión de bases de datos. Los entornos + de ejecución se usan para describir el contexto en el que tiene lugar la + ejecución de un modelo. + + Los entornos de ejecución generalmente forman parte de otro nodo que modela el + hardware en el que se ejecuta ese entorno de ejecución. Por ejemplo, un + entorno de ejecución dentro de un servidor puede proporcionar los servicios a + nivel de sistema operativo necesarios para soportar una aplicación de base de + datos instalada en ese entorno. + +* Artefactos, que se representan con un rectángulo —no tridimensional— que tiene + el estereotipo `«artefacto»`, el icono del artefacto y el nombre del + artefacto. + + Un artefacto representa algún elemento de información que se utiliza o produce + mediante un proceso de desarrollo de software o mediante la operación de un + sistema. Ejemplos de artefactos incluyen archivos de modelos, archivos fuente, + scripts, archivos ejecutables, tablas de bases de datos, entregables de + desarrollo, documentos de procesamiento de textos y mensajes de correo. Los + artefactos se implementan en nodos y se admite la implementación de artefactos + en varios tipos de nodos. + +* Instancias de artefactos, que representan una ocurrencia real de un artefacto. + Las instancias de artefactos se basan en artefactos existentes. El nombre de + la instancia va delante del nombre del artefacto separado por `:` y subrayado. + +* Dispositivos, que son un tipo más específico de nodo, y que se representan + también como un nodo pero con el estereotipo `≪device≫`; el nombre del nodo + describe el dispositivo que representa. + +* Especificaciones de despliegue, que se representan con un rectángulo —no + tridimensional— con el estereotipo `≪deploymentSpec≫`. Modelan archivos de + configuración y sus atributos modelan los parámetros de configuración de los + componentes o artefactos desplegados en un nodo. + +* Rutas de comunicación, que son un tipo más específico de asociación entre + nodos en un diagrama de despliegue, que muestra cómo los nodos intercambian + mensajes y señales. Al igual que con las asociaciones, es posible definir la + cantidad de nodos que se pueden conectar en cada extremo. También es posible + utilizar etiquetas para identificar el tipo de protocolo o red que se utiliza + en la comunicación. + +* Relaciones de despliegue, que son un tipo más específico de dependencia con el + estereotipo `≪deploy≫`, y no suelen llevar un nombre. Modelan que un nodo + soporta el despliegue de un artefacto. + +* Asociaciones y generalizaciones, con la semántica habitual que tienen en los + [diagramas de clases](./2_3_1_Diagramas_de_clases_UML.md). + +La figura 1, a continuación, muestra un ejemplo de diagrama de despliegue. El +nodo `Servidor de aplicación` alberga una instancia de `WebSphere` en la que se +ejecuta la `Aplicación web` y la `API conexión DB`. El `Navegador web` en el +dispositivo `Computadora del usuario` se conecta a la `Aplicación web` mediante +una conexión HTTP sobre Internet. La `API conexión DB` se conecta mediante una +conexión nativa con el `Reporte de datos` en el `Servidor de base de datos`. La +`Aplicación web` se conecta con la `lógica de negocios` en `Servicios web` +mediante una conexión SOAP sobre HTTP. + +![Ejemplo de diagrama de despliegue](/diagrams/Deployment_Diagram_Example.svg) + +*Figura 1: ejemplo de diagrama de despliegue.* + +Puedes ver más información sobre diagramas de despliegue en las herramientas de +modelado [IBM Software +Architect](https://www.ibm.com/docs/en/rational-soft-arch/9.7.0?topic=diagrams-creating-deployment), +[Visual +Paradigm](https://www.visual-paradigm.com/learning/handbooks/software-design-handbook/deployment-diagram.jsp) +y [Lucidchart](https://www.lucidchart.com/pages/uml-deployment-diagram). + +[^1]: OMG. (2017). OMG® Unified Modeling Language®. Disponible + [aquí](https://www.omg.org/spec/UML/2.5.1/PDF). diff --git a/diagrams/Deployment_Diagram_Example.drawio b/diagrams/Deployment_Diagram_Example.drawio new file mode 100644 index 0000000..097175a --- /dev/null +++ b/diagrams/Deployment_Diagram_Example.drawio @@ -0,0 +1,97 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/diagrams/Deployment_Diagram_Example.svg b/diagrams/Deployment_Diagram_Example.svg new file mode 100644 index 0000000..1ad9952 --- /dev/null +++ b/diagrams/Deployment_Diagram_Example.svg @@ -0,0 +1 @@ +
≪device≫
Computadora del usuario
≪device≫...
Navegador web
Navegador web
≪node≫
Servidor web
≪node≫...
Lógica de negocios
Lógica de negocios
≪node≫
Servidor de aplicación
≪node≫...
WebSphere
WebSphere
Aplicación web
Aplicación web
API conexión DB
API conexión DB
≪node≫
Servidor de base de datos
≪node≫...
Reporte de datos
Reporte de datos
≪http over internet≫
≪http over internet≫
≪soap over http≫
≪soap over http≫
≪native connection≫
≪native connection≫Text is not SVG - cannot display \ No newline at end of file From 9643c2bd2c4b21b24f22c6db35922a0b79f218e7 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Fernando=20Machado=20P=C3=ADriz?= Date: Fri, 21 Jun 2024 14:12:23 -0300 Subject: [PATCH 2/2] Apply suggestions from code review Co-authored-by: Paolo Mazza <47277080+mazzapao@users.noreply.github.com> --- 2_Tecnicas_y_herramientas/2_2_1_Diagramas_de_despliegue_UML.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/2_Tecnicas_y_herramientas/2_2_1_Diagramas_de_despliegue_UML.md b/2_Tecnicas_y_herramientas/2_2_1_Diagramas_de_despliegue_UML.md index f45c3a7..4733a35 100644 --- a/2_Tecnicas_y_herramientas/2_2_1_Diagramas_de_despliegue_UML.md +++ b/2_Tecnicas_y_herramientas/2_2_1_Diagramas_de_despliegue_UML.md @@ -93,7 +93,7 @@ ejecuta la `Aplicación web` y la `API conexión DB`. El `Navegador web` en el dispositivo `Computadora del usuario` se conecta a la `Aplicación web` mediante una conexión HTTP sobre Internet. La `API conexión DB` se conecta mediante una conexión nativa con el `Reporte de datos` en el `Servidor de base de datos`. La -`Aplicación web` se conecta con la `lógica de negocios` en `Servicios web` +`Aplicación web` se conecta con la `lógica de negocios` en `Servidor web` mediante una conexión SOAP sobre HTTP. ![Ejemplo de diagrama de despliegue](/diagrams/Deployment_Diagram_Example.svg)