Upgrade a Data Plane Node to a New Version

1. In Gateway Manager, select the Dedicated Cloud Gateways powered control plane you want to upgrade the data plane nodes for.
2. From the Actions menu, select Edit or Resize Cluster.
3. Select the desired Kong Gateway version, and click Update Cluster.

Konnect will upgrade the version of all the data plane nodes to the version you selected automatically.

Kong performs a rolling upgrade of the fully-managed data plane nodes. This is a zero downtime upgrade because Kong synchronizes the data plane with load balancer registration and de-registration and gracefully terminates the old data plane nodes to reduce the impact on the ongoing traffic.

Using the control-plane-id for the data plane group you want to upgrade, you can upgrade via the API by following these steps:

1. Send a GET request to the /cloud-gateway/networks/ endpoint, the response will contain a list of all the active Cloud Gateway networks.

    curl --request GET \
    --url https://us.api.konghq.com/v2/cloud-gateways/networks \
    --header 'Authorization: Bearer kpat_iIGUb6bPml2G6WUSPnZMLdty6pwgUf8GIJbSlBlasg6w4y1cS'
   

2. From the response body save the cloud_gateway_network_id, control_plane_id.

3. Construct and send a POST request to /cloud-gateways/configurations, using both the control_plane_id, cloud_gateway_network_id, and the desired version:

    curl --request PUT \
    --url https://{region}.api.konghq.com/v2/cloud-gateways/configurations \
    --header 'Authorization: Bearer BEARER_TOKEN' \
    --data '{
    "control_plane_id": "CONTROL_PLANE_ID",
    "version": "DESIRED_VERSION",
        "control_plane_geo": "GEO_LOCATION",
    "dataplane_groups": [
        {
        "provider": "aws",
        "region": "REGION",
        "cloud_gateway_network_id": "CLOUD_GATEWAY_NETWORK_ID",
        "autoscale": {
                "kind": "autopilot",
                            "base_rps": 100
            }
        }
    ]
    }'
   

Replace BEARER_TOKEN, CONTROL_PLANE_ID, DESIRED_VERSION, GEO_LOCATION, REGION, and CLOUD_GATEWAY_NETWORK_ID with your specific details.

Konnect will upgrade the version of all the data plane nodes to the version you selected automatically, the response body will contain information about the data plane group, including the version.

Kong performs a rolling upgrade of the fully-managed data plane nodes. This is a zero downtime upgrade because Kong synchronizes the data plane with load balancer registration and de-registration and gracefully terminates the old data plane nodes to reduce the impact on the ongoing traffic.