Structurizr

Upload

workspace { model { u = person "User" s = softwareSystem "Software System" { webapp = container "Web Application" "" "Spring Boot" database = container "Database" "" "Relational database schema" } u -> webapp "Uses" webapp -> database "Reads from and writes to" live = deploymentEnvironment "Live" { deploymentNode "Amazon Web Services" { deploymentNode "US-East-1" { route53 = infrastructureNode "Route 53" elb = infrastructureNode "Elastic Load Balancer" deploymentNode "Amazon EC2" { deploymentNode "Ubuntu Server" { webApplicationInstance = containerInstance webapp } } deploymentNode "Amazon RDS" { deploymentNode "MySQL" { containerInstance database } } } } route53 -> elb "Forwards requests to" "HTTPS" elb -> webApplicationInstance "Forwards requests to" "HTTPS" } } views { deployment s live { include * autoLayout lr } } }

Structurizr DSL v3.0.0 - some features (e.g. !docs, !adrs, !script, etc) are unavailable via this demo page; see DSL for details.

Examples: Big Bank plc | Microservices | Amazon Web Services

Structurizr

Diagram

Structurizr

Graph

Export

PlantUML

Export

C4-PlantUML

Export

Mermaid

Export

DOT

Export

WebSequenceDiagrams

Export

Ilograph

PlantUML definitions are available via the Structurizr CLI export command, using the -format plantuml parameter. See StructurizrPlantUMLExporter for customisation options.

@startuml
set separator none
title Software System - Deployment - Live

left to right direction

skinparam {
  arrowFontSize 10
  defaultTextAlignment center
  wrapWidth 200
  maxMessageSize 100
}

hide stereotype

skinparam rectangle<<Live.AmazonWebServices.USEast1.AmazonEC2>> {
  BackgroundColor #ffffff
  FontColor #000000
  BorderColor #888888
  shadowing false
}
skinparam rectangle<<Live.AmazonWebServices.USEast1.AmazonRDS>> {
  BackgroundColor #ffffff
  FontColor #000000
  BorderColor #888888
  shadowing false
}
skinparam rectangle<<Live.AmazonWebServices>> {
  BackgroundColor #ffffff
  FontColor #000000
  BorderColor #888888
  shadowing false
}
skinparam rectangle<<Live.AmazonWebServices.USEast1.AmazonRDS.MySQL.Database_1>> {
  BackgroundColor #dddddd
  FontColor #000000
  BorderColor #9a9a9a
  shadowing false
}
skinparam rectangle<<Live.AmazonWebServices.USEast1.ElasticLoadBalancer>> {
  BackgroundColor #dddddd
  FontColor #000000
  BorderColor #9a9a9a
  shadowing false
}
skinparam rectangle<<Live.AmazonWebServices.USEast1.AmazonRDS.MySQL>> {
  BackgroundColor #ffffff
  FontColor #000000
  BorderColor #888888
  shadowing false
}
skinparam rectangle<<Live.AmazonWebServices.USEast1.Route53>> {
  BackgroundColor #dddddd
  FontColor #000000
  BorderColor #9a9a9a
  shadowing false
}
skinparam rectangle<<Live.AmazonWebServices.USEast1>> {
  BackgroundColor #ffffff
  FontColor #000000
  BorderColor #888888
  shadowing false
}
skinparam rectangle<<Live.AmazonWebServices.USEast1.AmazonEC2.UbuntuServer>> {
  BackgroundColor #ffffff
  FontColor #000000
  BorderColor #888888
  shadowing false
}
skinparam rectangle<<Live.AmazonWebServices.USEast1.AmazonEC2.UbuntuServer.WebApplication_1>> {
  BackgroundColor #dddddd
  FontColor #000000
  BorderColor #9a9a9a
  shadowing false
}

rectangle "Amazon Web Services\n<size:10>[Deployment Node]</size>" <<Live.AmazonWebServices>> as Live.AmazonWebServices {
  rectangle "US-East-1\n<size:10>[Deployment Node]</size>" <<Live.AmazonWebServices.USEast1>> as Live.AmazonWebServices.USEast1 {
    rectangle "==Route 53\n<size:10>[Infrastructure Node]</size>" <<Live.AmazonWebServices.USEast1.Route53>> as Live.AmazonWebServices.USEast1.Route53
    rectangle "==Elastic Load Balancer\n<size:10>[Infrastructure Node]</size>" <<Live.AmazonWebServices.USEast1.ElasticLoadBalancer>> as Live.AmazonWebServices.USEast1.ElasticLoadBalancer
    rectangle "Amazon EC2\n<size:10>[Deployment Node]</size>" <<Live.AmazonWebServices.USEast1.AmazonEC2>> as Live.AmazonWebServices.USEast1.AmazonEC2 {
      rectangle "Ubuntu Server\n<size:10>[Deployment Node]</size>" <<Live.AmazonWebServices.USEast1.AmazonEC2.UbuntuServer>> as Live.AmazonWebServices.USEast1.AmazonEC2.UbuntuServer {
        rectangle "==Web Application\n<size:10>[Container: Spring Boot]</size>" <<Live.AmazonWebServices.USEast1.AmazonEC2.UbuntuServer.WebApplication_1>> as Live.AmazonWebServices.USEast1.AmazonEC2.UbuntuServer.WebApplication_1
      }

    }

    rectangle "Amazon RDS\n<size:10>[Deployment Node]</size>" <<Live.AmazonWebServices.USEast1.AmazonRDS>> as Live.AmazonWebServices.USEast1.AmazonRDS {
      rectangle "MySQL\n<size:10>[Deployment Node]</size>" <<Live.AmazonWebServices.USEast1.AmazonRDS.MySQL>> as Live.AmazonWebServices.USEast1.AmazonRDS.MySQL {
        rectangle "==Database\n<size:10>[Container: Relational database schema]</size>" <<Live.AmazonWebServices.USEast1.AmazonRDS.MySQL.Database_1>> as Live.AmazonWebServices.USEast1.AmazonRDS.MySQL.Database_1
      }

    }

  }

}

Live.AmazonWebServices.USEast1.AmazonEC2.UbuntuServer.WebApplication_1 .[#707070,thickness=2].> Live.AmazonWebServices.USEast1.AmazonRDS.MySQL.Database_1 : "<color:#707070>Reads from and writes to"
Live.AmazonWebServices.USEast1.Route53 .[#707070,thickness=2].> Live.AmazonWebServices.USEast1.ElasticLoadBalancer : "<color:#707070>Forwards requests to\n<color:#707070><size:8>[HTTPS]</size>"
Live.AmazonWebServices.USEast1.ElasticLoadBalancer .[#707070,thickness=2].> Live.AmazonWebServices.USEast1.AmazonEC2.UbuntuServer.WebApplication_1 : "<color:#707070>Forwards requests to\n<color:#707070><size:8>[HTTPS]</size>"
@enduml

(this will send your diagram content to https://plantuml.com/plantuml)

C4-PlantUML definitions are available via the Structurizr CLI export command, using the -format plantuml/c4plantuml parameter. See C4PlantUMLExporter for customisation options.

@startuml
set separator none
title Software System - Deployment - Live

left to right direction

!include <C4/C4>
!include <C4/C4_Context>
!include <C4/C4_Container>
!include <C4/C4_Deployment>

Deployment_Node(Live.AmazonWebServices, "Amazon Web Services", $type="", $descr="", $tags="", $link="") {
  Deployment_Node(Live.AmazonWebServices.USEast1, "US-East-1", $type="", $descr="", $tags="", $link="") {
    Deployment_Node(Live.AmazonWebServices.USEast1.Route53, "Route 53", $type="", $descr="", $tags="", $link="")
    Deployment_Node(Live.AmazonWebServices.USEast1.ElasticLoadBalancer, "Elastic Load Balancer", $type="", $descr="", $tags="", $link="")
    Deployment_Node(Live.AmazonWebServices.USEast1.AmazonEC2, "Amazon EC2", $type="", $descr="", $tags="", $link="") {
      Deployment_Node(Live.AmazonWebServices.USEast1.AmazonEC2.UbuntuServer, "Ubuntu Server", $type="", $descr="", $tags="", $link="") {
        Container(Live.AmazonWebServices.USEast1.AmazonEC2.UbuntuServer.WebApplication_1, "Web Application", $techn="Spring Boot", $descr="", $tags="", $link="")
      }

    }

    Deployment_Node(Live.AmazonWebServices.USEast1.AmazonRDS, "Amazon RDS", $type="", $descr="", $tags="", $link="") {
      Deployment_Node(Live.AmazonWebServices.USEast1.AmazonRDS.MySQL, "MySQL", $type="", $descr="", $tags="", $link="") {
        Container(Live.AmazonWebServices.USEast1.AmazonRDS.MySQL.Database_1, "Database", $techn="Relational database schema", $descr="", $tags="", $link="")
      }

    }

  }

}

Rel(Live.AmazonWebServices.USEast1.AmazonEC2.UbuntuServer.WebApplication_1, Live.AmazonWebServices.USEast1.AmazonRDS.MySQL.Database_1, "Reads from and writes to", $techn="", $tags="", $link="")
Rel(Live.AmazonWebServices.USEast1.Route53, Live.AmazonWebServices.USEast1.ElasticLoadBalancer, "Forwards requests to", $techn="HTTPS", $tags="", $link="")
Rel(Live.AmazonWebServices.USEast1.ElasticLoadBalancer, Live.AmazonWebServices.USEast1.AmazonEC2.UbuntuServer.WebApplication_1, "Forwards requests to", $techn="HTTPS", $tags="", $link="")

SHOW_LEGEND(true)
@enduml

(this will send your diagram content to https://plantuml.com/plantuml)

Mermaid definitions are available via the Structurizr CLI export command, using the -format mermaid parameter. Your Mermaid configuration will need to include "securityLevel": "loose" to render this definition correctly.

graph LR
  linkStyle default fill:#ffffff

  subgraph diagram ["Software System - Deployment - Live"]
    style diagram fill:#ffffff,stroke:#ffffff

    subgraph 8 ["Amazon Web Services"]
      style 8 fill:#ffffff,stroke:#888888,color:#000000

      subgraph 9 ["US-East-1"]
        style 9 fill:#ffffff,stroke:#888888,color:#000000

        10["<div style='font-weight: bold'>Route 53</div><div style='font-size: 70%; margin-top: 0px'>[Infrastructure Node]</div>"]
        style 10 fill:#dddddd,stroke:#9a9a9a,color:#000000
        11["<div style='font-weight: bold'>Elastic Load Balancer</div><div style='font-size: 70%; margin-top: 0px'>[Infrastructure Node]</div>"]
        style 11 fill:#dddddd,stroke:#9a9a9a,color:#000000
        subgraph 12 ["Amazon EC2"]
          style 12 fill:#ffffff,stroke:#888888,color:#000000

          subgraph 13 ["Ubuntu Server"]
            style 13 fill:#ffffff,stroke:#888888,color:#000000

            14["<div style='font-weight: bold'>Web Application</div><div style='font-size: 70%; margin-top: 0px'>[Container: Spring Boot]</div>"]
            style 14 fill:#dddddd,stroke:#9a9a9a,color:#000000
          end

        end

        subgraph 15 ["Amazon RDS"]
          style 15 fill:#ffffff,stroke:#888888,color:#000000

          subgraph 16 ["MySQL"]
            style 16 fill:#ffffff,stroke:#888888,color:#000000

            17["<div style='font-weight: bold'>Database</div><div style='font-size: 70%; margin-top: 0px'>[Container: Relational database schema]</div>"]
            style 17 fill:#dddddd,stroke:#9a9a9a,color:#000000
          end

        end

      end

    end

    14-. "<div>Reads from and writes to</div><div style='font-size: 70%'></div>" .->17
    10-. "<div>Forwards requests to</div><div style='font-size: 70%'>[HTTPS]</div>" .->11
    11-. "<div>Forwards requests to</div><div style='font-size: 70%'>[HTTPS]</div>" .->14
  end

(this will send your diagram content to https://mermaid.ink)

DOT definitions are available via the Structurizr CLI export command, using the -format dot parameter.

digraph {
  compound=true
  graph [fontname="Arial", rankdir=LR, ranksep=1.0, nodesep=1.0]
  node [fontname="Arial", shape=box, margin="0.4,0.3"]
  edge [fontname="Arial"]
  label=<<br /><font point-size="34">Software System - Deployment - Live</font>>

  subgraph cluster_8 {
    margin=25
    label=<<font point-size="24">Amazon Web Services</font><br /><font point-size="19">[Deployment Node]</font>>
    labelloc=b
    color="#888888"
    fontcolor="#000000"
    fillcolor="#ffffff"

    subgraph cluster_9 {
      margin=25
      label=<<font point-size="24">US-East-1</font><br /><font point-size="19">[Deployment Node]</font>>
      labelloc=b
      color="#888888"
      fontcolor="#000000"
      fillcolor="#ffffff"

      10 [id=10,shape=rect, label=<<font point-size="34">Route 53</font><br /><font point-size="19">[Infrastructure Node]</font>>, style=filled, color="#9a9a9a", fillcolor="#dddddd", fontcolor="#000000"]
      11 [id=11,shape=rect, label=<<font point-size="34">Elastic Load Balancer</font><br /><font point-size="19">[Infrastructure Node]</font>>, style=filled, color="#9a9a9a", fillcolor="#dddddd", fontcolor="#000000"]
      subgraph cluster_12 {
        margin=25
        label=<<font point-size="24">Amazon EC2</font><br /><font point-size="19">[Deployment Node]</font>>
        labelloc=b
        color="#888888"
        fontcolor="#000000"
        fillcolor="#ffffff"

        subgraph cluster_13 {
          margin=25
          label=<<font point-size="24">Ubuntu Server</font><br /><font point-size="19">[Deployment Node]</font>>
          labelloc=b
          color="#888888"
          fontcolor="#000000"
          fillcolor="#ffffff"

          14 [id=14,shape=rect, label=<<font point-size="34">Web Application</font><br /><font point-size="19">[Container: Spring Boot]</font>>, style=filled, color="#9a9a9a", fillcolor="#dddddd", fontcolor="#000000"]
        }

      }

      subgraph cluster_15 {
        margin=25
        label=<<font point-size="24">Amazon RDS</font><br /><font point-size="19">[Deployment Node]</font>>
        labelloc=b
        color="#888888"
        fontcolor="#000000"
        fillcolor="#ffffff"

        subgraph cluster_16 {
          margin=25
          label=<<font point-size="24">MySQL</font><br /><font point-size="19">[Deployment Node]</font>>
          labelloc=b
          color="#888888"
          fontcolor="#000000"
          fillcolor="#ffffff"

          17 [id=17,shape=rect, label=<<font point-size="34">Database</font><br /><font point-size="19">[Container: Relational database schema]</font>>, style=filled, color="#9a9a9a", fillcolor="#dddddd", fontcolor="#000000"]
        }

      }

    }

  }

  14 -> 17 [id=18, label=<<font point-size="24">Reads from and writes to</font>>, style="dashed", color="#707070", fontcolor="#707070"]
  10 -> 11 [id=19, label=<<font point-size="24">Forwards requests to</font><br /><font point-size="19">[HTTPS]</font>>, style="dashed", color="#707070", fontcolor="#707070"]
  11 -> 14 [id=20, label=<<font point-size="24">Forwards requests to</font><br /><font point-size="19">[HTTPS]</font>>, style="dashed", color="#707070", fontcolor="#707070"]
}

Ilograph definitions are available via the Structurizr CLI export command, using the -format ilograph parameter. A single Ilograph export contains the model and all views.

resources:
  - id: "1"
    name: "User"
    subtitle: "[Person]"
    backgroundColor: "#dddddd"
    color: "#000000"

  - id: "2"
    name: "Software System"
    subtitle: "[Software System]"
    backgroundColor: "#dddddd"
    color: "#000000"

    children:
      - id: "3"
        name: "Web Application"
        subtitle: "[Container: Spring Boot]"
        backgroundColor: "#dddddd"
        color: "#000000"

      - id: "4"
        name: "Database"
        subtitle: "[Container: Relational database schema]"
        backgroundColor: "#dddddd"
        color: "#000000"

  - id: "8"
    name: "Amazon Web Services"
    subtitle: "[Deployment Node]"
    backgroundColor: "#ffffff"
    color: "#000000"

    children:
      - id: "9"
        name: "US-East-1"
        subtitle: "[Deployment Node]"
        backgroundColor: "#ffffff"
        color: "#000000"

        children:
          - id: "12"
            name: "Amazon EC2"
            subtitle: "[Deployment Node]"
            backgroundColor: "#ffffff"
            color: "#000000"

            children:
              - id: "13"
                name: "Ubuntu Server"
                subtitle: "[Deployment Node]"
                backgroundColor: "#ffffff"
                color: "#000000"

                children:
                  - id: "14"
                    name: "Web Application"
                    subtitle: "[Container: Spring Boot]"
                    backgroundColor: "#dddddd"
                    color: "#000000"

          - id: "15"
            name: "Amazon RDS"
            subtitle: "[Deployment Node]"
            backgroundColor: "#ffffff"
            color: "#000000"

            children:
              - id: "16"
                name: "MySQL"
                subtitle: "[Deployment Node]"
                backgroundColor: "#ffffff"
                color: "#000000"

                children:
                  - id: "17"
                    name: "Database"
                    subtitle: "[Container: Relational database schema]"
                    backgroundColor: "#dddddd"
                    color: "#000000"

          - id: "10"
            name: "Route 53"
            subtitle: "[Infrastructure Node]"
            backgroundColor: "#dddddd"
            color: "#000000"

          - id: "11"
            name: "Elastic Load Balancer"
            subtitle: "[Infrastructure Node]"
            backgroundColor: "#dddddd"
            color: "#000000"

perspectives:
  - name: Static Structure
    relations:
      - from: "1"
        to: "2"
        label: "Uses"
        color: "#707070"

      - from: "1"
        to: "3"
        label: "Uses"
        color: "#707070"

      - from: "3"
        to: "4"
        label: "Reads from and writes to"
        color: "#707070"

  - name: Deployment - Live
    relations:
      - from: "14"
        to: "17"
        label: "Reads from and writes to"
        color: "#707070"
      - from: "10"
        to: "11"
        label: "Forwards requests to"
        description: "HTTPS"
        color: "#707070"
      - from: "11"
        to: "14"
        label: "Forwards requests to"
        description: "HTTPS"
        color: "#707070"