Skip to content

docs: add OpenChoreo on Azure reference architecture #755

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Draft
Mirage20 wants to merge 1 commit into
base: main
Choose a base branch
from
Draft

docs: add OpenChoreo on Azure reference architecture #755

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
150 changes: 150 additions & 0 deletions docs/platform-engineer-guide/reference-architectures/azure/control-plane.drawio
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,150 @@
<mxfile host="Electron">
<diagram id="openchoreo-cp-azure" name="Control plane on Azure">
<mxGraphModel dx="1148" dy="807" grid="1" gridSize="10" guides="1" tooltips="1" connect="1" arrows="1" fold="1" page="1" pageScale="1" pageWidth="1600" pageHeight="720" math="0" shadow="0">
<root>
<mxCell id="0" />
<mxCell id="1" parent="0" />
<mxCell id="title" parent="1" style="text;html=1;strokeColor=none;fillColor=none;align=left;verticalAlign=middle;fontSize=18;fontStyle=1;fontColor=#1A1F2B;" value="OpenChoreo - Control Plane on Azure" vertex="1">
<mxGeometry height="30" width="340" x="40" y="89" as="geometry" />
</mxCell>
<mxCell id="users" parent="1" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#ECEFF3;strokeColor=#9AA5B1;fontColor=#3A4552;fontSize=12;" value="Users / Internet" vertex="1">
<mxGeometry height="40" width="150" x="40" y="222" as="geometry" />
</mxCell>
<mxCell id="agents" parent="1" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#ECEFF3;strokeColor=#9AA5B1;fontColor=#3A4552;fontSize=12;" value="Remote-plane agents" vertex="1">
<mxGeometry height="40" width="150" x="40" y="498" as="geometry" />
</mxCell>
<mxCell id="lb" parent="1" style="image;html=1;aspect=fixed;points=[];verticalLabelPosition=top;verticalAlign=bottom;align=center;fontColor=#1A1F2B;fontSize=11;image=img/lib/azure2/networking/Load_Balancers.svg;" value="Azure LB (:443)" vertex="1">
<mxGeometry height="60" width="60" x="256" y="350" as="geometry" />
</mxCell>
<mxCell id="cluster" parent="1" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#EAF3FB;strokeColor=#0078D4;verticalAlign=top;align=left;spacingLeft=44;spacingTop=8;fontColor=#005BA1;fontStyle=1;fontSize=13;arcSize=3;" value="Control plane cluster (AKS)" vertex="1">
<mxGeometry height="480" width="830" x="360" y="140" as="geometry" />
</mxCell>
<mxCell id="aksicon" parent="1" style="image;html=1;aspect=fixed;points=[];image=img/lib/azure2/compute/Kubernetes_Services.svg;" value="" vertex="1">
<mxGeometry height="26" width="26" x="372" y="148" as="geometry" />
</mxCell>
<mxCell id="kgw" parent="1" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#FFFFFF;strokeColor=#8FB6DD;fontColor=#1A1F2B;fontSize=12;arcSize=8;" value="Gateway" vertex="1">
<mxGeometry height="200" width="120" x="390" y="280" as="geometry" />
</mxCell>
<mxCell id="cgw" parent="1" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#FFFFFF;strokeColor=#8FB6DD;fontColor=#1A1F2B;fontSize=12;arcSize=10;" value="Cluster-gateway" vertex="1">
<mxGeometry height="40" width="220" x="600" y="457" as="geometry" />
</mxCell>
<mxCell id="api" parent="1" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#FFFFFF;strokeColor=#8FB6DD;fontColor=#1A1F2B;fontSize=12;arcSize=10;" value="OpenChoreo API server" vertex="1">
<mxGeometry height="40" width="220" x="600" y="360" as="geometry" />
</mxCell>
<mxCell id="bs" parent="1" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#FFFFFF;strokeColor=#8FB6DD;fontColor=#1A1F2B;fontSize=12;arcSize=10;" value="Backstage portal" vertex="1">
<mxGeometry height="40" width="220" x="600" y="273" as="geometry" />
</mxCell>
<mxCell id="pa" parent="1" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#FFFFFF;strokeColor=#8FB6DD;fontColor=#1A1F2B;fontSize=12;dashed=1;arcSize=10;" value="Portal-assistant (optional)" vertex="1">
<mxGeometry height="40" width="220" x="600" y="545" as="geometry" />
</mxCell>
<mxCell id="ctrl" parent="1" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#FFFFFF;strokeColor=#8FB6DD;fontColor=#1A1F2B;fontSize=12;arcSize=10;" value="Controller manager" vertex="1">
<mxGeometry height="40" width="220" x="925" y="457" as="geometry" />
</mxCell>
<mxCell id="kapi" parent="1" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#EEF1F5;strokeColor=#9AA5B1;fontColor=#3A4552;fontSize=11;arcSize=10;" value="Kubernetes API server" vertex="1">
<mxGeometry height="40" width="220" x="925" y="190" as="geometry" />
</mxCell>
<mxCell id="ef" parent="1" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#FFFFFF;strokeColor=#8FB6DD;fontColor=#1A1F2B;fontSize=12;arcSize=10;" value="Event-forwarder" vertex="1">
<mxGeometry height="40" width="220" x="605" y="190" as="geometry" />
</mxCell>
<mxCell id="entra" parent="1" style="image;html=1;aspect=fixed;points=[];labelPosition=right;align=left;verticalLabelPosition=middle;verticalAlign=middle;spacingLeft=10;fontColor=#1A1F2B;fontSize=13;image=img/lib/azure2/identity/Azure_Active_Directory.svg;" value="Microsoft Entra ID (OIDC)" vertex="1">
<mxGeometry height="60" width="60" x="1276" y="346" as="geometry" />
</mxCell>
<mxCell id="pg" parent="1" style="image;html=1;aspect=fixed;points=[];labelPosition=right;align=left;verticalLabelPosition=middle;verticalAlign=middle;spacingLeft=10;fontColor=#1A1F2B;fontSize=13;image=img/lib/azure2/databases/Azure_Database_PostgreSQL_Server.svg;" value="Azure Database for PostgreSQL" vertex="1">
<mxGeometry height="60" width="60" x="1276" y="222" as="geometry" />
</mxCell>
<mxCell id="aoai" parent="1" style="image;html=1;aspect=fixed;points=[];labelPosition=right;align=left;verticalLabelPosition=middle;verticalAlign=middle;spacingLeft=10;fontColor=#1A1F2B;fontSize=13;image=img/lib/azure2/ai_machine_learning/AI_Studio.svg;" value="Microsoft Foundry (optional)" vertex="1">
<mxGeometry height="60" width="60" x="1276" y="535" as="geometry" />
</mxCell>
<mxCell id="G1" edge="1" parent="1" source="users" style="edgeStyle=orthogonalEdgeStyle;rounded=1;html=1;strokeColor=#5A6473;fontColor=#48515E;fontSize=10;endArrow=block;strokeWidth=1.4;entryX=-0.003;entryY=0.263;entryDx=0;entryDy=0;entryPerimeter=0;exitX=1;exitY=0.5;exitDx=0;exitDy=0;" target="lb" value="HTTPS">
<mxGeometry relative="1" as="geometry">
<mxPoint x="220" y="240" as="sourcePoint" />
<mxPoint x="224" y="374" as="targetPoint" />
</mxGeometry>
</mxCell>
<mxCell id="G2" edge="1" parent="1" source="lb" style="edgeStyle=orthogonalEdgeStyle;rounded=1;html=1;strokeColor=#5A6473;fontColor=#48515E;fontSize=10;endArrow=block;strokeWidth=1.4;exitX=1;exitY=0.5;entryX=0;entryY=0.5;" target="kgw" value="">
<mxGeometry relative="1" as="geometry" />
</mxCell>
<mxCell id="G3" edge="1" parent="1" source="kgw" style="edgeStyle=orthogonalEdgeStyle;rounded=1;html=1;strokeColor=#5A6473;fontColor=#48515E;fontSize=10;endArrow=block;strokeWidth=1.4;exitX=1;exitY=0.5;entryX=0;entryY=0.5;exitDx=0;exitDy=0;" target="api" value="HTTPRoute">
<mxGeometry relative="1" x="-0.0127" y="10" as="geometry">
<mxPoint as="offset" />
</mxGeometry>
</mxCell>
<mxCell id="G4" edge="1" parent="1" source="kgw" style="edgeStyle=orthogonalEdgeStyle;rounded=1;html=1;strokeColor=#5A6473;fontColor=#48515E;fontSize=10;endArrow=block;strokeWidth=1.4;exitX=1;exitY=0.25;entryX=0;entryY=0.5;exitDx=0;exitDy=0;" target="bs" value="HTTPRoute">
<mxGeometry relative="1" as="geometry" />
</mxCell>
<mxCell id="G5" edge="1" parent="1" source="kgw" style="edgeStyle=orthogonalEdgeStyle;rounded=1;html=1;strokeColor=#5A6473;fontColor=#48515E;fontSize=10;endArrow=block;strokeWidth=1.4;exitX=0.75;exitY=1;entryX=0;entryY=0.5;exitDx=0;exitDy=0;" target="pa" value="HTTPRoute">
<mxGeometry relative="1" x="0.2866" y="5" as="geometry">
<mxPoint as="offset" />
</mxGeometry>
</mxCell>
<mxCell id="T2" edge="1" parent="1" source="kgw" style="edgeStyle=orthogonalEdgeStyle;rounded=1;html=1;strokeColor=#5A6473;fontColor=#48515E;fontSize=10;endArrow=block;strokeWidth=1.4;entryX=0;entryY=0.5;exitX=1;exitY=0.75;exitDx=0;exitDy=0;" target="cgw" value="TLSRoute (passthrough)">
<mxGeometry relative="1" x="-0.2057" y="20" as="geometry">
<mxPoint as="offset" />
<Array as="points" />
<mxPoint x="680" y="690" as="sourcePoint" />
</mxGeometry>
</mxCell>
<mxCell id="I1" edge="1" parent="1" source="bs" style="edgeStyle=orthogonalEdgeStyle;rounded=1;html=1;strokeColor=#5A6473;fontColor=#48515E;fontSize=10;endArrow=block;strokeWidth=1.4;exitX=0.5;exitY=1;entryX=0.5;entryY=0;entryDx=0;entryDy=0;exitDx=0;exitDy=0;" target="api" value="read/write resources">
<mxGeometry relative="1" as="geometry" />
</mxCell>
<mxCell id="I2" edge="1" parent="1" source="api" style="edgeStyle=orthogonalEdgeStyle;rounded=1;html=1;strokeColor=#5A6473;fontColor=#48515E;fontSize=10;endArrow=block;strokeWidth=1.4;exitX=0.5;exitY=1;entryX=0.5;entryY=0;entryDx=0;entryDy=0;exitDx=0;exitDy=0;" target="cgw" value="reach remote planes">
<mxGeometry relative="1" as="geometry" />
</mxCell>
<mxCell id="I3" edge="1" parent="1" source="ctrl" style="edgeStyle=orthogonalEdgeStyle;rounded=1;html=1;strokeColor=#5A6473;fontColor=#48515E;fontSize=10;endArrow=block;strokeWidth=1.4;exitX=0;exitY=0.5;entryX=1;entryY=0.5;" target="cgw" value="reach remote planes">
<mxGeometry relative="1" x="0.01" y="-17" as="geometry">
<mxPoint as="offset" />
</mxGeometry>
</mxCell>
<mxCell id="I4" edge="1" parent="1" source="ctrl" style="edgeStyle=orthogonalEdgeStyle;rounded=1;html=1;strokeColor=#5A6473;fontColor=#48515E;fontSize=10;endArrow=block;strokeWidth=1.4;exitX=0.5;exitY=0;entryX=0.5;entryY=1;exitDx=0;exitDy=0;entryDx=0;entryDy=0;" target="kapi" value="reconcile CRDs">
<mxGeometry relative="1" as="geometry" />
</mxCell>
<mxCell id="I5" edge="1" parent="1" source="ef" style="edgeStyle=orthogonalEdgeStyle;rounded=1;html=1;strokeColor=#5A6473;fontColor=#48515E;fontSize=10;endArrow=block;strokeWidth=1.4;exitX=1;exitY=0.5;entryX=0;entryY=0.5;entryDx=0;entryDy=0;exitDx=0;exitDy=0;" target="kapi" value="watch">
<mxGeometry relative="1" as="geometry" />
</mxCell>
<mxCell id="I6" edge="1" parent="1" source="ef" style="edgeStyle=orthogonalEdgeStyle;rounded=1;html=1;strokeColor=#5A6473;fontColor=#48515E;fontSize=10;endArrow=block;strokeWidth=1.4;exitX=0;exitY=0.4;entryX=0.5;entryY=0;entryDx=0;entryDy=0;" target="bs" value="push updates">
<mxGeometry relative="1" as="geometry" />
</mxCell>
<mxCell id="I7" edge="1" parent="1" source="api" style="edgeStyle=orthogonalEdgeStyle;rounded=1;html=1;strokeColor=#5A6473;fontColor=#48515E;fontSize=10;endArrow=block;strokeWidth=1.4;exitX=1;exitY=0.25;entryX=0.25;entryY=1;entryDx=0;entryDy=0;exitDx=0;exitDy=0;" target="kapi" value="read/write CRDs">
<mxGeometry relative="1" x="-0.314" y="11" as="geometry">
<mxPoint as="offset" />
</mxGeometry>
</mxCell>
<mxCell id="O1" edge="1" parent="1" source="api" style="edgeStyle=orthogonalEdgeStyle;rounded=1;html=1;strokeColor=#5A6473;fontColor=#48515E;fontSize=10;endArrow=block;strokeWidth=1.4;exitX=1;exitY=0.75;exitDx=0;exitDy=0;entryX=0.032;entryY=0.742;entryDx=0;entryDy=0;entryPerimeter=0;" target="entra" value="OIDC (JWT)">
<mxGeometry relative="1" x="0.3333" y="11" as="geometry">
<mxPoint as="offset" />
</mxGeometry>
</mxCell>
<mxCell id="O2" edge="1" parent="1" source="bs" style="edgeStyle=orthogonalEdgeStyle;rounded=1;html=1;strokeColor=#5A6473;fontColor=#48515E;fontSize=10;endArrow=block;strokeWidth=1.4;exitX=1;exitY=0.75;exitDx=0;exitDy=0;entryX=-0.005;entryY=0.31;entryDx=0;entryDy=0;entryPerimeter=0;" target="entra" value="sign-in">
<mxGeometry relative="1" x="0.2371" as="geometry">
<mxPoint as="offset" />
<Array as="points">
<mxPoint x="1150" y="303" />
<mxPoint x="1150" y="365" />
</Array>
<mxPoint x="1260" y="370" as="targetPoint" />
</mxGeometry>
</mxCell>
<mxCell id="O4" edge="1" parent="1" source="bs" style="edgeStyle=orthogonalEdgeStyle;rounded=1;html=1;strokeColor=#5A6473;fontColor=#48515E;fontSize=10;endArrow=block;strokeWidth=1.4;exitX=1;exitY=0.25;exitDx=0;exitDy=0;entryX=-0.062;entryY=0.6;entryDx=0;entryDy=0;entryPerimeter=0;" target="pg" value="catalog DB">
<mxGeometry relative="1" x="0.4188" as="geometry">
<mxPoint as="offset" />
<Array as="points">
<mxPoint x="1150" y="282" />
<mxPoint x="1150" y="258" />
</Array>
<mxPoint x="1260" y="258" as="targetPoint" />
</mxGeometry>
</mxCell>
<mxCell id="O5" edge="1" parent="1" source="pa" style="edgeStyle=orthogonalEdgeStyle;rounded=1;html=1;strokeColor=#5A6473;fontColor=#48515E;fontSize=10;endArrow=block;strokeWidth=1.4;labelBackgroundColor=default;labelBorderColor=none;textShadow=0;" target="aoai" value="chat completions">
<mxGeometry relative="1" x="-0.009" y="5" as="geometry">
<mxPoint as="offset" />
<mxPoint x="810" y="560" as="sourcePoint" />
<mxPoint x="1380" y="560" as="targetPoint" />
</mxGeometry>
</mxCell>
<mxCell id="T1" edge="1" parent="1" source="agents" style="edgeStyle=orthogonalEdgeStyle;rounded=1;html=1;strokeColor=#5A6473;fontColor=#48515E;fontSize=10;endArrow=block;strokeWidth=1.4;exitX=1;exitY=0.5;entryX=0;entryY=0.75;" target="lb" value="mTLS">
<mxGeometry relative="1" as="geometry" />
</mxCell>
</root>
</mxGraphModel>
</diagram>
</mxfile>
3 changes: 3 additions & 0 deletions docs/platform-engineer-guide/reference-architectures/azure/control-plane.svg
View file
Open in desktop
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading