Note: This bug is displayed in read-only format because the product is no longer active in Red Hat Bugzilla.

Bug 1697216

Summary: [DOCS] Correct a annotation for overriding existing cookie name
Product: OpenShift Container Platform Reporter: Daein Park <dapark>
Component: DocumentationAssignee: Vikram Goyal <vigoyal>
Status: CLOSED CURRENTRELEASE QA Contact: Hongan Li <hongli>
Severity: medium Docs Contact: Vikram Goyal <vigoyal>
Priority: unspecified    
Version: 3.11.0CC: aos-bugs, jokerman, mmccomas, wsun
Target Milestone: ---   
Target Release: ---   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: If docs needed, set a value
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2019-04-11 07:45:37 UTC Type: Bug
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:
Embargoed:

Description Daein Park 2019-04-08 06:04:07 UTC
Document URL: 

  Routes
    [ https://docs.openshift.com/container-platform/3.11/dev_guide/routes.html ]

Section Number and Name: 
  Allowing Route Endpoints to Control Cookie Names
    [ https://docs.openshift.com/container-platform/3.11/dev_guide/routes.html#dev-guide-routes-allowing-endpoints-to-control-cookies ]

Describe the issue: 

There are wrong guidance as follows.

[x] $ oc annotate route <route_name> router.openshift.io/<cookie_name>="-<cookie_annotation>"
[o] $ oc annotate route <route_name> router.openshift.io/cookie_name=<custom_cookie_name>

[x] For example, to annotate the cookie name of my_cookie to the my_route with the annotation of my_cookie_anno:
[o] For example, to specify my_cookie as new cookie name:

[x] $ oc annotate route my_route router.openshift.io/my_cookie="-my_cookie_anno"
[o] $ oc annotate route my_route router.openshift.io/cookie_name=my_cookie

Suggestions for improvement: 

correct the annotation name.

Additional information:

Comment 2 Daein Park 2019-04-08 07:07:04 UTC
Additionally if both "insert" and "indirect" options are configured, the cookie will be removed from transmitted request, so "This allows the application receiving route traffic to know the cookie name. " is not true.
The HAProxy session cookie does not been transmitted to the back end Application.