Structurizr

The Structurizr DSL (as mentioned on the ThoughtWorks Tech Radar - Techniques - Diagrams as code) allows you to create multiple diagrams based upon the C4 model, in multiple output formats, from a single DSL source file. Some features are unavailable on this demo page - we recommend signing up for a free account and/or using the Structurizr CLI.

Structurizr CLI | VS Code extensions | Examples: Getting Started - Amazon Web Services - Big Bank plc | Help

workspace "Amazon Web Services Example" "An example AWS deployment architecture." { model { springPetClinic = softwaresystem "Spring PetClinic" "Allows employees to view and manage information regarding the veterinarians, the clients, and their pets." "Spring Boot Application" { webApplication = container "Web Application" "Allows employees to view and manage information regarding the veterinarians, the clients, and their pets." "Java and Spring Boot" database = container "Database" "Stores information regarding the veterinarians, the clients, and their pets." "Relational database schema" "Database" } webApplication -> database "Reads from and writes to" "JDBC/SSL" deploymentEnvironment "Live" { deploymentNode "Amazon Web Services" "" "" "Amazon Web Services - Cloud" { deploymentNode "US-East-1" "" "" "Amazon Web Services - Region" { route53 = infrastructureNode "Route 53" "" "" "Amazon Web Services - Route 53" elb = infrastructureNode "Elastic Load Balancer" "" "" "Amazon Web Services - Elastic Load Balancing" deploymentNode "Autoscaling group" "" "" "Amazon Web Services - Auto Scaling" { deploymentNode "Amazon EC2" "" "" "Amazon Web Services - EC2" { webApplicationInstance = containerInstance webApplication } } deploymentNode "Amazon RDS" "" "" "Amazon Web Services - RDS" { deploymentNode "MySQL" "" "" "Amazon Web Services - RDS_MySQL_instance" { containerInstance database } } } } route53 -> elb "Forwards requests to" "HTTPS" elb -> webApplicationInstance "Forwards requests to" "HTTPS" } } views { deployment springPetClinic "Live" "AmazonWebServicesDeployment" { include * autolayout lr } styles { element "Element" { shape roundedbox background "#ffffff" } element "Database" { shape cylinder } element "Infrastructure Node" { shape roundedbox } } themes https://static.structurizr.com/themes/amazon-web-services-2020.04.30/theme.json } }

Structurizr

Diagram

Structurizr

Graph

Export

PlantUML

Export

C4-PlantUML

Export

Mermaid

Export

WebSequenceDiagrams

Export

Ilograph

PlantUML definitions are available via the Structurizr CLI export command, using the -format plantuml parameter.

@startuml(id=AmazonWebServicesDeployment)
title Spring PetClinic - Deployment - Live

skinparam {
  shadowing false
  arrowFontSize 10
  defaultTextAlignment center
  wrapWidth 200
  maxMessageSize 100
}
hide stereotype
left to right direction
skinparam rectangle<<11>> {
  BackgroundColor #ffffff
  FontColor #000000
  BorderColor #B2B2B2
  roundCorner 20
}
skinparam node<<12>> {
  BackgroundColor #ffffff
  FontColor #3b48cc
  BorderColor #3b48cc
  roundCorner 20
}
skinparam node<<13>> {
  BackgroundColor #ffffff
  FontColor #000000
  BorderColor #000000
  roundCorner 20
}
skinparam database<<14>> {
  BackgroundColor #ffffff
  FontColor #000000
  BorderColor #B2B2B2
}
skinparam node<<5>> {
  BackgroundColor #ffffff
  FontColor #232f3e
  BorderColor #232f3e
  roundCorner 20
}
skinparam node<<6>> {
  BackgroundColor #ffffff
  FontColor #147eba
  BorderColor #147eba
  roundCorner 20
}
skinparam rectangle<<7>> {
  BackgroundColor #ffffff
  FontColor #693cc5
  BorderColor #693cc5
  roundCorner 20
}
skinparam rectangle<<8>> {
  BackgroundColor #ffffff
  FontColor #693cc5
  BorderColor #693cc5
  roundCorner 20
}
skinparam node<<9>> {
  BackgroundColor #ffffff
  FontColor #cc2264
  BorderColor #cc2264
  roundCorner 20
}
skinparam node<<10>> {
  BackgroundColor #ffffff
  FontColor #d86613
  BorderColor #d86613
  roundCorner 20
}
node "Amazon Web Services\n[Deployment Node]" <<5>> as 5 {
  node "US-East-1\n[Deployment Node]" <<6>> as 6 {
    node "Amazon RDS\n[Deployment Node]" <<12>> as 12 {
      node "MySQL\n[Deployment Node]" <<13>> as 13 {
        database "==Database\n<size:10>[Container: Relational database schema]</size>\n\nStores information regarding the veterinarians, the clients, and their pets." <<14>> as 14
      }
    }
    node "Autoscaling group\n[Deployment Node]" <<9>> as 9 {
      node "Amazon EC2\n[Deployment Node]" <<10>> as 10 {
        rectangle "==Web Application\n<size:10>[Container: Java and Spring Boot]</size>\n\nAllows employees to view and manage information regarding the veterinarians, the clients, and their pets." <<11>> as 11
      }
    }
    rectangle "==Elastic Load Balancer\n<size:10>[Infrastructure Node]</size>" <<8>> as 8
    rectangle "==Route 53\n<size:10>[Infrastructure Node]</size>" <<7>> as 7
  }
}
8 .[#707070].> 11 : "Forwards requests to\n<size:8>[HTTPS]</size>"
7 .[#707070].> 8 : "Forwards requests to\n<size:8>[HTTPS]</size>"
11 .[#707070].> 14 : "Reads from and writes to\n<size:8>[JDBC/SSL]</size>"
@enduml

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

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

@startuml(id=AmazonWebServicesDeployment)
!includeurl https://raw.githubusercontent.com/plantuml-stdlib/C4-PlantUML/master/C4.puml
!includeurl https://raw.githubusercontent.com/plantuml-stdlib/C4-PlantUML/master/C4_Context.puml
!includeurl https://raw.githubusercontent.com/plantuml-stdlib/C4-PlantUML/master/C4_Container.puml
!includeurl https://raw.githubusercontent.com/plantuml-stdlib/C4-PlantUML/master/C4_Component.puml
LAYOUT_WITH_LEGEND()

title Spring PetClinic - Deployment - Live

node "Amazon Web Services" <<Deployment Node>> as 5 {
  node "US-East-1" <<Deployment Node>> as 6 {
    node "Amazon RDS" <<Deployment Node>> as 12 {
      node "MySQL" <<Deployment Node>> as 13 {
        Container(14, "Database", "Relational database schema", "Stores information regarding the veterinarians, the clients, and their pets.")
      }
    }
    node "Autoscaling group" <<Deployment Node>> as 9 {
      node "Amazon EC2" <<Deployment Node>> as 10 {
        Container(11, "Web Application", "Java and Spring Boot", "Allows employees to view and manage information regarding the veterinarians, the clients, and their pets.")
      }
    }
    rectangle 8 <<Infrastructure Node>> #ffffff [
      Elastic Load Balancer
    ]
    rectangle 7 <<Infrastructure Node>> #ffffff [
      Route 53
    ]
  }
}
Rel_D(8, 11, "Forwards requests to", "HTTPS")
Rel_D(7, 8, "Forwards requests to", "HTTPS")
Rel_D(11, 14, "Reads from and writes to", "JDBC/SSL")
@enduml

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

Mermaid definitions are available via the Structurizr CLI export command, using the -format mermaid parameter.

graph LR
  linkStyle default fill:#ffffff

  subgraph 5 [Amazon Web Services]
    subgraph 6 [US-East-1]
      subgraph 12 [Amazon RDS]
        subgraph 13 [MySQL]
            14[("<div style='font-weight: bold'>Database</div><div style='font-size: 70%; margin-top: 0px'>[Container: Relational database schema]</div><div style='font-size: 80%; margin-top:10px'>Stores information regarding<br />the veterinarians, the<br />clients, and their pets.</div>")]
            style 14 fill:#ffffff,stroke:#b2b2b2,color:#000000
        end
        style 13 fill:#ffffff,stroke:#000000,color:#000000
      end
      style 12 fill:#ffffff,stroke:#3b48cc,color:#3b48cc
      subgraph 9 [Autoscaling group]
        subgraph 10 [Amazon EC2]
            11("<div style='font-weight: bold'>Web Application</div><div style='font-size: 70%; margin-top: 0px'>[Container: Java and Spring Boot]</div><div style='font-size: 80%; margin-top:10px'>Allows employees to view and<br />manage information regarding<br />the veterinarians, the<br />clients, and their pets.</div>")
            style 11 fill:#ffffff,stroke:#b2b2b2,color:#000000
        end
        style 10 fill:#ffffff,stroke:#d86613,color:#d86613
      end
      style 9 fill:#ffffff,stroke:#cc2264,color:#cc2264
        8("<div style='font-weight: bold'>Elastic Load Balancer</div><div style='font-size: 70%; margin-top: 0px'>[Infrastructure Node]</div><div style='font-size: 80%; margin-top:10px'></div>")
        style 8 fill:#ffffff,stroke:#693cc5,color:#693cc5
        7("<div style='font-weight: bold'>Route 53</div><div style='font-size: 70%; margin-top: 0px'>[Infrastructure Node]</div><div style='font-size: 80%; margin-top:10px'></div>")
        style 7 fill:#ffffff,stroke:#693cc5,color:#693cc5
    end
    style 6 fill:#ffffff,stroke:#147eba,color:#147eba
  end
  style 5 fill:#ffffff,stroke:#232f3e,color:#232f3e
  8-. "<div>Forwards requests to</div><div style='font-size: 70%'>[HTTPS]</div>" .->11
  7-. "<div>Forwards requests to</div><div style='font-size: 70%'>[HTTPS]</div>" .->8
  11-. "<div>Reads from and writes to</div><div style='font-size: 70%'>[JDBC/SSL]</div>" .->14

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: "Spring PetClinic"
    subtitle: "[Software System]"
    description: "Allows employees to view and manage information regarding the veterinarians, the clients, and their pets."
    backgroundColor: "#ffffff"
    color: "#000000"

    children:
      - id: "2"
        name: "Web Application"
        subtitle: "[Container: Java and Spring Boot]"
        description: "Allows employees to view and manage information regarding the veterinarians, the clients, and their pets."
        backgroundColor: "#ffffff"
        color: "#000000"


      - id: "3"
        name: "Database"
        subtitle: "[Container: Relational database schema]"
        description: "Stores information regarding the veterinarians, the clients, and their pets."
        backgroundColor: "#ffffff"
        color: "#000000"



  - id: "5"
    name: "Amazon Web Services"
    subtitle: "[Deployment Node]"
    backgroundColor: "#ffffff"
    color: "#232f3e"

    children:
    - id: "6"
      name: "US-East-1"
      subtitle: "[Deployment Node]"
      backgroundColor: "#ffffff"
      color: "#147eba"

      children:
      - id: "12"
        name: "Amazon RDS"
        subtitle: "[Deployment Node]"
        backgroundColor: "#ffffff"
        color: "#3b48cc"

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

          children:
            - id: "14"
              name: "Database"
              subtitle: "[Container: Relational database schema]"
              description: "Stores information regarding the veterinarians, the clients, and their pets."
              backgroundColor: "#ffffff"
              color: "#000000"

      - id: "9"
        name: "Autoscaling group"
        subtitle: "[Deployment Node]"
        backgroundColor: "#ffffff"
        color: "#cc2264"

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

          children:
            - id: "11"
              name: "Web Application"
              subtitle: "[Container: Java and Spring Boot]"
              description: "Allows employees to view and manage information regarding the veterinarians, the clients, and their pets."
              backgroundColor: "#ffffff"
              color: "#000000"

        - id: "7"
          name: "Route 53"
          subtitle: "[Infrastructure Node]"
          backgroundColor: "#ffffff"
          color: "#693cc5"

        - id: "8"
          name: "Elastic Load Balancer"
          subtitle: "[Infrastructure Node]"
          backgroundColor: "#ffffff"
          color: "#693cc5"

perspectives:
  - name: Static Structure
    relations:
      - from: "2"
        to: "3"
        label: "Reads from and writes to"
        description: "JDBC/SSL"

  - name: Deployment - Live
    relations:
      - from: "11"
        to: "14"
        label: "Reads from and writes to"
        description: "JDBC/SSL"

      - from: "7"
        to: "8"
        label: "Forwards requests to"
        description: "HTTPS"

      - from: "8"
        to: "11"
        label: "Forwards requests to"
        description: "HTTPS"