• Kubernetes Submit Queue's avatar
    Merge pull request #55689 from luksa/kubectl_explain_kind_version · 761fdeac
    Kubernetes Submit Queue authored
    Automatic merge from submit-queue. If you want to cherry-pick this change to another branch, please follow the instructions <a href="https://github.com/kubernetes/community/blob/master/contributors/devel/cherry-picks.md">here</a>.
    
    Make kubectl explain print the Kind and APIVersion of the resource
    
    **What this PR does / why we need it**:
    Kubectl explain currently doesn't print out the Kind and APIversion of the resource being explained. When running `kubectl explain hpa.spec`, for example, there is no way of knowing whether you're looking at the `autoscaling/v1` or the `autoscaling/v2beta1` version. 
    Also, `kubectl explain` is often used as a reference when writing YAML/JSON object manifests. It allows you to look up everything except the API version. Currently, you either need to know the API Version of a resource by heart or look it up in the online API docs. 
    This PR fixes both problems by having `kubectl explain` print out the full Kind and APIVersion of the resource it is explaining.
    
    Here are a few examples of the new output:
    ```
    $ kubectl explain deploy
    KIND:     Deployment
    VERSION:  extensions/v1beta1
    
    DESCRIPTION:
    ...
    
    
    $ kubectl explain hpa.spec
    KIND:     HorizontalPodAutoscaler
    VERSION:  autoscaling/v1
    
    RESOURCE: spec <Object>
    
    DESCRIPTION:
    ...
    
    
    $ kubectl explain hpa.spec.maxReplicas
    KIND:     HorizontalPodAutoscaler
    VERSION:  autoscaling/v1
    
    FIELD:    maxReplicas <integer>
    
    DESCRIPTION:
    ...
    
    
    $ kubectl explain hpa.spec --recursive
    KIND:     HorizontalPodAutoscaler
    VERSION:  autoscaling/v1
    
    RESOURCE: spec <Object>
    
    DESCRIPTION:
         behaviour of autoscaler. More info:
         https://git.k8s.io/community/contributors/devel/api-conventions.md#spec-and-status.
    
         specification of a horizontal pod autoscaler.
    
    FIELDS:
       maxReplicas	<integer>
       minReplicas	<integer>
       scaleTargetRef	<Object>
          apiVersion	<string>
          kind	<string>
          name	<string>
       targetCPUUtilizationPercentage	<integer>
    ```
    
    **Release note**:
    
    ```release-note
    Kubectl explain now prints out the Kind and API version of the resource being explained
    ```
    761fdeac
Name
Last commit
Last update
..
api Loading commit data...
apis Loading commit data...
auth Loading commit data...
bootstrap/api Loading commit data...
capabilities Loading commit data...
client Loading commit data...
cloudprovider Loading commit data...
controller Loading commit data...
credentialprovider Loading commit data...
features Loading commit data...
fieldpath Loading commit data...
generated Loading commit data...
hyperkube Loading commit data...
kubeapiserver Loading commit data...
kubectl Loading commit data...
kubelet Loading commit data...
kubemark Loading commit data...
master Loading commit data...
printers Loading commit data...
probe Loading commit data...
proxy Loading commit data...
quota Loading commit data...
registry Loading commit data...
routes Loading commit data...
security Loading commit data...
securitycontext Loading commit data...
serviceaccount Loading commit data...
ssh Loading commit data...
util Loading commit data...
version Loading commit data...
volume Loading commit data...
watch Loading commit data...
.import-restrictions Loading commit data...
BUILD Loading commit data...
OWNERS Loading commit data...