Deploy a data plane
Uses:
Kong Operator
Incompatible with
on-prem
Related Documentation
TL;DR
Create a DataPlane object and use the KonnectExtension reference.
Prerequisites
Kong Konnect
If you don’t have a Konnect account, you can get started quickly with our onboarding wizard.
- The following Konnect items are required to complete this tutorial:
- Personal access token (PAT): Create a new personal access token by opening the Konnect PAT page and selecting Generate Token.
-
Set the personal access token as an environment variable:
export KONNECT_TOKEN='YOUR KONNECT TOKEN'Copied!
Create a KonnectExtension resource
echo '
kind: KonnectExtension
apiVersion: konnect.konghq.com/v1alpha2
metadata:
name: my-konnect-config
namespace: kong
spec:
clientAuth:
certificateSecret:
provisioning: Automatic
konnect:
controlPlane:
ref:
type: konnectNamespacedRef
konnectNamespacedRef:
name: gateway-control-plane' | kubectl apply -f -
Copied!
Create the data plane
Configure a Kong DataPlane by using your KonnectExtension reference:
echo '
apiVersion: gateway-operator.konghq.com/v1beta1
kind: DataPlane
metadata:
name: dataplane-example
namespace: kong
spec:
extensions:
- kind: KonnectExtension
name: my-konnect-config
group: konnect.konghq.com
deployment:
podTemplateSpec:
spec:
containers:
- name: proxy
image: kong/kong-gateway:3.13
' | kubectl apply -f -
Copied!
Check the Ready status
You can verify the DataPlane was reconciled successfully by checking its Ready condition.
kubectl get -n kong dataplane dataplane-example \
-o=jsonpath='{.status.conditions[?(@.type=="Ready")]}' | jq
Copied!
The output should look similar to this:
{
"observedGeneration": 1,
"reason": "Ready",
"status": "True",
"type": "Ready"
}
Copied!
If the DataPlane has Ready condition set to True then you can visit Konnect and see the dataplane in the list of connected data planes for your control plane.