Under the 🔬 with Kubernetes

by Tom Gallacher • March 11th, 2019 • 1min

Ever wanted to know a field in your Kubernetes yaml definition, but found it ridiculously difficult to find out what it means or even how to use it 😥?

kubectl is to the rescue!

To get started we can familiarise ourselves with what API resources we have available to use. To do this we can run kubectl api-resources, looking at the output of this command we can start to paint a picture of what resources our cluster is composed of.

Let’s take the deployment resource as our first example. Interestingly we can see that multiple definitions exist for this resource, once for the API Group extensions and one for apps. We will find out why this is the case later on 🤯!

So how do we write a yaml definition for this deployment? It’s possible to get examples for the Kubernetes documentation — personally I always find this too difficult to navigate, instead, it is possible to interrogate the API server’s OpenAPI specification using kubectl.

The command in question is kubectl explain, so let’s give this a whirl 😜!

$ kubectl explain deployment

This will show us all of the keys that are available to use at the top level!

KIND:     Deployment  
VERSION:  extensions/v1beta1

DESCRIPTION:  
     DEPRECATED - This group version of Deployment is deprecated by  
     apps/v1beta2/Deployment. See the release notes for more information.  
     Deployment enables declarative updates for Pods and ReplicaSets.

FIELDS:  
   apiVersion   <string>  
     APIVersion defines the versioned schema of this representation of an  
     object. Servers should convert recognized schemas to the latest internal  
     value, and may reject unrecognized values. More info:  
     [https://git.k8s.io/community/contributors/devel/api-conventions.md#resources](https://git.k8s.io/community/contributors/devel/api-conventions.md#resources)

kind <string>  
     Kind is a string value representing the REST resource this object  
     represents. Servers may infer this from the endpoint the client submits  
     requests to. Cannot be updated. In CamelCase. More info:  
     [https://git.k8s.io/community/contributors/devel/api-conventions.md#types-kinds](https://git.k8s.io/community/contributors/devel/api-conventions.md#types-kinds)

metadata     <Object>  
     Standard object metadata.

spec <Object>  
     Specification of the desired behavior of the Deployment.

status       <Object>  
     Most recently observed status of the Deployment.

If you really want to dive deep you can add a “recursive” parameter!

kubectl explain deployment --recursive

But I will omit the output so you can check it out yourself! (Hint: the output is longer than this post 😈)

Written by Tom Gallacher — Staff Engineer at YLD.

Interested in Kubernetes? Read more about it:

Written by Tom Gallacher • March 11th, 2019

Kubectl
Yaml
Software-Engineering
Kubernetes
Software

Share this article