Merge cb2d788 into backport/docs/gh-16779-awareness/publicly-fair-bas…

…ilisk

CHANGELOG.md

@@ -30,6 +30,10 @@ BUG FIXES:
 
 ## 1.15.0 (February 23, 2023)
 
+KNOWN ISSUES:
+
+* connect: A not-consistently-reproducible issue can cause some service instances to lose their ability to communicate in the mesh after 72 hours (LeafCertTTL) due to a problem with leaf certificate rotation. We are working to address this issue in an upcoming patch release. To err on the side of caution, service mesh deployments should not upgrade to Consul 1.15 at this time. Refer to [[GH-16779](https://github.com/hashicorp/consul/issues/16779)] for the latest information.
+
 BREAKING CHANGES:
 
 * acl errors: Delete and get requests now return descriptive errors when the specified resource cannot be found. Other ACL request errors provide more information about when a resource is missing. Add error for when the ACL system has not been bootstrapped. 

website/content/docs/release-notes/consul/v1_15_x.mdx

@@ -66,7 +66,16 @@ For more detailed information, please refer to the [upgrade details page](/consu
 
 ## Known Issues
 
-The following issues are known to exist in the v1.15.0 release:
+The following issues are known to exist in the v1.15 release:
+
+- All current 1.15.x versions are under investigation for a not-consistently-reproducible
+  issue that can cause some service instances to lose their ability to communicate in the mesh after
+  [72 hours (LeafCertTTL)](/consul/docs/connect/ca/consul#leafcertttl)
+  due to a problem with leaf certificate rotation.
+  We will update this section with more information as our investigation continues,
+  including the target availability for a fix.
+  Refer to [Github#16779](https://github.com/hashicorp/consul/issues/16779)
+  for the latest information.
 
 - For v1.15.0, Consul is reporting newer releases of Envoy (for example, v1.25.1) as not supported, even though these versions are listed as valid in the [Envoy compatilibity matrix](/consul/docs/connect/proxies/envoy#envoy-and-consul-client-agent). The following error would result for newer versions of Envoy:
 

website/content/docs/upgrading/upgrade-specific.mdx

@@ -16,6 +16,22 @@ upgrade flow.
 
 ## Consul 1.15.x
 
+#### Service mesh known issue
+
+To err on the side of caution,
+service mesh deployments should not upgrade to Consul 1.15 at this time.
+
+We are currently investigating a not-consistently-reproducible issue that can cause
+some service instances to lose their ability to communicate in the mesh after
+[72 hours (LeafCertTTL)](/consul/docs/connect/ca/consul#leafcertttl)
+due to a problem with leaf certificate rotation.
+We will update this section with more information as our investigation continues,
+including the target availability for a fix.
+
+If you are already operating Consul 1.15, refer to discussion of this issue on
+[Github#16779](https://github.com/hashicorp/consul/issues/16779)
+for potential workarounds and to share your observations.
+
 #### Removing configuration options
 
 The `connect.enable_serverless_plugin` configuration option was removed. Lambda integration is now enabled by default.