docs(proto): fixed default serviceAddress and upgrade docs

UPGRADE.md

@@ -61,7 +61,10 @@ changed to agree with the other `image` values.
 * The `/versions` endpoint was removed. This is not something that was reliable enough and version compatibility
 is checked inside the DP
 * We are deprecating `kuma.io/builtindns` and `kuma.io/builtindnsport` annotations in favour of the clearer `kuma.io/builtin-dns` and `kuma.io/builtin-dns-port`. The behavior of the new annotations is unchanged but you should migrate (a warning is present on the log if you are using the deprecated version).
-* Applications that are binding to `localhost` won't be reachable anymore. We are changing the default inbound cluster that was always pointing to `localhost` to `DataplaneIP`. Before upgrade check if your applications are listening on `localhost` and should be exposed. In this case change address on which application listen to `0.0.0.0`. Other option is to define `dataplane.networking.inbound[].serviceAddress` to the address which service is binding. Another way is to disable the new behavior by setting `kuma-cp` configuration `KUMA_DEFAULTS_ENABLE_LOCALHOST_INBOUND_CLUSTERS` to `true` or `defaults.enableLocalhostInboundClusters` to `true`. The last option is going to be removed in further versions.
+* Applications that are binding to `localhost` won't be reachable anymore. We are changing the default inbound cluster that was always pointing to `localhost` to `DataplaneIP`. Before upgrade check if your applications are listening on `localhost` and should be exposed:
+  * Universal: If you don't want to expose application change binding to `127.0.0.1` and define `dataplane.networking.inbound[].serviceAddress: "127.0.0.1"`.
+  * Kubernetes: In this case change address on which application listen to `0.0.0.0`.
+Another way is to disable the new behavior by setting `kuma-cp` configuration `KUMA_DEFAULTS_ENABLE_LOCALHOST_INBOUND_CLUSTERS` to `true` or `defaults.enableLocalhostInboundClusters` to `true`. The last option is going to be removed in further versions.
 
 ## Upgrade to `1.7.x`
 

api/mesh/v1alpha1/dataplane.proto

@@ -65,8 +65,9 @@ message Dataplane {
       uint32 servicePort = 4;
 
       // Address of the service that requests will be forwarded to.
-      // Defaults to '127.0.0.1', since Kuma DP should be deployed next to the
-      // service.
+      // Defaults to 'DataplaneIP', since Kuma DP should be deployed next to the
+      // service. When `KUMA_DEFAULTS_ENABLE_LOCALHOST_INBOUND_CLUSTERS` is true
+      // defaults to `127.0.0.1`.
       string serviceAddress = 6;
 
       // Address on which inbound listener will be exposed.

docs/generated/resources/proxy_dataplane.md

@@ -76,8 +76,9 @@
         - `serviceAddress` (optional)
 
             Address of the service that requests will be forwarded to.
-            Defaults to '127.0.0.1', since Kuma DP should be deployed next to the
-            service.    
+            Defaults to 'DataplaneIP', since Kuma DP should be deployed next to the
+            service. When `KUMA_DEFAULTS_ENABLE_LOCALHOST_INBOUND_CLUSTERS` is true
+            defaults to `127.0.0.1`.    
 
         - `address` (optional)