From 766f54f1b8958ec5d7ef9e6b423b17fe84f7577f Mon Sep 17 00:00:00 2001 From: abhilasha2418 Date: Fri, 27 Dec 2024 14:25:43 +0530 Subject: [PATCH] feature: add drain to glossary --- content/en/docs/reference/glossary/drain.md | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) create mode 100644 content/en/docs/reference/glossary/drain.md diff --git a/content/en/docs/reference/glossary/drain.md b/content/en/docs/reference/glossary/drain.md new file mode 100644 index 0000000000000..687b5da80d872 --- /dev/null +++ b/content/en/docs/reference/glossary/drain.md @@ -0,0 +1,18 @@ +--- +title: Drain +id: drain +date: 2024-12-27 +full_link: +short_description: > + Safely evicts Pods from a Node to prepare for maintenance or removal. +tags: +- fundamental +- operation +--- +The process of safely evicting {{< glossary_tooltip text="Pods" term_id="pod" >}} from a {{< glossary_tooltip text="Node" term_id="node" >}} to prepare it for maintenance or removal from a {{< glossary_tooltip text="cluster" term_id="cluster" >}}. + + + +The `kubectl drain` command is used to mark a {{< glossary_tooltip text="Node" term_id="node" >}} as going out of service. +When executed, it evicts all {{< glossary_tooltip text="Pods" term_id="pod" >}} from the {{< glossary_tooltip text="Node" term_id="node" >}}. +If an eviction request is temporarily rejected, `kubectl drain` retries until all {{< glossary_tooltip text="Pods" term_id="pod" >}} are terminated or a configurable timeout is reached.