Bug 1828538

Summary: [DDF] It would be nice if this were more consistent with infrastructure nodes. The docs on creating infra machinesets
Product: [Red Hat Storage] Red Hat OpenShift Container Storage Reporter: Direct Docs Feedback <ddf-bot>
Component: documentationAssignee: Anjana Suparna Sriram <asriram>
Status: NEW --- QA Contact: Elad <ebenahar>
Severity: medium Docs Contact:
Priority: unspecified    
Version: 4.2CC: olakra
Target Milestone: ---   
Target Release: OCS 4.3.z   
Hardware: All   
OS: All   
Whiteboard:
Fixed In Version: Doc Type: If docs needed, set a value
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: Type: ---
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:
Embargoed:

Description Direct Docs Feedback 2020-04-27 20:02:27 UTC
It would be nice if this were more consistent with infrastructure nodes. The docs on creating infra machinesets recommend using node-role.kubernetes.io/infra='' to identify those. According to a knowledge base article, cloud.redhat.com uses the same label to identify infra nodes and exclude them from reported license counts.

One could use node-role.kubernetes.io/storage='' for dedicated storage nodes, or apply both role.kubernetes.io/storage='' and role.kubernetes.io/worker='' to mixed nodes. That could make it easier for cloud.redhat.com to display accurate license counts as well, for both worker and storage nodes.

It would also let the admin avoid delving into taints and tolerations, which this document doesn't adequately describe. For example neither this document nor the provided link to https://access.redhat.com/documentation/en-us/openshift_container_platform/4.2/html-single/nodes/index#nodes-scheduler-taints-tolerations doesn't explain how to update the ClusterLogging custom resource to apply the toleration to fluentd, or even mention the need to do so.

Someone implementing OCS for the first time shouldn't have to troubleshoot the application of tolerations to operator-managed pods. Ideally the recommendation would be consistent with infra nodes and use the node-role. If there's a real need for taints and tolerations, then there should be more thorough guidance on how to correctly apply tolerations to the components that are mentioned (fluentd, node-ca, and node-exporter).

Reported by: chosey

https://access.redhat.com/documentation/en-us/red_hat_openshift_container_storage/4.2/html/deploying_openshift_container_storage/deploying-openshift-container-storage#annotations:03413c1c-ee8b-4a7b-8726-2cca321821e5

Comment 4 Jean-Charles Lopez 2020-07-28 17:35:57 UTC
Will look at the current section and work something out with Olive