Red Hat Bugzilla – Bug 1461949
[DOCS] Guide fails to provide guidance on critical setup parameter
Last modified: 2017-11-13 15:23:58 EST
This guide: https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux_atomic_host/7/html-single/getting_started_with_kubernetes/ Assumes a network configuration for the kubernetes cluster w/o giving any guidance or even pointing out that parameters may be different in the user's setup. Specifically the guide instructs the user to create an apiserver-pod.json file to configure the api server to serve applications via the cluster-ip-range 10.254.0.0/16 without giving information about how to set up such network or what other options should be used. After the guide is run through the user is stuck not being able to test if the containers are working because no such network has been created/is routed to the client.
The IP address range identified with service-cluster-ip-range is used internally by Kubernetes to assign addresses to services used on each Kubernetes node. I added a description of that option to the guide. It is scheduled to be published with RHEL/Atomic 7.4.2 on 10/17/2017.
The update has been published. Look for the note in this section: https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux_atomic_host/7/html/getting_started_with_kubernetes/get_started_orchestrating_containers_with_kubernetes#starting_kubernetes