Skip to content

Commit

Permalink
chore: update cloud technical architecture docs/images (#234)
Browse files Browse the repository at this point in the history
Signed-off-by: Mark Phelps <[email protected]>
  • Loading branch information
markphelps authored Jun 17, 2024
1 parent 14b57dc commit 7ee3abf
Show file tree
Hide file tree
Showing 9 changed files with 521 additions and 517 deletions.
12 changes: 8 additions & 4 deletions cloud/architecture/overview.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -56,13 +56,17 @@ When you register your instance in this way with Flipt Cloud, we issue you with

Using this DNS name, requests for your instances will flow though our API gateways, load-balancers and then only reach your instances once fully authenticated.

<Info>
Instances, environments, gateways.. what's the difference? Check out our [concepts](/cloud/concepts) page for more details.
</Info>

This entire process is performed over secure TLS connections from your end users back to your instances.
All of which is done without you having to provide TLS certificates, and without having to manage certificate rotation.

## Tunnel Registration

Your connections are made using an API key credential obtained from our Flipt Cloud UI, or via the `flipt cloud login` sub-command of the Flipt CLI.
This credential is used in an initial handshake to identify your Flipt Cloud organization and the logical instance your Flipt is joining.
This credential is used in an initial handshake to identify your Flipt Cloud organization and the logical environment your Flipt is joining.

<img
className="block dark:hidden"
Expand All @@ -73,14 +77,14 @@ This credential is used in an initial handshake to identify your Flipt Cloud org
src="/images/cloud/architecture/handshake-dark.svg"
/>

Once registered and associated with Flipt Cloud, your Flipt instance is added to our remote load balancer pool for your logical instance.
Now when you visit your new Flipt Cloud instance subdomain, your requests are routed to the instances deployed on your infrastructure.
Once registered and associated with Flipt Cloud, your Flipt instance is added to our remote load balancer pool for your logical environment.
Now when you visit your new Flipt Cloud environment subdomain, your requests are routed to the instances deployed on your infrastructure.

The majority of the tunneling functionality we perform is provided by our open-source project [Reverst](https://github.com/flipt-io/reverst).
Reverst is unique in that it leverages HTTP/3 and the QUIC protocol to establish secure, reliable, and performant connections for tunnels.

Check out our [blog post](https://blog.flipt.io/so-we-built-reverst) on how and why we chose to build our reverse tunnels in this way.

We deploy and scale multiple instances of Reverst on our infrastructure for establishing and managing these tunnels for you, all while tightly integrating them with the Flipt Cloud user interface, authentication, and instance management system.
We deploy and scale multiple instances of Reverst on our infrastructure for establishing and managing these tunnels for you, all while tightly integrating them with the Flipt Cloud user interface, authentication, and environment management system.

Have more questions about how Flipt Cloud works? Join our [Discord](https://flipt.io/discord) and ask away! We're always happy to help.
334 changes: 167 additions & 167 deletions images/cloud/architecture/architecture-overview-dark.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
190 changes: 95 additions & 95 deletions images/cloud/architecture/architecture-overview-light.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
4 changes: 2 additions & 2 deletions images/cloud/architecture/architecture-overview.d2
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,7 @@ internet: {
internet -> cloud.gateway: flipt.cloud {
style.font-size: 32
}
internet -> cloud.gateway: instance-org.flipt.cloud {
internet -> cloud.gateway: environment-org.flipt.cloud {
style.font-size: 32
}

Expand Down Expand Up @@ -47,7 +47,7 @@ cloud: "" {
icon: https://icons.terrastruct.com/infra%2F012-data.svg
style.font-size: 32
}
gateway -> reverst: instance-org.flipt.cloud {
gateway -> reverst: environment-org.flipt.cloud {
style.font-size: 32
}
}
Expand Down
2 changes: 1 addition & 1 deletion images/cloud/architecture/common-infrastructure-dark.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
2 changes: 1 addition & 1 deletion images/cloud/architecture/common-infrastructure-light.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
316 changes: 158 additions & 158 deletions images/cloud/architecture/handshake-dark.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
172 changes: 86 additions & 86 deletions images/cloud/architecture/handshake-light.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
6 changes: 3 additions & 3 deletions images/cloud/architecture/handshake.d2
Original file line number Diff line number Diff line change
Expand Up @@ -12,9 +12,9 @@ register: Flipt registers on flipt.cloud {

user: Flipt User

instance: Instance served on flipt.cloud {
user -> tunnel.req: instance-org.flipt.cloud
tunnelled request: {
environment: Instance served on flipt.cloud {
user -> tunnel.req: environment-org.flipt.cloud
Tunnelled request: {
tunnel -> client_one.req: Request
client_one.req -> tunnel: Response
}
Expand Down

0 comments on commit 7ee3abf

Please sign in to comment.