Document URL: https://docs.openshift.com/enterprise/3.2/install_config/storage_examples/gluster_example.html The above is for the 3.2 docs, but it affects 3.3 as well. Section Number and Name: Creating the Gluster Endpoints and Gluster Service for Persistence Describe the issue: The examples state, in the yaml: -for the endpoints: metadata: name: gluster-endpoints -for the service: metadata: name: gluster-service However, according to the general directions for Gluster storage on OpenShift (https://docs.openshift.com/enterprise/3.2/install_config/persistent_storage/persistent_storage_glusterfs.html), the name field in endpoints and in service need to be the *same*. Our examples should be consistent throughout so that they are more easily replicable; or, if this is not a requirement, the general directions should change as well (note there are side notes in the general directions stating "This name [endpoints] must match the service name" Suggestions for improvement: Make the example docs use the same name
In addition to these submitted PRs that address some of the issues: https://github.com/openshift/openshift-docs/pull/3545 https://github.com/openshift/openshift-docs/pull/3546 https://github.com/openshift/openshift-docs/pull/3547 I continued work in: https://github.com/openshift/openshift-docs/pull/3635 https://github.com/openshift/openshift-docs/pull/3636
The endpoints name and service name are same now.
Commits pushed to master at https://github.com/openshift/openshift-docs https://github.com/openshift/openshift-docs/commit/f9c8add293cab2e4891410a137748386a2b6fdd0 Bug 1408293, clarified that if using a service the endpoints name needs to match the service name https://github.com/openshift/openshift-docs/commit/9fa748ecdcbc0edc0cdb9078ceb54ad605b66f4b Merge pull request #3635 from ahardin-rh/gluster-examples Bug 1408293, clarified that if using a service the endpoints name must match the service name
Content is now published: https://access.redhat.com/documentation/en/openshift-container-platform/3.4/single/installation-and-configuration/#complete-example-using-gusterfs-creating-the-gluster-endpoints https://access.redhat.com/documentation/en/openshift-container-platform/3.4/single/installation-and-configuration/#gfs-provisioning