Merge pull request #13457 from ahardin-rh/recommended-host-practices

Adding Recommended Host Practices to 4.0

Author: ahardin-rh

_topic_map.yml

@@ -245,6 +245,8 @@ Name: Scalability and performance
 Dir: scalability_and_performance
 Distros: openshift-origin, openshift-enterprise
 Topics:
+- Name: Recommended host practices
+  File: recommended-host-practices  
 - Name: Using the node tuning Operator
   File: using-node-tuning-operator
 - Name: Using Cluster Loader

modules/create-a-kubeletconfig-crd-to-edit-kubelet-parameters.adoc

@@ -0,0 +1,44 @@
+// Module included in the following assemblies:
+//
+// * scalability_and_performance/recommended-host-practices.adoc
+
+[id='create-a-kubeletconfig-crd-to-edit-kubelet-parameters-{context}']
+= Create a KubeletConfig CRD to edit kubelet parameters
+
+The kubelet configuration is currently serialized as an ignition configuration,
+so it can be directly edited. However, there is also a new
+kubelet-config-controller added to the Machine Config Controller (MCC). This
+allows you to create a KubeletConfig CustomResourceDefinition (CRD) to edit the
+kubelet parameters.
+
+.Procedure
+
+. Run:
++
+----
+$ oc get machineconfig
+----
++
+This provides a list of the available machine configuration objects you can
+select. By default, the two kubelet-related configs are `01-master-kubelet` and
+`01-worker-kubelet`.
+
+. To set the max Pods per node on the worker nodes, create a YAML file that
+contains the kublet configuration. For example, `max-worker-pods.yaml`:
++
+----
+apiVersion: machineconfiguration.openshift.io/v1
+kind: KubeletConfig
+metadata:
+  name: set-max-pods
+spec:
+  machineConfigSelector: 01-worker-kubelet
+  kubeletConfig:
+    maxPods: 250
+----
+
+. Apply the file by running:
++
+----
+$ oc apply -f max-worker-pods.yaml
+----

scalability_and_performance/PLACEHOLDER

@@ -0,0 +1,11 @@
+[id='recommended-host-practices']
+= Recommended host practices
+include::modules/common-attributes.adoc[]
+:context:
+
+toc::[]
+
+{nbsp} +
+This topic provides recommended host practices for {product-title}.
+
+include::modules/create-a-kubeletconfig-crd-to-edit-kubelet-parameters.adoc[leveloffset=+1]