Skip to content

Commit fbe0642

Browse files
committed
Removing Manage Nodes from Architecture doc
1 parent 4c41d6d commit fbe0642

File tree

1 file changed

+0
-97
lines changed

1 file changed

+0
-97
lines changed

modules/node-management.adoc

Lines changed: 0 additions & 97 deletions
Original file line numberDiff line numberDiff line change
@@ -122,100 +122,3 @@ Events: <none>
122122
<2> The user defined configuration.
123123
<3> The Machine Config Pool selector to apply the KubeletConfig to.
124124

125-
[[modifying-nodes]]
126-
== Modifying Nodes
127-
128-
{product-title} uses a KubeletConfig Custom Resource to manage the
129-
configuration of nodes. By creating an instance of a KubeletConfig, a managed
130-
MachineConfig is created to override setting on the node.
131-
132-
[NOTE]
133-
====
134-
*Logging into remote machines for the purpose of changing their configuration is not supported.*
135-
====
136-
137-
To make configuration changes to a MachinePool, you need to create a KubeletConfig instance. The Machine Config Controller watches for
138-
KubeletConfigs and applies the configuration.
139-
140-
.Sample configuration for a *max-pods* KubeletConfig
141-
----
142-
apiVersion: machineconfiguration.openshift.io/v1
143-
kind: KubeletConfig
144-
metadata:
145-
name: set-max-pods <1>
146-
spec:
147-
machineConfigPoolSelector:
148-
matchLabels: <2>
149-
custom-kubelet: small-pods
150-
kubeletConfig: <3>
151-
maxPods: 100
152-
----
153-
154-
<1> The name of the KubeletConfig.
155-
<2> The MachineConfigPool selector to apply the KubeletConfig to.
156-
<3> https://github.com/kubernetes/kubernetes/blob/release-1.11/pkg/kubelet/apis/kubeletconfig/v1beta1/types.go#L45[KubeletConfig Options]
157-
158-
Most https://github.com/kubernetes/kubernetes/blob/release-1.11/pkg/kubelet/apis/kubeletconfig/v1beta1/types.go#L45[KubeletConfig Options] may be set by the user. The following options are not allowed to be overwritten:
159-
160-
* CgroupDriver
161-
* ClusterDNS
162-
* ClusterDomain
163-
* RuntimeRequestTimeout
164-
* StaticPodPath
165-
166-
[[admin-guide-max-pods-per-node]]
167-
=== Setting maximum pods per node
168-
169-
////
170-
The following section is included in the Scaling and Performance Guide.
171-
////
172-
// tag::admin_guide_manage_nodes[]
173-
174-
In the KubeletConfig, two parameters control the maximum number of pods that
175-
can be scheduled to a node: `podsPerCore` and `maxPods`. When both options
176-
are in use, the lower of the two limits the number of pods on a node.
177-
Exceeding these values can result in:
178-
179-
* Increased CPU utilization on both {product-title} and Docker.
180-
* Slow pod scheduling.
181-
* Potential out-of-memory scenarios (depends on the amount of memory in the node).
182-
* Exhausting the pool of IP addresses.
183-
* Resource overcommitting, leading to poor user application performance.
184-
185-
[NOTE]
186-
====
187-
In Kubernetes, a pod that is holding a single container actually uses two
188-
containers. The second container is used to set up networking prior to the
189-
actual container starting. Therefore, a system running 10 pods will actually
190-
have 20 containers running.
191-
====
192-
193-
`podsPerCore` sets the number of pods the node can run based on the number of
194-
processor cores on the node. For example, if `podsPerCore` is set to `10` on
195-
a node with 4 processor cores, the maximum number of pods allowed on the node
196-
will be 40.
197-
198-
----
199-
spec:
200-
kubeletConfig:
201-
podsPerCore: 100
202-
----
203-
204-
[NOTE]
205-
====
206-
Setting `podsPerCore` to 0 disables this limit.
207-
====
208-
209-
`maxPods` sets the number of pods the node can run to a fixed value, regardless
210-
of the properties of the node.
211-
212-
----
213-
spec:
214-
kubeletConfig:
215-
maxPods: 250
216-
----
217-
218-
Using the above example, the default value for `podsPerCore` is `10` and the
219-
default value for `maxPods` is `250`. This means that unless the node has 25
220-
cores or more, by default, `podsPerCore` will be the limiting factor.
221-
// end::admin_guide_manage_nodes[]

0 commit comments

Comments
 (0)