Open In Colab ⬇ Download .ipynb ✓ Dry-Run Verified (2 cells)

05. Cloud Architecture & Software Flow Diagrams

drawlib.diagrams provides 6 domain-specific diagram engines (ArchitectureDiagram, FlowDiagram, SequenceDiagram, StateDiagram, ClassDiagram, ErDiagram).

Cloud Region VPC Topology Built with ArchitectureDiagram
Cloud Region VPC Topology Built with ArchitectureDiagram
View Drawlib Python Code
from drawlib.canvas import save, setup
from drawlib.diagrams.architecture import (
    ArchitectureDiagram,
    GcpIcon,
    Node,
    NodeGroup,
    PhosphorIcon,
)
from drawlib.styles import Styles

setup(width=148, height=62)

d = ArchitectureDiagram(
    node_style=Styles.PrimaryBold,
    node_text_style=Styles.DarkBold.patch(text_size=10.5),
    edge_style=Styles.DarkBold,
    edge_text_style=Styles.DarkBold.patch(text_size=10.0),
    node_card_style=Styles.White,
)

client = d.add(
    Node(
        "Clients",
        width=22.0,
        height=17.0,
        icon=PhosphorIcon.DEVICES,
        icon_size=5.8,
        card_style=Styles.Neutral.patch(shape_r=2.0),
    ),
    xy=(14.0, 26.0),
)

vpc = d.add(
    NodeGroup(
        title="Google Cloud VPC (us-central1)",
        width=104.0,
        height=50.0,
        style=Styles.PrimaryNeutral.patch(shape_r=2.4),
        text_style=Styles.DarkBold.patch(text_size=11.0, halign="left"),
    ),
    xy=(38.0, 4.0),
)

gateway = vpc.add(
    Node(
        "API Gateway",
        width=22.0,
        height=17.0,
        icon=PhosphorIcon.SHIELD_CHECK,
        icon_size=5.8,
        style=Styles.WhiteBold,
        text_style=Styles.WhiteBold.patch(text_size=10.5),
        card_style=Styles.PrimaryFlat.patch(shape_r=2.0),
    ),
    xy=(16.0, 22.0),
)

worker = vpc.add(
    Node(
        "Cloud Run API",
        width=24.0,
        height=17.0,
        icon=GcpIcon.CLOUD_RUN,
        icon_size=6.0,
        card_style=Styles.White.patch(shape_r=1.8),
    ),
    xy=(52.0, 22.0),
)

db = vpc.add(
    Node(
        "Cloud SQL",
        width=22.0,
        height=17.0,
        icon=GcpIcon.CLOUD_SQL,
        icon_size=6.0,
        card_style=Styles.SecondaryNeutral.patch(shape_r=1.8),
    ),
    xy=(86.0, 22.0),
)

d.connect(client, gateway, label="HTTPS")
d.connect(gateway, worker, label="gRPC")
d.connect(worker, db, label="SQL")
d.draw(xy=(2.0, 2.0))

save()

1. Inspecting Architecture Topology in Python

Let's define service nodes and connection labels in Python before rendering a live FlowDiagram:

In [setup]:
!pip install -q drawlib
In [1]:
flow_steps = [
    ("req", "Incoming Request"),
    ("auth", "Token Valid?"),
    ("allow", "Route to Worker"),
    ("deny", "Return 401"),
]
print("Flow steps:", [step[0] for step in flow_steps])
Out [1]:
Flow steps: ['req', 'auth', 'allow', 'deny']

2. Live Decision Flowchart with FlowDiagram

Let's render an authentication decision workflow inline:

In [2]:
from drawlib.canvas import show, setup
from drawlib.diagrams.flow import Decision, End, FlowDiagram, Process, Start
from drawlib.styles import Styles

setup(width=128, height=48, cwd=True)

flow = FlowDiagram(
    node_style=Styles.Neutral.patch(shape_r=1.8),
    edge_style=Styles.DarkBold,
    edge_text_style=Styles.DarkBold.patch(text_size=10.0),
)

n_start = flow.add(
    Start("Incoming Request", width=26.0, height=11.0, text_style=Styles.DarkBold.patch(text_size=10.2)),
    xy=(18.0, 26.0),
)
n_check = flow.add(
    Decision(
        "JWT Valid?",
        width=26.0,
        height=15.0,
        style=Styles.PrimaryFlat,
        text_style=Styles.WhiteBold.patch(text_size=10.5),
    ),
    xy=(58.0, 26.0),
)
n_allow = flow.add(
    Process(
        "Forward to Service",
        width=28.0,
        height=11.0,
        style=Styles.PrimaryNeutral,
        text_style=Styles.DarkBold.patch(text_size=10.2),
    ),
    xy=(104.0, 26.0),
)
n_deny = flow.add(
    End(
        "Reject (401)",
        width=28.0,
        height=11.0,
        style=Styles.SecondaryNeutral,
        text_style=Styles.DarkBold.patch(text_size=10.2),
    ),
    xy=(104.0, 10.0),
)

flow.connect(n_start, n_check)
flow.connect(n_check, n_allow, label="Yes", start_side="right", end_side="left")
flow.connect(n_check, n_deny, label="No", start_side="bottom", end_side="left", routing="orthogonal")
flow.draw(xy=(2.0, 2.0))

show()
Out [2]:
Output [2]