Document URL: https://access.redhat.com/documentation/en/openshift-enterprise/version-3.1/installation-and-configuration/#configuring-ansible Section Number and Name: 2.4.3 Configuring Ansible Describe the issue: All of the example masters for setting up the /etc/ansible/hosts file put the master into the region infra, but this is never used. Suggestions for improvement: Use it in other examples, like putting certain pods into that region, or at least explain the label. Additional information: I have seen plenty of customers that copy and paste our examples, only changing the relevant information, which leads to their master being in the infra region for, seemingly, no reason.
For Docs, The general idea is for Nodes to have a label that signifies the router and registry should be installed on them: https://github.com/openshift/openshift-ansible/blob/master/inventory/byo/hosts.ose.example#L153 Nodes created with a label that matches the setting in that example inventory and ansible is run the default router and registry will be automatically deployed. The default label is 'region=infra'. In all other aspects they are normal Nodes though. They only have the special label since we've found many customers prefer to have the router and registry on specific hosts. This can due to how they are loadbalancing the router or how they want to maintain their Nodes. For example, not all Nodes are running containers that are mission critical. While a Node labeled "dev" might be rebooted or deleted at any time, the "infra" Nodes should be treated with the same care as the rest of the OpenShift infrastructure.
Work in progress: https://github.com/openshift/openshift-docs/pull/1797
Approved by Eric Jones.
Commits pushed to master at https://github.com/openshift/openshift-docs https://github.com/openshift/openshift-docs/commit/3c9339a0c945a4c2a9485e28fa11cc3daf9b2005 Bug 1286858, Documented the infra region https://github.com/openshift/openshift-docs/commit/76d8b72ae2ff9c5ae53feafb2eb4a0de366aba76 Merge pull request #1797 from ahardin-rh/infra-region Bug 1286858, Documented the infra region
Content is now published: https://access.redhat.com/documentation/en/openshift-enterprise/version-3.1/installation-and-configuration/#configuring-ansible https://docs.openshift.com/enterprise/3.1/install_config/install/advanced_install.html#configuring-node-host-labels