Bug 1326064

Summary: [DOCS] Document selection of kubeproxy mode (userspace / iptables)
Product: OpenShift Container Platform Reporter: Alex Dellapenta <adellape>
Component: DocumentationAssignee: Alex Dellapenta <adellape>
Status: CLOSED CURRENTRELEASE QA Contact: Vikram Goyal <vigoyal>
Severity: medium Docs Contact: Vikram Goyal <vigoyal>
Priority: low    
Version: 3.1.0CC: aos-bugs, jokerman, mmccomas
Target Milestone: ---   
Target Release: ---   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2017-12-31 00:35:28 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:

Description Alex Dellapenta 2016-04-11 17:11:24 UTC 
Introduced to the installer in:

https://github.com/openshift/openshift-ansible/pull/1363

From origin:

https://github.com/openshift/origin/pull/7088
https://github.com/openshift/origin/issues/6908

Kube docs re: proxy modes:

http://kubernetes.io/docs/user-guide/services/#virtual-ips-and-service-proxies
http://kubernetes.io/docs/user-guide/debugging-services/#is-kube-proxy-writing-iptables-rules
http://kubernetes.io/docs/admin/kube-proxy/

We should add openshift_node_proxy_mode to:

https://docs.openshift.com/enterprise/latest/install_config/install/advanced_install.html#configuring-ansible

And mention why you might use one vs the other. Also maybe add mention somewhere like:

https://docs.openshift.com/enterprise/3.1/admin_guide/manage_nodes.html
https://docs.openshift.com/enterprise/3.1/architecture/additional_concepts/networking.html

Requested by Erik Jacobs in #aos:

<ejacobs> alexd: ping ^^ see sdodson comment about docs. we probably need to document the behavior of switching the service implementation
Comment 1 Alex Dellapenta 2016-04-11 18:01:08 UTC 
WIP PR: https://github.com/openshift/openshift-docs/pull/1882
Comment 2 Vikram Goyal 2017-12-31 00:35:28 UTC 
This was merged here: https://github.com/openshift/openshift-docs/pull/1948

Closing this bug.