chore: add info re: breaking changes in 1.27.x

Author: Katie Horne

changelog/1.27.0.md

@@ -5,7 +5,32 @@ description: "Released on 01/19/2022"
 
 ### Breaking changes ❗
 
-There are no breaking changes in 1.27.0.
+- Users upgrading from Coder v1.21 (or earlier) *must* update their Helm values
+  file to reflect Coder's [updated
+  schema](https://github.com/coder/enterprise-helm/blob/1.27.0/values.yaml).
+  More specifically, users must change the following values:
+
+  - `cemanager` --> `coderd`
+  - `cemanager.replicas` --> `coderd.replicas`
+  - `cemanager.image` --> `coderd.image`
+  - `cemanager.resources` --> `coderd.resources`
+  - `devurls.host` --> `coderd.devurlsHost`
+  - `ingress.loadBalancerIP` --> `coderd.serviceSpec.loadBalancerIP`
+  - `ingress.loadBalancerSourceRanges` --> `coderd.serviceSpec.loadBalancerSourceRanges`
+  - `ingress.service.externalTrafficPolicy` --> `coderd.serviceSpec.externalTrafficPolicy`
+  - `ingress.tls.hostSecretName` --> `coderd.tls.hostSecretName`
+  - `ingress.tls.devurlsHostSecretName` --> `coderd.tls.devurlsHostSecretName`
+  - `storageClassName` --> `postgres.default.storageClassName`
+  - `timescale.image` --> `postgres.default.image`
+  - `timescale.resources` --> `postgres.default.resources`
+  - `timescale.resources.requests.storage` --> `postgres.default.resources.requests.storage`
+  - `postgres.useDefault` --> `postgres.default.enable`
+  - `deploymentAnnotations` --> `services.annotations`
+  - `serviceTolerations` --> `services.tolerations`
+  - `clusterDomainSuffix` --> `services.clusterDomainSuffix`
+  - `serviceType` --> `services.type`
+  - `serviceAccount.annotations` --> `coderd.builtinProviderServiceAccount.annotations`
+  - `serviceAccount.labels` --> `coderd.builtinProviderServiceAccount.labels`
 
 ### Features ✨
 

changelog/1.27.1.md

@@ -5,7 +5,32 @@ description: "Released on 01/31/2022"
 
 ### Breaking changes ❗
 
-There are no breaking changes in 1.27.1.
+- Users upgrading from Coder v1.21 (or earlier) *must* update their Helm values
+  file to reflect Coder's [updated
+  schema](https://github.com/coder/enterprise-helm/blob/1.27.0/values.yaml).
+  More specifically, users must change the following values:
+
+  - `cemanager` --> `coderd`
+  - `cemanager.replicas` --> `coderd.replicas`
+  - `cemanager.image` --> `coderd.image`
+  - `cemanager.resources` --> `coderd.resources`
+  - `devurls.host` --> `coderd.devurlsHost`
+  - `ingress.loadBalancerIP` --> `coderd.serviceSpec.loadBalancerIP`
+  - `ingress.loadBalancerSourceRanges` --> `coderd.serviceSpec.loadBalancerSourceRanges`
+  - `ingress.service.externalTrafficPolicy` --> `coderd.serviceSpec.externalTrafficPolicy`
+  - `ingress.tls.hostSecretName` --> `coderd.tls.hostSecretName`
+  - `ingress.tls.devurlsHostSecretName` --> `coderd.tls.devurlsHostSecretName`
+  - `storageClassName` --> `postgres.default.storageClassName`
+  - `timescale.image` --> `postgres.default.image`
+  - `timescale.resources` --> `postgres.default.resources`
+  - `timescale.resources.requests.storage` --> `postgres.default.resources.requests.storage`
+  - `postgres.useDefault` --> `postgres.default.enable`
+  - `deploymentAnnotations` --> `services.annotations`
+  - `serviceTolerations` --> `services.tolerations`
+  - `clusterDomainSuffix` --> `services.clusterDomainSuffix`
+  - `serviceType` --> `services.type`
+  - `serviceAccount.annotations` --> `coderd.builtinProviderServiceAccount.annotations`
+  - `serviceAccount.labels` --> `coderd.builtinProviderServiceAccount.labels`
 
 ### Features ✨