Skip to content

Commit 983bbe9

Browse files
authored
Merge pull request #38213 from T-Lakshmi/doc-nodes
Added glossary tooltip and references in the Nodes page
2 parents 5bc5517 + 2765283 commit 983bbe9

File tree

1 file changed

+10
-8
lines changed
  • content/en/docs/concepts/architecture

1 file changed

+10
-8
lines changed

content/en/docs/concepts/architecture/nodes.md

Lines changed: 10 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ weight: 10
99

1010
<!-- overview -->
1111

12-
Kubernetes runs your workload by placing containers into Pods to run on _Nodes_.
12+
Kubernetes runs your {{< glossary_tooltip text="workload" term_id="workload" >}} by placing containers into Pods to run on _Nodes_.
1313
A node may be a virtual or physical machine, depending on the cluster. Each node
1414
is managed by the
1515
{{< glossary_tooltip text="control plane" term_id="control-plane" >}}
@@ -563,7 +563,7 @@ ShutdownGracePeriodCriticalPods are not configured properly. Please refer to abo
563563
section [Graceful Node Shutdown](#graceful-node-shutdown) for more details.
564564

565565
When a node is shutdown but not detected by kubelet's Node Shutdown Manager, the pods
566-
that are part of a StatefulSet will be stuck in terminating status on
566+
that are part of a {{< glossary_tooltip text="StatefulSet" term_id="statefulset" >}} will be stuck in terminating status on
567567
the shutdown node and cannot move to a new running node. This is because kubelet on
568568
the shutdown node is not available to delete the pods so the StatefulSet cannot
569569
create a new pod with the same name. If there are volumes used by the pods, the
@@ -577,7 +577,7 @@ these pods will be stuck in terminating status on the shutdown node forever.
577577
To mitigate the above situation, a user can manually add the taint `node.kubernetes.io/out-of-service` with either `NoExecute`
578578
or `NoSchedule` effect to a Node marking it out-of-service.
579579
If the `NodeOutOfServiceVolumeDetach`[feature gate](/docs/reference/command-line-tools-reference/feature-gates/)
580-
is enabled on `kube-controller-manager`, and a Node is marked out-of-service with this taint, the
580+
is enabled on {{< glossary_tooltip text="kube-controller-manager" term_id="kube-controller-manager" >}}, and a Node is marked out-of-service with this taint, the
581581
pods on the node will be forcefully deleted if there are no matching tolerations on it and volume
582582
detach operations for the pods terminating on the node will happen immediately. This allows the
583583
Pods on the out-of-service node to recover quickly on a different node.
@@ -646,9 +646,11 @@ see [KEP-2400](https://github.com/kubernetes/enhancements/issues/2400) and its
646646

647647
## {{% heading "whatsnext" %}}
648648

649-
* Learn about the [components](/docs/concepts/overview/components/#node-components) that make up a node.
650-
* Read the [API definition for Node](/docs/reference/generated/kubernetes-api/{{< param "version" >}}/#node-v1-core).
651-
* Read the [Node](https://git.k8s.io/design-proposals-archive/architecture/architecture.md#the-kubernetes-node)
652-
section of the architecture design document.
653-
* Read about [taints and tolerations](/docs/concepts/scheduling-eviction/taint-and-toleration/).
649+
Learn more about the following:
650+
* [Components](/docs/concepts/overview/components/#node-components) that make up a node.
651+
* [API definition for Node](/docs/reference/generated/kubernetes-api/{{< param "version" >}}/#node-v1-core).
652+
* [Node](https://git.k8s.io/design-proposals-archive/architecture/architecture.md#the-kubernetes-node) section of the architecture design document.
653+
* [Taints and Tolerations](/docs/concepts/scheduling-eviction/taint-and-toleration/).
654+
* [Node Resource Managers](/docs/concepts/policy/node-resource-managers/).
655+
* [Resource Management for Windows nodes](/docs/concepts/configuration/windows-resource-management/).
654656

0 commit comments

Comments
 (0)