Skip to content
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.

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

fix: tidy some serverless docs #8080

Open
wants to merge 5 commits into
base: main
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
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
9 changes: 7 additions & 2 deletions app/konnect/gateway-manager/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,7 +19,7 @@ _default control plane, a KIC control plane, and control planes for development
With {{site.konnect_short_name}} hosting the control plane, a data plane node
doesn't need a database to store configuration data. Instead, configuration
is stored in-memory on each node, and you can easily update all data plane nodes
in a control plane with a few clicks. This model applies whether the nodes are managed on-premise, in cloud-hosted environments, or through our fully managed SaaS offering with [Dedicated Cloud Gateways](/konnect/gateway-manager/dedicated-cloud-gateways).
in a control plane with a few clicks. This model applies whether the nodes are managed on-premise, in cloud-hosted environments, or through our fully managed SaaS offering with [Dedicated Cloud Gateways](/konnect/gateway-manager/dedicated-cloud-gateways) or [Serverless Gateways](/konnect/gateway-manager/serverless-gateways).

The Gateway Manager, and the {{site.konnect_saas}} application as
a whole, does not have access or visibility into the data flowing through your
Expand Down Expand Up @@ -174,7 +174,11 @@ A data plane node is a single {{site.base_gateway}} instance.
Data plane nodes service traffic for the control plane.

You can deploy your data plane nodes in the following ways:
* **Fully-managed**: Dedicated Cloud Gateways data plane nodes are completely managed by Kong in the cloud provider of your choice. You maintain control over the size and location of the gateway infrastructure, while Kong oversees the management of each instance and the entire cluster for you. You can use the Dedicated Cloud Gateways wizard in Gateway Manager to provision a {{site.base_gateway}} data plane node in a cloud provider.
* **Fully-managed**:
* Dedicated Cloud Gateways data plane nodes are completely managed by Kong in the cloud provider of your choice. You maintain control over the size and location of the gateway infrastructure, while Kong oversees the management of each instance and the entire cluster for you. You can use the Dedicated Cloud Gateways wizard in Gateway Manager to provision a {{site.base_gateway}} data plane node in a cloud provider.

* Serverless Gateways data plane nodes are also completely managed by Kong but all the infrastructure options are abstracted from the user. It is not possible to configure the placement, size, or number of data plane nodes.

* **Self-managed**: The data plane nodes are hosted either on your own systems or in an external cloud provider. You can use the script in Gateway Manager to provision a {{site.base_gateway}} data plane node in a Docker container running Linux, on MacOS, or on Windows.

The following table can help you decide which data plane node strategy to use based on your use case:
Expand All @@ -185,6 +189,7 @@ The following table can help you decide which data plane node strategy to use ba
| Your organization operates in an industry with strict data protection and privacy requirements. | [Dedicated Cloud Gateways](/konnect/gateway-manager/dedicated-cloud-gateways/) | Using the private gateway option, Kong provisions a private network load balancer and only exposes the IP address in the UI. |
| Your organization needs high availability with zero downtime when upgrading data plane nodes. | [Dedicated Cloud Gateways](/konnect/gateway-manager/dedicated-cloud-gateways/) | There's no downtime when upgrading your data plane nodes. Additionally, you can pre-warm your cluster by specifying the number of requests per second so that the first requests don’t have to wait for the infrastructure to scale up. |
| You have infrastructure in multiple clouds. | [Dedicated Cloud Gateways](/konnect/gateway-manager/dedicated-cloud-gateways/) | Dedicated Cloud Gateways allows you to run a multi-cloud solution that allows you to standardize API operations across the board to reduce complexity and increase agility. |
| You need _very_ rapid provisioning for experimentation and sandbox use cases. | [Serverless Gateways](/konnect/gateway-manager/serverless-gateways/) | Serverless Gateways offer sub-minute provisioning times and enable rapid iteration and development lifecycles. |
| You use a cloud provider (other than AWS or Azure) for hosting, or don't want to host in the cloud because of organizational policy. | [Self-managed](/konnect/gateway-manager/data-plane-nodes/) | You can self-manage your data plane nodes in AWS, Azure, and Google Cloud. Or, you can deploy self-managed data plane nodes in macOS, Windows, Linux (Docker), or Kubernetes. |

See the [data plane node installation options](/konnect/gateway-manager/data-plane-nodes/) for more information.
Expand Down
3 changes: 3 additions & 0 deletions app/konnect/gateway-manager/serverless-gateways/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,9 @@
title: Serverless Gateways
---

{:.note}
> **Note:** Serverless Gateways are currently only supported in {{site.konnect_short_name}} Plus. If you are an enterprise tier customer and are interested in Serverless Gateways, please contact your account team.

Serverless gateways are lightweight data plane nodes that are fully managed by Kong in {{site.konnect_short_name}}.

Serverless gateways offer the following benefits:
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,11 @@ This guide explains how to provision a [serverless gateway](/konnect/gateway-man
## Prerequisites

* The following user permissions:
* Control plane admin role for the Dedicated Cloud Gateway control plane
* Control plane admin role for the Serverless control plane
* A Konnect Plus account

{:.note}
> **Note:** Serverless Gateways are currently only supported in {{site.konnect_short_name}} Plus. If you are an enterprise tier customer and are interested in Serverless Gateways, please contact your account team.

## Provision your fully-managed data plane

Expand Down Expand Up @@ -92,6 +96,9 @@ The {{site.konnect_short_name}} API uses [Personal Access Token (PAT)](/konnect/
{% endnavtab %}
{% endnavtabs %}

{:.note}
> **Note:** Serverless Gateways do not currently support the `expressions` router flavor.

## More information

* [Dedicated Cloud Gateways overview](/konnect/gateway-manager/dedicated-cloud-gateways/): Learn more about Dedicated Cloud Gateway features and use cases.