このページは、まだ日本語ではご利用いただけません。翻訳中です。
Provision a Serverless Gateway
This guide explains how to provision a serverless gateway in Konnect.
Prerequisites
- The following user permissions:
- Control plane admin role for the Serverless control plane
- A Konnect Plus account
Note: Serverless Gateways are currently only supported in Konnect 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
-
From Gateway Manager, click the New Gateway button and select Serverless.
-
Enter a name, optionally a description or label, for your serverless gateway and click Create.
Your serverless gateway is now provisioned with the data plane attached. You can use it like you would any other Kong Gateway in Konnect.
The URL where your serverless gateway can be accessed is shown in the Overview
section of the Control Plane page.
The Konnect API uses Personal Access Token (PAT) authentication. You can obtain your PAT from the personal access token page. The PAT must be passed in the Authorization
header of all requests.
- Create a serverless gateway control plane using the
/control-planes
endpoint:
curl --request POST \
--url https://{region}.api.konghq.com/v2/control-planes \
--header 'Authorization: Bearer <personal-access-token>' \
--header 'Content-Type: application/json' \
--data '{
"name": "serverless-gateway-control-plane",
"description": "A test control plane for Serverless Gateways.",
"cluster_type": "CLUSTER_TYPE_SERVERLESS",
"cloud_gateway": false,
"auth_type": "pinned_client_certs"
}'
Replace the PAT as well as the following placeholders with your own values:
-
name
: The name that you want to display for the serverless gateway control plane.
-
description
: Description of the serverless gateway control plane.
You should get a 201
response like the following:
{
"id": "23be21c0-5984-4698-aa1f-ac258d77f0d1",
"name": "serverless-gateway-control-plane",
"description": "A test control plane for Serverless Gateways.",
"labels": {},
"config": {
"control_plane_endpoint": "https://52ec253413.cp0.konghq.tech",
"telemetry_endpoint": "https://52ec253413.tp0.konghq.tech",
"cluster_type": "CLUSTER_TYPE_SERVERLESS",
"auth_type": "pinned_client_certs",
"cloud_gateway": false,
"proxy_urls": []
},
"created_at": "2024-10-15T21:25:29.376Z",
"updated_at": "2024-10-15T21:25:29.376Z"
}
Save the control plane id
to use in the next step.
-
Create a Dedicated Cloud Gateway data plane using the /cloud-gateways/configurations
endpoint:
curl --request PUT \
--url https://global.api.konghq.com/v3/cloud-gateways/configurations \
--header 'Authorization: Bearer <personal-access-token>' \
--header 'Content-Type: application/json' \
--data '{
"control_plane_id": "23be21c0-5984-4698-aa1f-ac258d77f0d1",
"control_plane_geo": "us",
"dataplane_groups": [
{
"region": "na"
}
],
"kind": "serverless.v0"
}'
Replace the PAT as well as the following placeholders with your own values:
-
control_plane_id
: The ID of the control plane you created in the previous step.
-
control_plane_geo
: The geo of the control plane.
-
region
: The region you want to deploy the data plane in.
Note: The Serverless Gateway data plane can only be provisioned in the na
, eu
, or au
regions. However your data plane and control plane regions can be different (e.g. it’s possible to attach an eu
data plane to an me
control plane.)
You should get a 201
response which means your serverless gateway is now provisoned. You can use it like you would any other Kong Gateway in Konnect.
Note: Serverless Gateways do not currently support the expressions
router flavor.