Skip to content

Commit 79e96f1

Browse files
committed
Improve the Networking Reference diagram
- Separate the Linux server icon from the main agent pool to indicate that the agent runs on the server. - Show a Kubernetes cluster separately from the main agent pool to indicate that the agent can be in the cluster.
1 parent 13372a1 commit 79e96f1

File tree

1 file changed

+47
-15
lines changed

1 file changed

+47
-15
lines changed

docs/pages/reference/deployment/networking.mdx

Lines changed: 47 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -44,34 +44,66 @@ group public_net(carbon-network-public)[Public Internet]
4444
group dmz_net(carbon-network-public)[DMZ or Public Subnet]
4545
group private_net(carbon-virtual-private-cloud)[Private Network]
4646
group private_net2(carbon-virtual-private-cloud)[Private Network]
47+
group k8s_net(carbon-virtual-private-cloud)[Kubernetes Cluster in Private Network]
4748
4849
%% Services
4950
service user(carbon-user)[User] in public_net
5051
service proxy(teleport-logo-purple)[Teleport Proxy Service] in dmz_net
5152
service auth(teleport-logo-purple)[Teleport Auth Service] in private_net2
52-
service ssh_node(carbon-bare-metal-server)[SSH Nodes] in private_net
53-
service db(carbon-db2-database)[Databases] in private_net
53+
54+
%% Core Private Services
5455
service agent(teleport-logo-purple)[Teleport Agents] in private_net
55-
service k8s(logos-kubernetes)[Kubernetes Clusters] in private_net
56+
service ssh_node(teleport-logo-purple)[Teleport SSH Service on a Linux Server] in private_net
57+
58+
%% Destination Endpoints
59+
service db(carbon-db2-database)[Databases] in private_net
5660
service windows(carbon-virtual-desktop)[Windows Desktops] in private_net
5761
service webapp(carbon-code)[Web Applications] in private_net
5862
59-
%% Connections
60-
junction agentconn in private_net
61-
junction agentconn2 in private_net
63+
%% Kubernetes Group Services
64+
service k8s_agent(teleport-logo-purple)[Teleport Agent] in k8s_net
65+
service k8s_pods(logos-kubernetes)[Kubernetes Pods] in k8s_net
66+
67+
%% Routing Junctions
68+
junction p_conn in private_net
69+
junction j_mid in private_net
70+
junction j_top in private_net
71+
junction j_bot in private_net
6272
63-
user:B --> T:proxy
73+
%% Buffer junctions for spacing
74+
junction j_usr_buf
75+
junction j_proxy_agent_buf
6476
65-
agent:L --> R:proxy
77+
%% Control Plane & Edge Connections
78+
user:R -- L:j_usr_buf
79+
j_usr_buf:R --> L:proxy
6680
auth:T --> B:proxy
6781
68-
agent:R -- L:agentconn
69-
agentconn:T --> B:ssh_node
70-
agentconn:B --> T:db
71-
agentconn2:L -- R:agentconn
72-
agentconn2:T --> B:k8s
73-
agentconn2:B --> T:windows
74-
agentconn2:R --> L:webapp
82+
%% Kubernetes Cluster routing
83+
%% Moved K8s group above the Proxy
84+
k8s_agent:B --> T:proxy
85+
k8s_agent:T --> B:k8s_pods
86+
87+
%% Reverse tunnel flow into the Proxy Service
88+
%% p_conn:L --> R:proxy
89+
90+
p_conn:L -- R:j_proxy_agent_buf
91+
j_proxy_agent_buf:L --> R:proxy
92+
93+
%% Positioning Teleport Agents above the SSH Service on a Linux Server
94+
%% service
95+
agent:B -- T:p_conn
96+
ssh_node:T -- B:p_conn
97+
98+
%% Vertical bus creation for endpoints
99+
agent:R -- L:j_mid
100+
j_mid:T -- B:j_top
101+
j_mid:B -- T:j_bot
102+
103+
%% Vertically aligned destination endpoints
104+
j_top:R --> L:db
105+
j_mid:R --> L:windows
106+
j_bot:R --> L:webapp
75107
```
76108

77109
## Public addresses

0 commit comments

Comments
 (0)