From dbfb06385e690004df127026be7816825df8b4c9 Mon Sep 17 00:00:00 2001
From: Aditya Shrivastav <81470938+aditya-shrivastavv@users.noreply.github.com>
Date: Fri, 20 Oct 2023 17:18:58 +0530
Subject: [PATCH] kubectl replace: add page (#11091)

* kubectl replace: add page

* kubectl replace: fix typo

* kubectl replace: fix typo

* kubectl replace: fix typo

* kubectl replace: apply suggestions from code review

Co-authored-by: Juri Dispan <juri.dispan@posteo.net>

---------

Co-authored-by: Juri Dispan <juri.dispan@posteo.net>
---
 pages/common/kubectl-replace.md | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)
 create mode 100644 pages/common/kubectl-replace.md

diff --git a/pages/common/kubectl-replace.md b/pages/common/kubectl-replace.md
new file mode 100644
index 0000000000..91075ca646
--- /dev/null
+++ b/pages/common/kubectl-replace.md
@@ -0,0 +1,16 @@
+# kubctl replace
+
+> Replace a resource by file or `stdin`.
+> More information: <https://kubernetes.io/docs/reference/generated/kubectl/kubectl-commands#replace>.
+
+- Replace the resource using the resource definition file:
+
+`kubectl replace -f {{path/to/file.yml}}`
+
+- Replace the resource using the input passed into `stdin`:
+
+`kubectl replace -f -`
+
+- Force replace, delete and then re-create the resource:
+
+`kubectl replace --force -f {{path/to/file.yml}}`