Structurizr

Upload

workspace { model { softwareSystem = softwareSystem "Software System" { database = container "Database Schema" api = container "Service API" { -> database "Uses" } } production = deploymentEnvironment "Production" { serviceInstance1 = deploymentGroup "Service instance 1" serviceInstance2 = deploymentGroup "Service instance 2" deploymentNode "Server 1" { containerInstance api serviceInstance1 deploymentNode "Database Server" { containerInstance database serviceInstance1 } } deploymentNode "Server 2" { containerInstance api serviceInstance2 deploymentNode "Database Server" { containerInstance database serviceInstance2 } } } } views { deployment * production { include * autolayout } } }

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 Deployment - Production

top to bottom direction

skinparam {
  arrowFontSize 10
  defaultTextAlignment center
  wrapWidth 200
  maxMessageSize 100
}

hide stereotype

skinparam rectangle<<Production.Server1.DatabaseServer.DatabaseSchema_1>> {
  BackgroundColor #dddddd
  FontColor #000000
  BorderColor #9a9a9a
  shadowing false
}
skinparam rectangle<<Production.Server2.DatabaseServer.DatabaseSchema_1>> {
  BackgroundColor #dddddd
  FontColor #000000
  BorderColor #9a9a9a
  shadowing false
}
skinparam rectangle<<Production.Server1.DatabaseServer>> {
  BackgroundColor #ffffff
  FontColor #000000
  BorderColor #888888
  shadowing false
}
skinparam rectangle<<Production.Server2.DatabaseServer>> {
  BackgroundColor #ffffff
  FontColor #000000
  BorderColor #888888
  shadowing false
}
skinparam rectangle<<Production.Server1>> {
  BackgroundColor #ffffff
  FontColor #000000
  BorderColor #888888
  shadowing false
}
skinparam rectangle<<Production.Server2>> {
  BackgroundColor #ffffff
  FontColor #000000
  BorderColor #888888
  shadowing false
}
skinparam rectangle<<Production.Server1.ServiceAPI_1>> {
  BackgroundColor #dddddd
  FontColor #000000
  BorderColor #9a9a9a
  shadowing false
}
skinparam rectangle<<Production.Server2.ServiceAPI_1>> {
  BackgroundColor #dddddd
  FontColor #000000
  BorderColor #9a9a9a
  shadowing false
}

rectangle "Server 2\n<size:10>[Deployment Node]</size>" <<Production.Server2>> as Production.Server2 {
  rectangle "==Service API\n<size:10>[Container]</size>" <<Production.Server2.ServiceAPI_1>> as Production.Server2.ServiceAPI_1
  rectangle "Database Server\n<size:10>[Deployment Node]</size>" <<Production.Server2.DatabaseServer>> as Production.Server2.DatabaseServer {
    rectangle "==Database Schema\n<size:10>[Container]</size>" <<Production.Server2.DatabaseServer.DatabaseSchema_1>> as Production.Server2.DatabaseServer.DatabaseSchema_1
  }

}

rectangle "Server 1\n<size:10>[Deployment Node]</size>" <<Production.Server1>> as Production.Server1 {
  rectangle "==Service API\n<size:10>[Container]</size>" <<Production.Server1.ServiceAPI_1>> as Production.Server1.ServiceAPI_1
  rectangle "Database Server\n<size:10>[Deployment Node]</size>" <<Production.Server1.DatabaseServer>> as Production.Server1.DatabaseServer {
    rectangle "==Database Schema\n<size:10>[Container]</size>" <<Production.Server1.DatabaseServer.DatabaseSchema_1>> as Production.Server1.DatabaseServer.DatabaseSchema_1
  }

}

Production.Server2.ServiceAPI_1 .[#707070,thickness=2].> Production.Server2.DatabaseServer.DatabaseSchema_1 : "<color:#707070>Uses"
Production.Server1.ServiceAPI_1 .[#707070,thickness=2].> Production.Server1.DatabaseServer.DatabaseSchema_1 : "<color:#707070>Uses"
@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.

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.

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

digraph {
  compound=true
  graph [fontname="Arial", rankdir=TB, 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">Deployment - Production</font>>

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

    11 [id=11,shape=rect, label=<<font point-size="34">Service API</font><br /><font point-size="19">[Container]</font>>, style=filled, color="#9a9a9a", fillcolor="#dddddd", fontcolor="#000000"]
    subgraph cluster_12 {
      margin=25
      label=<<font point-size="24">Database Server</font><br /><font point-size="19">[Deployment Node]</font>>
      labelloc=b
      color="#888888"
      fontcolor="#000000"
      fillcolor="#ffffff"

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

  }

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

    6 [id=6,shape=rect, label=<<font point-size="34">Service API</font><br /><font point-size="19">[Container]</font>>, style=filled, color="#9a9a9a", fillcolor="#dddddd", fontcolor="#000000"]
    subgraph cluster_7 {
      margin=25
      label=<<font point-size="24">Database Server</font><br /><font point-size="19">[Deployment Node]</font>>
      labelloc=b
      color="#888888"
      fontcolor="#000000"
      fillcolor="#ffffff"

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

  }

  11 -> 13 [id=14, label=<<font point-size="24">Uses</font>>, style="dashed", color="#707070", fontcolor="#707070"]
  6 -> 8 [id=9, label=<<font point-size="24">Uses</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: "Software System"
    subtitle: "[Software System]"
    backgroundColor: "#dddddd"
    color: "#000000"

    children:
      - id: "2"
        name: "Database Schema"
        subtitle: "[Container]"
        backgroundColor: "#dddddd"
        color: "#000000"

      - id: "3"
        name: "Service API"
        subtitle: "[Container]"
        backgroundColor: "#dddddd"
        color: "#000000"

  - id: "10"
    name: "Server 2"
    subtitle: "[Deployment Node]"
    backgroundColor: "#ffffff"
    color: "#000000"

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

        children:
          - id: "13"
            name: "Database Schema"
            subtitle: "[Container]"
            backgroundColor: "#dddddd"
            color: "#000000"

      - id: "11"
        name: "Service API"
        subtitle: "[Container]"
        backgroundColor: "#dddddd"
        color: "#000000"

  - id: "5"
    name: "Server 1"
    subtitle: "[Deployment Node]"
    backgroundColor: "#ffffff"
    color: "#000000"

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

        children:
          - id: "8"
            name: "Database Schema"
            subtitle: "[Container]"
            backgroundColor: "#dddddd"
            color: "#000000"

      - id: "6"
        name: "Service API"
        subtitle: "[Container]"
        backgroundColor: "#dddddd"
        color: "#000000"

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

  - name: Deployment - Production
    relations:
      - from: "11"
        to: "13"
        label: "Uses"
        color: "#707070"
      - from: "6"
        to: "8"
        label: "Uses"
        color: "#707070"