Kong Mesh

Kong Konnect Platform
Kong Mesh

Kong Mesh Changelog

1.5.0

Released on 2021/11/22

Changes

Built on top of Kuma 1.4.0

Role-based Access Control (RBAC) is now available.
Support for Windows installation on Universal (VMs) is now available.
Renewable tokens in Vault are now supported.

Upgrading

Starting with this version, the default API server authentication method is user tokens. To continue using client certificates (the previous default method), you’ll need to explicitly set the authentication method to client certificates. This can be done by setting the KUMA_API_SERVER_AUTHN_TYPE variable to "clientCerts".

See the Kuma docs on Configuration - Control plane for how to set this variable.

1.4.1

Released on 2021/10/06

Changes

Built on top of Kuma 1.3.1

Common Name (CN) support for Vault certificate storage is now available.
You can now disable zones as needed.
The number of Postgres connections is now limited to 50 by default. The default value was previously unlimited; you can still configure the limit if needed.
You can now select a specific zone in the Kuma Service dashboard and in the Service to Service dashboard.

Upgrading

Upgrades from 1.4.0 are seamless and no additional steps are needed.

1.4.0

Released on 2021/08/26

Changes

Built on top of Kuma 1.3.0

You can now configure CA rotation in Kong Mesh.
A service map topology view is available that provides visualization of service traffic dependencies.
Support for mutual TLS in permissive mode is available, to support migrating applications into the service mesh.
You can now customize hostnames and ports for data plane proxies with a new virtual outbound policy.
You can more easily specify intermediate CAs with mTLS.

Upgrading

Upgrades from 1.3.0 are seamless, but note the following:

Outbounds generated internally are no longer listed in dataplane.network.outbound[]. On Kubernetes, they are automatically removed. On Universal, to remove them you must recreate your Dataplane resources with kumactl apply. Or, if the proxy lifecycle is managed by Kuma, restart the services.
You may notice some proxies or zones indicated as Offline in the GUI when you upgrade the control plane. This can happen if upgrading all instances of the control plane takes more than five (5) minutes. It’s temporary, and occurs because of a new mechanism for better tracking proxy and zone status. A heartbeat periodically increments the generation counter for Insights. The offline status should disappear after all control plane instances are upgraded to 1.4.0.

1.3.4

Released on 2021/09/15

Built on top of Kuma 1.2.3

Moved to a Kuma fork of go-control-plane that fixes a Goroutine leak

1.3.3

Released on 2021/07/29

Changes

Built on top of Kuma 1.2.3

kumactl now always warns when the client and server versions cannot be confirmed to match.
The data plane proxy type is now checked for a valid value (one of ingress or dataplane).
Improvements to the control plane.

Upgrading

Upgrades from 1.3.0 are seamless and no additional steps are needed.

1.3.2

Released on 2021/07/16

Changes

Built on top of Kuma 1.2.2

Datadog is now available as a traffic tracing option.
Message limit for gRPC stream is increased to better support Kuma discovery service (KDS)
Improved leader election during unexpected failures.
Improved SDS and XDS on rapid DP restarts.
Fixed HDS on the dpserver when bootstrapping an ingress.

Upgrading

Upgrades from 1.3.0 are seamless and no additional steps are needed.

1.3.1

Released on 2021/06/30

Changes

Built on top of Kuma 1.2.1

(Kuma) The data plane proxy now provides an advertised address to the control plane for communication in cases where the address is not directly reachable.
(Kuma) An SNI header is now added when TLS is enabled, to permit communication with external services that require it.
(Kong Mesh only) New parameters pki and role are available for Vault.
(Kong Mesh only) The CNI config name is now always prefixed with kuma-cni.
(Kong Mesh only) TTL is no longer validated for Vault.

Upgrading

Upgrades from 1.3.0 are seamless and no additional steps are needed.

1.3.0

Released on 2021/06/17

Changes

Built on top of Kuma 1.2.0

New L7 Traffic Routing policy to route and modify HTTP traffic per path, method, header, or any other combination, with support for regex. Traffic can be modified before reaching the final destination.
New Rate-Limit policy to protect services from aggressive traffic. This policy can protect from downtime and improve the overall reliability of your applications.
The “Remote” control plane is renamed to “Zone” control plane. This means the “Ingress” resource is renamed “ZoneIngress”. Thanks to community users for providing the feedback that drove this effort.
Traffic Permissions now work with external services.
Improved performance of our DNS resolution.
More improvements, including a fix for GCP/GKE’s erratic IPv6 support.
Updated to Envoy 1.18.3.

Upgrading

For a Universal deployment, see the Kuma upgrade instructions.

For Kubernetes, you should be aware of the following changes:

`kumactl` on Kubernetes

Changes in arguments/flags for kumactl install control-plane:
- --mode now accepts now accepts the values standalone, zone, and global. zone replaces remote, which is still available in earlier versions.
- --tls-kds-remote-client-secret flag is renamed to --tls-kds-zone-client-secret.
Service kong-mesh-global-remote-sync is changed to kong-mesh-global-zone-sync. After you upgrade the global control plane, you must manually remove the old service. For example:
```
 kubectl delete -n kong-mesh-system service/kong-mesh-global-remote-sync 
```
The IP address or hostname that provides the KDS address when you install the control planes can change. Make sure that you update the address when you upgrade the remote control planes to the latest version.

Helm

Changes in values in Kong Mesh’s Helm chart:

kuma.controlPlane.mode now accepts the values standalone, zone, and global. zone replaces remote, which is still available in earlier versions.
kuma.controlPlane.globalRemoteSyncService is renamed to kuma.controlPlane.globalZoneSyncService.
kuma.controlPlane.tls.kdsRemoteClient is renamed to kuma.controlPlane.tls.kdsZoneClient.

1.2.6

Released on 2021/05/13

Changes

Built on top of Kuma 1.1.6.

Intermediate Certificate Authorities (CAs) are now supported with Vault integration.
You can now specify any and all tags in a Traffic Permission policy for Vault integration.
You can now specify TCP and HTTP health checks at the same time in the same policy. The health check policy also now includes a reuse_connection option.
The --gateway flag is now available in the CLI.
You can now install an ingress controller with the CLI. Kong Gateway is the first supported ingress controller.
You can now install the Kuma demo application with the CLI.

Upgrading

Upgrades from 1.2.x are seamless and no additional steps are needed. Note specific configuration requirements for taking advantage of built-in DNS.

1.2.5

Released on 2021/05/05

Changes

Built on top of Kuma 1.1.5.

⚠️ All installation scripts are updated to a new location, because Bintray is shutting down. If you’ve written automation scripts that refer to the Bintray location, you need to update your scripts to point to the new location.
Transparent proxying is improved.
The GUI is improved.
The locality is now always set in a multi-zone deployment.

Upgrading

Upgrades from 1.2.x are seamless and no additional steps are needed. Note specific configuration requirements for taking advantage of built-in DNS.

1.2.4

Released on 2021/04/19

Changes

Built on top of Kuma 1.1.4.

Includes important bug fixes to version 1.1.3 of Kuma, plus improvements to the web UI.

Upgrading

Upgrades from 1.2.x are seamless and no additional steps are needed. Note specific configuration requirements for taking advantage of built-in DNS. See also new documentation for the external service policy.

1.2.3

Released on 2021/04/16

Changes

Built on top of Kuma 1.1.3. Notably:

Built-in DNS provides support for specifying external services by original hostname and port

Upgrading

1.2.2

Released on 2021/04/09

Changes

Built on top of Kuma 1.1.2 with fixes and improvements. Features include:

19 new observability charts and golden metrics.
IPv6 support across the service mesh.
New threshold configuration in the Circuit Breaker policy.
Performance improvements, especially with external services.
Stability improvements to kuma-cp and DNS resolution.

Upgrading

Upgrades from 1.2.0 are seamless and no additional steps are needed.

1.2.1

Released on 2021/03/09

Changes

Fix to include the OPA CRD in the deployment
Build on top of Kuma 1.1.1 with fixes and improvements

Upgrading

Upgrades from 1.2.0 are seamless and no additional steps are needed. When using Helm to upgrade from 1.1.x to 1.2.1, the step to explicitly apply the OPA CRD is not needed anymore.

1.2.0

Released on 2021/03/09

Changes

Added Open Policy Agent integration
Improved authentication support for control planes in multi-zone deployments, with the Kuma Discovery Protocol (KDS)
Added FIPS support to the data plane proxy sidecar
Added XDSv3 for control plane to data plane proxy communication
Build on top of Kuma 1.1.0 with fixes and improvements

Upgrading

Kubernetes with `kumactl`

If you previously installed Kong Mesh with kumactl install control-plane --license-path=... | kubectl apply -f -, you must first uninstall the previous version and then install the new version. All policies are removed when you uninstall, so make sure to back up all related CRDs before you start. Then:

Install Kong Mesh for Kubernetes using kumactl install control-plane ... with any additional command-line arguments you require.

Delete the old Deployment, Service, Webhooks, and Validation hooks:

kubectl delete -n kong-mesh-system deploy/kuma-control-plane
kubectl delete -n kong-mesh-system service/kuma-control-plane
kubectl delete mutatingwebhookconfiguration/kuma-admission-mutating-webhook-configuration
kubectl delete validatingwebhookconfiguration/kuma-validating-webhook-configuration

Restart all the pods in the meshes to make sure the new sidecars are deployed and connected to the newly deployed control plane.

Kubernetes with Helm

The supplied Helm Chart takes care of upgrading the control plane. Because of the way Helm handles CRDs, however, you must apply the new OPA CRD:

Install the new CRD

kubectl apply -f https://docs.konghq.com/mesh/1.2.x/patches/opa-policy.yaml

Upgrade Kong Mesh with Helm:

helm repo update
helm --namespace kong-mesh-system upgrade my-kong-mesh kong-mesh/kong-mesh

Restart all the pods in the meshes to make sure the new sidecars are deployed and connected to the newly deployed control plane.

Kong Mesh Changelog

1.5.0

Changes

Upgrading

1.4.1

Changes

Upgrading

1.4.0

Changes

Upgrading

1.3.4

1.3.3

Changes

Upgrading

1.3.2

Changes

Upgrading

1.3.1

Changes

Upgrading

1.3.0

Changes

Upgrading

kumactl on Kubernetes

Helm

1.2.6

Changes

Upgrading

1.2.5

Changes

Upgrading

1.2.4

Changes

Upgrading

1.2.3

Changes

Upgrading

1.2.2

Changes

Upgrading

1.2.1

Changes

Upgrading

1.2.0

Changes

Upgrading

Kubernetes with kumactl

Kubernetes with Helm

`kumactl` on Kubernetes

Kubernetes with `kumactl`