From 70d56ad7bcb23804185937d3fc423fb0c846c593 Mon Sep 17 00:00:00 2001
From: Robert Bailey <robertbailey@google.com>
Date: Mon, 11 Oct 2021 21:23:20 -0700
Subject: [PATCH] Add some extra emphasis on the breaking change in the helm
 parameters (#2305)

related to the allocator service.
---
 site/content/en/blog/releases/1.18.0-rc.md         | 4 +++-
 site/content/en/docs/Advanced/allocator-service.md | 7 +++++++
 2 files changed, 10 insertions(+), 1 deletion(-)

diff --git a/site/content/en/blog/releases/1.18.0-rc.md b/site/content/en/blog/releases/1.18.0-rc.md
index fe29f47003..9324f3a38e 100644
--- a/site/content/en/blog/releases/1.18.0-rc.md
+++ b/site/content/en/blog/releases/1.18.0-rc.md
@@ -10,13 +10,15 @@ This release fixes a gRPC compatibility issue in the allocator service introduce
 
 The `RollingUpdateOnReady` feature have graduated to stable! And the new alpha feature `SDKGracefulTermination` makes Agones work better with preemptible VMs.
 
-Some helm parameters related to the allocator service were renamed to make them more consistent. If you were setting any of those values you will need to modify your helm scripts to use the new parameters.
+**Note**: Some helm parameters related to the allocator service were renamed to make them more consistent. In particular, if you were setting the `agones.allocator.http.loadBalancerIP` so that helm would automatically set up the server certificate, the parameter has been renamed to `agones.allocator.service.loadBalancerIP`. If you were setting this or any other parameters for the allocator service please check your helm scripts and ensure that you are using the new parameters.
 
 Check the <a href="https://github.com/googleforgames/agones/tree/release-1.18.0-rc" data-proofer-ignore>README</a> for details on features, installation and usage.
 
 **Breaking changes:**
 
 - Allow the ports for gRPC and REST to be configured for the allocator service [\#2272](https://github.com/googleforgames/agones/pull/2272) ([roberthbailey](https://github.com/roberthbailey))
+- Changed helm parameters used to configure the allocator service [\#2272](https://github.com/googleforgames/agones/pull/2272) ([roberthbailey](https://github.com/roberthbailey))
+
 
 **Implemented enhancements:**
 
diff --git a/site/content/en/docs/Advanced/allocator-service.md b/site/content/en/docs/Advanced/allocator-service.md
index 39c50ae2d1..89a79f5320 100644
--- a/site/content/en/docs/Advanced/allocator-service.md
+++ b/site/content/en/docs/Advanced/allocator-service.md
@@ -77,6 +77,13 @@ helm upgrade --install --wait \
    ...
 ```
 
+{{< alert title="Warning" color="warning">}} The parameter used to automatically
+replace the certifate changed in Agones 1.18.0. If you are using an older
+version of Agones you should pass the parameter
+`agones.allocator.http.loadBalancerIP` instead. If you need your script to work
+with both older and newer versions of Agones, you can pass both parameters as
+only one of them will effect the helm chart templates.
+
 {{% /feature %}}
 
 Another approach is to replace the default server TLS certificate with a certificate with CN and subjectAltName. There are multiple approaches to generate a certificate. Agones recommends using [cert-manager.io](https://cert-manager.io/) solution for cluster level certificate management.