From 0b9ec4152b263d4b7972f57a654c59d65912bae5 Mon Sep 17 00:00:00 2001 From: John Harris Date: Wed, 23 Oct 2024 14:20:01 -0700 Subject: [PATCH 1/4] fix: tidy some serverless docs Signed-off-by: John Harris --- app/konnect/gateway-manager/index.md | 9 +++++++-- app/konnect/gateway-manager/serverless-gateways/index.md | 3 +++ .../serverless-gateways/provision-serverless-gateway.md | 9 ++++++++- 3 files changed, 18 insertions(+), 3 deletions(-) diff --git a/app/konnect/gateway-manager/index.md b/app/konnect/gateway-manager/index.md index 7db206b891f..c9643661acc 100644 --- a/app/konnect/gateway-manager/index.md +++ b/app/konnect/gateway-manager/index.md @@ -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 @@ -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: @@ -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. diff --git a/app/konnect/gateway-manager/serverless-gateways/index.md b/app/konnect/gateway-manager/serverless-gateways/index.md index 167a2c1bab7..65889102e56 100644 --- a/app/konnect/gateway-manager/serverless-gateways/index.md +++ b/app/konnect/gateway-manager/serverless-gateways/index.md @@ -2,6 +2,9 @@ title: Serverless Gateways --- +{:.note} +**Note:** Serverless Gateways are currently only supported in {{site.konnect_short_name}} Plus. If you are 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: diff --git a/app/konnect/gateway-manager/serverless-gateways/provision-serverless-gateway.md b/app/konnect/gateway-manager/serverless-gateways/provision-serverless-gateway.md index f5e4798b2a9..38ba4b8d9d2 100644 --- a/app/konnect/gateway-manager/serverless-gateways/provision-serverless-gateway.md +++ b/app/konnect/gateway-manager/serverless-gateways/provision-serverless-gateway.md @@ -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 enterprise tier customer and are interested in Serverless Gateways, please contact your account team. ## Provision your fully-managed data plane @@ -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. \ No newline at end of file From 5062a59471caa7d28c8e8a6295cb08825a9fcec9 Mon Sep 17 00:00:00 2001 From: John Harris Date: Wed, 23 Oct 2024 22:50:16 -0700 Subject: [PATCH 2/4] Update app/konnect/gateway-manager/serverless-gateways/index.md Co-authored-by: lena-larionova <54370747+lena-larionova@users.noreply.github.com> --- app/konnect/gateway-manager/serverless-gateways/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/app/konnect/gateway-manager/serverless-gateways/index.md b/app/konnect/gateway-manager/serverless-gateways/index.md index 65889102e56..1787eaa9f13 100644 --- a/app/konnect/gateway-manager/serverless-gateways/index.md +++ b/app/konnect/gateway-manager/serverless-gateways/index.md @@ -3,7 +3,7 @@ title: Serverless Gateways --- {:.note} -**Note:** Serverless Gateways are currently only supported in {{site.konnect_short_name}} Plus. If you are enterprise tier customer and are interested in Serverless Gateways, please contact your account team. +> **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}}. From ff3fec326f48eb1ced087ff3f002071ff140b88c Mon Sep 17 00:00:00 2001 From: John Harris Date: Wed, 23 Oct 2024 22:50:28 -0700 Subject: [PATCH 3/4] Update app/konnect/gateway-manager/serverless-gateways/provision-serverless-gateway.md Co-authored-by: lena-larionova <54370747+lena-larionova@users.noreply.github.com> --- .../serverless-gateways/provision-serverless-gateway.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/app/konnect/gateway-manager/serverless-gateways/provision-serverless-gateway.md b/app/konnect/gateway-manager/serverless-gateways/provision-serverless-gateway.md index 38ba4b8d9d2..bd10fcfa852 100644 --- a/app/konnect/gateway-manager/serverless-gateways/provision-serverless-gateway.md +++ b/app/konnect/gateway-manager/serverless-gateways/provision-serverless-gateway.md @@ -97,7 +97,7 @@ The {{site.konnect_short_name}} API uses [Personal Access Token (PAT)](/konnect/ {% endnavtabs %} {:.note} -**Note:** Serverless Gateways do not currently support the `expressions` router flavor. +> **Note:** Serverless Gateways do not currently support the `expressions` router flavor. ## More information From e079fe0ee86f4d8002b9f0b903c1b9224237b48b Mon Sep 17 00:00:00 2001 From: John Harris Date: Wed, 23 Oct 2024 22:50:39 -0700 Subject: [PATCH 4/4] Update app/konnect/gateway-manager/serverless-gateways/provision-serverless-gateway.md Co-authored-by: lena-larionova <54370747+lena-larionova@users.noreply.github.com> --- .../serverless-gateways/provision-serverless-gateway.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/app/konnect/gateway-manager/serverless-gateways/provision-serverless-gateway.md b/app/konnect/gateway-manager/serverless-gateways/provision-serverless-gateway.md index bd10fcfa852..9905c68af30 100644 --- a/app/konnect/gateway-manager/serverless-gateways/provision-serverless-gateway.md +++ b/app/konnect/gateway-manager/serverless-gateways/provision-serverless-gateway.md @@ -11,7 +11,7 @@ This guide explains how to provision a [serverless gateway](/konnect/gateway-man * A Konnect Plus account {:.note} -**Note:** Serverless Gateways are currently only supported in {{site.konnect_short_name}} Plus. If you are enterprise tier customer and are interested in Serverless Gateways, please contact your account team. +> **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