Browse Source

docs: Consul v1.20 release notes (#21826)

* Page creation

* DNS views description

* Catalog sync and openshift

* Grafana + consul-k8s release notes

* nav update

* Fix known issues language
pull/21833/head
Jeff Boruszak 1 month ago committed by GitHub
parent
commit
7e61148f86
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
  1. 51
      website/content/docs/release-notes/consul-k8s/v1_6_x.mdx
  2. 38
      website/content/docs/release-notes/consul/v1_20_x.mdx
  3. 8
      website/data/docs-nav-data.json

51
website/content/docs/release-notes/consul-k8s/v1_6_x.mdx

@ -0,0 +1,51 @@
---
layout: docs
page_title: 1.6.x
description: >-
Consul on Kubernetes release notes for version 1.6.x
---
# Consul on Kubernetes 1.6.0
We are pleased to announce the following Consul updates.
## Release highlights
- **Consul DNS views for Kubernetes**: Consul on Kubernetes now supports scheduling a dedicated Consul DNS proxy in a Kubernetes Pod instead of using client agents or dataplanes. The proxy is designed for deployment in a Kubernetes cluster with [external servers enabled](/consul/docs/k8s/deployment-configurations/servers-outside-kubernetes) to provide applications in Kubernetes the ability to resolve Consul DNS addresses. You can use the Consul DNS proxy to enable service discovery across admin partitions in Kubernetes deployments. For more information, refer to [Consul DNS views for Kubernetes](/consul/docs/k8s/dns/views).
- **Catalog sync improvements**: Consul v1.20 includes improved metrics for Consul catalog sync. Consul catalog sync is a feature that automatically registers Kubernetes services with Consul’s catalog. Prior to this enhancement, operators had limited visibility into the status of Kubernetes services being synced to Consul and the performance of the sync catalog process. At scale, it was difficult to discern if the sync process was healthy and progressing normally. Catalog sync enhancements now provide more insights that include status and performance metrics of the sync process. New performance metrics include the rate of registered or deregistered services, the status and health of the sync process, and additional metadata related to registered services.
- **OpenShift improvements**: Prior to this release, deploying Consul service mesh on Kubernetes required the transparent proxy to have elevated permissions through `anyuid` security context constraint (SCC) privileges. This requirement prevented users from deploying the transparent proxy in OpenShift environments where elevated pod permissions were prohibited. Consul v1.20 no longer requires elevated permissions for the transparent proxy in OpenShift deployments.
- **Service dashboards for Grafana**: Consul v1.20 includes JSON templates for Grafana dashboards to help you monitor Consul services, service-to-service communication, and Consuld dataplane operations. You can [find these dashboards in the GitHub repo](https://github.com/hashicorp/consul/tree/main/grafana). For more information about configuring Consul to use Grafana, refer to [Configure Metrics for Consul on Kubernetes](/consul/docs/k8s/connect/observability/metrics).
## Supported software
This version of Consul on Kubernetes supports the following software versions:
- Consul v1.20.x
- Consul Dataplane v1.6.x. Refer to [Envoy and Consul Dataplane](/consul/docs/v1.19.x/connect/proxies/envoy#envoy-and-consul-dataplane) for details about Consul Dataplane versions and the available packaged Envoy version.
- Kubernetes 1.28.x - 1.31.x
- kubectl 1.28.x - 1.31.x
- Helm 3.11.3+
Refer to [Supported Consul and Kubernetes versions](/consul/docs/v1.19.x/k8s/compatibility#supported-consul-and-kubernetes-versions) for more information.
## Upgrading
For more detailed information, please refer to the [upgrade details page](/consul/docs/upgrading/upgrade-specific) and the changelogs.
## Known issues
There are no known issues at this time. These release notes are updated as issues are discovered.
[Report issues on Github](https://github.com/hashicorp/consul-k8s/issues).
## Changelogs
The changelogs for this major release version and any maintenance versions are listed below.
<Note> These links take you to the changelogs on the GitHub website. </Note>
- [1.6.0](https://github.com/hashicorp/consul-k8s/releases/tag/v1.6.0)

38
website/content/docs/release-notes/consul/v1_20_x.mdx

@ -0,0 +1,38 @@
---
layout: docs
page_title: 1.20.x
description: >-
Consul release notes for version 1.20.x
---
# Consul 1.20.0
We are pleased to announce the following Consul updates.
## Release highlights
- **Consul DNS views for Kubernetes**: Consul on Kubernetes now supports scheduling a dedicated Consul DNS proxy in a Kubernetes Pod instead of using client agents or dataplanes. The proxy is designed for deployment in a Kubernetes cluster with [external servers enabled](/consul/docs/k8s/deployment-configurations/servers-outside-kubernetes) to provide applications in Kubernetes the ability to resolve Consul DNS addresses. You can use the Consul DNS proxy to enable service discovery across admin partitions in Kubernetes deployments. For more information, refer to [Consul DNS views for Kubernetes](/consul/docs/k8s/dns/views).
- **Catalog sync improvements**: Consul v1.20 includes improved metrics for Consul catalog sync. Consul catalog sync is a feature that automatically registers Kubernetes services with Consul’s catalog. Prior to this enhancement, operators had limited visibility into the status of Kubernetes services being synced to Consul and the performance of the sync catalog process. At scale, it was difficult to discern if the sync process was healthy and progressing normally. Catalog sync enhancements now provide more insights that include status and performance metrics of the sync process. New performance metrics include the rate of registered or deregistered services, the status and health of the sync process, and additional metadata related to registered services.
- **OpenShift improvements**: Prior to this release, deploying Consul service mesh on Kubernetes required the transparent proxy to have elevated permissions through `anyuid` security context constraint (SCC) privileges. This requirement prevented users from deploying the transparent proxy in OpenShift environments where elevated pod permissions were prohibited. Consul v1.20 no longer requires elevated permissions for the transparent proxy in OpenShift deployments.
- **Service dashboards for Grafana**: Consul v1.20 includes JSON templates for Grafana dashboards to help you monitor Consul services, service-to-service communication, and Consuld dataplane operations. You can [find these dashboards in the GitHub repo](https://github.com/hashicorp/consul/tree/main/grafana). For more information about configuring Consul to use Grafana, refer to [Configure Metrics for Consul on Kubernetes](/consul/docs/k8s/connect/observability/metrics).
## Upgrading
For more detailed information, please refer to the [upgrade details page](/consul/docs/upgrading/upgrade-specific) and the changelogs.
## Known issues
There are no known issues at this time. These release notes are updated as issues are discovered.
[Report issues on Github](https://github.com/hashicorp/consul/issues).
## Changelogs
The changelogs for this major release version and any maintenance versions are listed below.
<Note> These links take you to the changelogs on the GitHub website. </Note>
- [1.20.0](https://github.com/hashicorp/consul/releases/tag/v1.20.0)

8
website/data/docs-nav-data.json

@ -153,6 +153,10 @@
{ {
"title": "Consul", "title": "Consul",
"routes": [ "routes": [
{
"title": "v1.20.x",
"path": "release-notes/consul/v1_20_x"
},
{ {
"title": "v1.19.x", "title": "v1.19.x",
"path": "release-notes/consul/v1_19_x" "path": "release-notes/consul/v1_19_x"
@ -202,6 +206,10 @@
{ {
"title": "Consul K8s", "title": "Consul K8s",
"routes": [ "routes": [
{
"title": "v1.6.x",
"path": "release-notes/consul-k8s/v1_6_x"
},
{ {
"title": "v1.5.x", "title": "v1.5.x",
"path": "release-notes/consul-k8s/v1_5_x" "path": "release-notes/consul-k8s/v1_5_x"

Loading…
Cancel
Save