diff --git a/dev_guide/routes.adoc b/dev_guide/routes.adoc index 7486fcee4f33..4e13b1fb957b 100644 --- a/dev_guide/routes.adoc +++ b/dev_guide/routes.adoc @@ -287,22 +287,20 @@ router which endpoint is handling the session, ensuring that client requests use the cookie so that they are routed to the same pod. You can set a cookie name to overwrite the default, auto-generated one for the -route. This allows the application receiving route traffic to know the cookie -name. By deleting the cookie it can force the next request to re-choose an +route. By deleting the cookie it can force the next request to re-choose an endpoint. So, if a server was overloaded it tries to remove the requests from the client and redistribute them. . Annotate the route with the desired cookie name: + ---- -$ oc annotate route router.openshift.io/="-" +$ oc annotate route router.openshift.io/cookie_name="" ---- + -For example, to annotate the cookie name of `my_cookie` to the `my_route` with -the annotation of `my_cookie_anno`: +For example, to specify `my_cookie` as your new cookie name: + ---- -$ oc annotate route my_route router.openshift.io/my_cookie="-my_cookie_anno" +$ oc annotate route my_route router.openshift.io/cookie_name="my_cookie" ---- . Save the cookie, and access the route: