From 89a3480ff61d20b98964e1c342d58de24d203653 Mon Sep 17 00:00:00 2001 From: boruszak Date: Wed, 9 Oct 2024 18:50:46 +0000 Subject: [PATCH 1/6] backport of commit 6206dc5dcbbdc8fabd643ef6283d2b113df37d41 --- .../docs/release-notes/consul/v1_20_x.mdx | 38 +++++++++++++++++++ website/data/docs-nav-data.json | 4 ++ 2 files changed, 42 insertions(+) create mode 100644 website/content/docs/release-notes/consul/v1_20_x.mdx diff --git a/website/content/docs/release-notes/consul/v1_20_x.mdx b/website/content/docs/release-notes/consul/v1_20_x.mdx new file mode 100644 index 000000000000..735c9ca40b20 --- /dev/null +++ b/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**: + +- **Service catalog improvements**: + +## What's deprecated + +- + +## Upgrading + +For more detailed information, please refer to the [upgrade details page](/consul/docs/upgrading/upgrade-specific) and the changelogs. + +## Known issues + +The following issues are known to exist in the v1.20.x releases: + +- + +## Changelogs + +The changelogs for this major release version and any maintenance versions are listed below. + + These links take you to the changelogs on the GitHub website. + +- [1.20.0](https://github.com/hashicorp/consul/releases/tag/v1.20.0) diff --git a/website/data/docs-nav-data.json b/website/data/docs-nav-data.json index 8af621f8d344..a97862ea3669 100644 --- a/website/data/docs-nav-data.json +++ b/website/data/docs-nav-data.json @@ -153,6 +153,10 @@ { "title": "Consul", "routes": [ + { + "title": "v1.20.x", + "path": "release-notes/consul/v1_20_x" + }, { "title": "v1.19.x", "path": "release-notes/consul/v1_19_x" From 92ccb7f0379363f6eb52c310775b32e00d872f8a Mon Sep 17 00:00:00 2001 From: boruszak Date: Mon, 14 Oct 2024 19:28:00 +0000 Subject: [PATCH 2/6] backport of commit 859ef870681f71b6d9b2a6d6ce4d273a8702af87 --- website/content/docs/release-notes/consul/v1_20_x.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/content/docs/release-notes/consul/v1_20_x.mdx b/website/content/docs/release-notes/consul/v1_20_x.mdx index 735c9ca40b20..a9aaaa8580b6 100644 --- a/website/content/docs/release-notes/consul/v1_20_x.mdx +++ b/website/content/docs/release-notes/consul/v1_20_x.mdx @@ -11,7 +11,7 @@ We are pleased to announce the following Consul updates. ## Release highlights -- **Consul DNS views for Kubernetes**: +- **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). - **Service catalog improvements**: From ecc9afe084c2e68b8bf89bcfd48dc639117aa41f Mon Sep 17 00:00:00 2001 From: boruszak Date: Tue, 15 Oct 2024 18:20:05 +0000 Subject: [PATCH 3/6] backport of commit a3996a73fb172cb0154140601e6370d4d2fe0f48 --- website/content/docs/release-notes/consul/v1_20_x.mdx | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/website/content/docs/release-notes/consul/v1_20_x.mdx b/website/content/docs/release-notes/consul/v1_20_x.mdx index a9aaaa8580b6..0778556178f2 100644 --- a/website/content/docs/release-notes/consul/v1_20_x.mdx +++ b/website/content/docs/release-notes/consul/v1_20_x.mdx @@ -13,7 +13,9 @@ We are pleased to announce the following Consul updates. - **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). -- **Service catalog improvements**: +- **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. ## What's deprecated From b96192be79667c36518b0f2a0036e9c1356d23d2 Mon Sep 17 00:00:00 2001 From: boruszak Date: Tue, 15 Oct 2024 18:29:47 +0000 Subject: [PATCH 4/6] backport of commit e90acfe67b4b4bf011904520ff84a9be63915b0e --- .../docs/release-notes/consul-k8s/v1_6_x.mdx | 49 +++++++++++++++++++ .../docs/release-notes/consul/v1_20_x.mdx | 2 + 2 files changed, 51 insertions(+) create mode 100644 website/content/docs/release-notes/consul-k8s/v1_6_x.mdx diff --git a/website/content/docs/release-notes/consul-k8s/v1_6_x.mdx b/website/content/docs/release-notes/consul-k8s/v1_6_x.mdx new file mode 100644 index 000000000000..4882121a80f5 --- /dev/null +++ b/website/content/docs/release-notes/consul-k8s/v1_6_x.mdx @@ -0,0 +1,49 @@ +--- +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 + +The following issues are known to exist in the v1.6.x releases: + +## Changelogs + +The changelogs for this major release version and any maintenance versions are listed below. + + These links take you to the changelogs on the GitHub website. + +- [1.6.0](https://github.com/hashicorp/consul-k8s/releases/tag/v1.6.0) diff --git a/website/content/docs/release-notes/consul/v1_20_x.mdx b/website/content/docs/release-notes/consul/v1_20_x.mdx index 0778556178f2..60f9cbed7d17 100644 --- a/website/content/docs/release-notes/consul/v1_20_x.mdx +++ b/website/content/docs/release-notes/consul/v1_20_x.mdx @@ -17,6 +17,8 @@ We are pleased to announce the following Consul updates. - **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). + ## What's deprecated - From 95a10838e6a1e71b0795223fdda09f62605f4998 Mon Sep 17 00:00:00 2001 From: boruszak Date: Tue, 15 Oct 2024 18:45:40 +0000 Subject: [PATCH 5/6] backport of commit f28872381fb23c8e8e02a9e188653c8335e8d513 --- website/data/docs-nav-data.json | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/website/data/docs-nav-data.json b/website/data/docs-nav-data.json index a97862ea3669..b416e7b645d3 100644 --- a/website/data/docs-nav-data.json +++ b/website/data/docs-nav-data.json @@ -206,6 +206,10 @@ { "title": "Consul K8s", "routes": [ + { + "title": "v1.6.x", + "path": "release-notes/consul-k8s/v1_6_x" + }, { "title": "v1.5.x", "path": "release-notes/consul-k8s/v1_5_x" From bcb37adfd79a23ffcf1753d59816a3e59d0158ff Mon Sep 17 00:00:00 2001 From: boruszak Date: Tue, 15 Oct 2024 23:28:13 +0000 Subject: [PATCH 6/6] backport of commit 59c5b3023ed289f9e13d6e739d74322bc1a7809d --- website/content/docs/release-notes/consul-k8s/v1_6_x.mdx | 4 +++- website/content/docs/release-notes/consul/v1_20_x.mdx | 8 ++------ 2 files changed, 5 insertions(+), 7 deletions(-) diff --git a/website/content/docs/release-notes/consul-k8s/v1_6_x.mdx b/website/content/docs/release-notes/consul-k8s/v1_6_x.mdx index 4882121a80f5..98aab6df59ed 100644 --- a/website/content/docs/release-notes/consul-k8s/v1_6_x.mdx +++ b/website/content/docs/release-notes/consul-k8s/v1_6_x.mdx @@ -38,7 +38,9 @@ For more detailed information, please refer to the [upgrade details page](/consu ## Known issues -The following issues are known to exist in the v1.6.x releases: +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 diff --git a/website/content/docs/release-notes/consul/v1_20_x.mdx b/website/content/docs/release-notes/consul/v1_20_x.mdx index 60f9cbed7d17..17e19a3de573 100644 --- a/website/content/docs/release-notes/consul/v1_20_x.mdx +++ b/website/content/docs/release-notes/consul/v1_20_x.mdx @@ -19,19 +19,15 @@ We are pleased to announce the following Consul updates. - **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). -## What's deprecated - -- - ## Upgrading For more detailed information, please refer to the [upgrade details page](/consul/docs/upgrading/upgrade-specific) and the changelogs. ## Known issues -The following issues are known to exist in the v1.20.x releases: +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