Merge pull request #23116 from metral/recursive-visit

Automatic merge from submit-queue

allow kubectl cmds to process files recursively, when given a dir

This PR accomplishes two things:

1. It creates a `--recursive` flag for use with certain `kubectl` commands that _currently_ do not process files beyond their first level of children, as seen in the issue https://github.com/kubernetes/kubernetes/issues/19767
2. It enables the ability to use the `--recursive` flag in the `kubectl` commands that currently _only_ support processing a directory up to its first level of children.

docs/man/man1/kubectl-annotate.1

@@ -59,6 +59,10 @@ horizontalpodautoscalers (hpa), resourcequotas (quota) or secrets.
 \fB\-\-record\fP=false
     Record current kubectl command in the resource annotation.
 
+.PP
+\fB\-R\fP, \fB\-\-recursive\fP=false
+    If true, process directory recursively.
+
 .PP
 \fB\-\-resource\-version\fP=""
     If non\-empty, the annotation update will only succeed if this is the current resource\-version for the object. Only valid when specifying a single resource.

docs/man/man1/kubectl-apply.1

@@ -33,6 +33,10 @@ JSON and YAML formats are accepted.
 \fB\-\-record\fP=false
     Record current kubectl command in the resource annotation.
 
+.PP
+\fB\-R\fP, \fB\-\-recursive\fP=false
+    If true, process directory recursively.
+
 .PP
 \fB\-\-schema\-cache\-dir\fP="\~/.kube/schema"
     If non\-empty, load/store cached API schemas in this directory, default is '$HOME/.kube/schema'

docs/man/man1/kubectl-autoscale.1

@@ -67,6 +67,10 @@ An autoscaler can automatically increase or decrease number of pods deployed wit
 \fB\-\-record\fP=false
     Record current kubectl command in the resource annotation.
 
+.PP
+\fB\-R\fP, \fB\-\-recursive\fP=false
+    If true, process directory recursively.
+
 .PP
 \fB\-\-save\-config\fP=false
     If true, the configuration of current object will be saved in its annotation. This is useful when you want to perform kubectl apply on this object in the future.

docs/man/man1/kubectl-convert.1

@@ -49,6 +49,10 @@ to change to output destination.
 \fB\-\-output\-version\fP=""
     Output the formatted object with the given group version (for ex: 'extensions/v1beta1').
 
+.PP
+\fB\-R\fP, \fB\-\-recursive\fP=false
+    If true, process directory recursively.
+
 .PP
 \fB\-\-schema\-cache\-dir\fP="\~/.kube/schema"
     If non\-empty, load/store cached API schemas in this directory, default is '$HOME/.kube/schema'

docs/man/man1/kubectl-create.1

@@ -32,6 +32,10 @@ JSON and YAML formats are accepted.
 \fB\-\-record\fP=false
     Record current kubectl command in the resource annotation.
 
+.PP
+\fB\-R\fP, \fB\-\-recursive\fP=false
+    If true, process directory recursively.
+
 .PP
 \fB\-\-save\-config\fP=false
     If true, the configuration of current object will be saved in its annotation. This is useful when you want to perform kubectl apply on this object in the future.

docs/man/man1/kubectl-delete.1

@@ -52,6 +52,10 @@ will be lost along with the rest of the resource.
 \fB\-o\fP, \fB\-\-output\fP=""
     Output mode. Use "\-o name" for shorter output (resource/name).
 
+.PP
+\fB\-R\fP, \fB\-\-recursive\fP=false
+    If true, process directory recursively.
+
 .PP
 \fB\-l\fP, \fB\-\-selector\fP=""
     Selector (label query) to filter on.

docs/man/man1/kubectl-describe.1

@@ -39,6 +39,10 @@ componentstatuses (cs), endpoints (ep), and secrets.
 \fB\-f\fP, \fB\-\-filename\fP=[]
     Filename, directory, or URL to a file containing the resource to describe
 
+.PP
+\fB\-R\fP, \fB\-\-recursive\fP=false
+    If true, process directory recursively.
+
 .PP
 \fB\-l\fP, \fB\-\-selector\fP=""
     Selector (label query) to filter on

docs/man/man1/kubectl-edit.1

@@ -54,6 +54,10 @@ saved copy to include the latest resource version.
 \fB\-\-record\fP=false
     Record current kubectl command in the resource annotation.
 
+.PP
+\fB\-R\fP, \fB\-\-recursive\fP=false
+    If true, process directory recursively.
+
 .PP
 \fB\-\-save\-config\fP=false
     If true, the configuration of current object will be saved in its annotation. This is useful when you want to perform kubectl apply on this object in the future.

docs/man/man1/kubectl-expose.1

@@ -91,6 +91,10 @@ labels are specified, the new service will re\-use the labels from the resource
 \fB\-\-record\fP=false
     Record current kubectl command in the resource annotation.
 
+.PP
+\fB\-R\fP, \fB\-\-recursive\fP=false
+    If true, process directory recursively.
+
 .PP
 \fB\-\-save\-config\fP=false
     If true, the configuration of current object will be saved in its annotation. This is useful when you want to perform kubectl apply on this object in the future.

docs/man/man1/kubectl-get.1

@@ -58,6 +58,10 @@ of the \-\-template flag, you can filter the attributes of the fetched resource(
 \fB\-\-output\-version\fP=""
     Output the formatted object with the given group version (for ex: 'extensions/v1beta1').
 
+.PP
+\fB\-R\fP, \fB\-\-recursive\fP=false
+    If true, process directory recursively.
+
 .PP
 \fB\-l\fP, \fB\-\-selector\fP=""
     Selector (label query) to filter on

docs/man/man1/kubectl-label.1

@@ -56,6 +56,10 @@ If \-\-resource\-version is specified, then updates will use this resource versi
 \fB\-\-record\fP=false
     Record current kubectl command in the resource annotation.
 
+.PP
+\fB\-R\fP, \fB\-\-recursive\fP=false
+    If true, process directory recursively.
+
 .PP
 \fB\-\-resource\-version\fP=""
     If non\-empty, the labels update will only succeed if this is the current resource\-version for the object. Only valid when specifying a single resource.

docs/man/man1/kubectl-patch.1

@@ -40,6 +40,10 @@ Please refer to the models in
 \fB\-\-record\fP=false
     Record current kubectl command in the resource annotation.
 
+.PP
+\fB\-R\fP, \fB\-\-recursive\fP=false
+    If true, process directory recursively.
+
 .PP
 \fB\-\-type\fP="strategic"
     The type of patch being provided; one of [json merge strategic]

docs/man/man1/kubectl-replace.1

@@ -50,6 +50,10 @@ Please refer to the models in
 \fB\-\-record\fP=false
     Record current kubectl command in the resource annotation.
 
+.PP
+\fB\-R\fP, \fB\-\-recursive\fP=false
+    If true, process directory recursively.
+
 .PP
 \fB\-\-save\-config\fP=false
     If true, the configuration of current object will be saved in its annotation. This is useful when you want to perform kubectl apply on this object in the future.

docs/man/man1/kubectl-rollout-history.1

@@ -21,6 +21,10 @@ View previous rollout revisions and configurations.
 \fB\-f\fP, \fB\-\-filename\fP=[]
     Filename, directory, or URL to a file identifying the resource to get from a server.
 
+.PP
+\fB\-R\fP, \fB\-\-recursive\fP=false
+    If true, process directory recursively.
+
 .PP
 \fB\-\-revision\fP=0
     See the details, including podTemplate of the revision specified

docs/man/man1/kubectl-rollout-pause.1

@@ -26,6 +26,10 @@ Currently only deployments support being paused.
 \fB\-f\fP, \fB\-\-filename\fP=[]
     Filename, directory, or URL to a file identifying the resource to get from a server.
 
+.PP
+\fB\-R\fP, \fB\-\-recursive\fP=false
+    If true, process directory recursively.
+
 
 .SH OPTIONS INHERITED FROM PARENT COMMANDS
 .PP

docs/man/man1/kubectl-rollout-resume.1

@@ -26,6 +26,10 @@ Currently only deployments support being resumed.
 \fB\-f\fP, \fB\-\-filename\fP=[]
     Filename, directory, or URL to a file identifying the resource to get from a server.
 
+.PP
+\fB\-R\fP, \fB\-\-recursive\fP=false
+    If true, process directory recursively.
+
 
 .SH OPTIONS INHERITED FROM PARENT COMMANDS
 .PP

docs/man/man1/kubectl-rollout-undo.1

@@ -21,6 +21,10 @@ Rollback to a previous rollout.
 \fB\-f\fP, \fB\-\-filename\fP=[]
     Filename, directory, or URL to a file identifying the resource to get from a server.
 
+.PP
+\fB\-R\fP, \fB\-\-recursive\fP=false
+    If true, process directory recursively.
+
 .PP
 \fB\-\-to\-revision\fP=0
     The revision to rollback to. Default to 0 (last revision).

docs/man/man1/kubectl-scale.1

@@ -39,6 +39,10 @@ scale is sent to the server.
 \fB\-\-record\fP=false
     Record current kubectl command in the resource annotation.
 
+.PP
+\fB\-R\fP, \fB\-\-recursive\fP=false
+    If true, process directory recursively.
+
 .PP
 \fB\-\-replicas\fP=\-1
     The new desired number of replicas. Required.

docs/man/man1/kubectl-stop.1

@@ -45,6 +45,10 @@ If the resource is scalable it will be scaled to 0 before deletion.
 \fB\-o\fP, \fB\-\-output\fP=""
     Output mode. Use "\-o name" for shorter output (resource/name).
 
+.PP
+\fB\-R\fP, \fB\-\-recursive\fP=false
+    If true, process directory recursively.
+
 .PP
 \fB\-l\fP, \fB\-\-selector\fP=""
     Selector (label query) to filter on.