K8S Definition File

A K8s definition file always contains the 4 top-level fields:

apiVersion: v1
kind: Pod
metadata:
  name: my-pod
spec:
    containers:
    - name: my-container
        image: my-image

apiVersion indicates the API version used by the object. In this case, it is v1, which means we are using the first stable version of the Kubernetes API.

kind: Pod

kind specifies the type of object. In this case, it is Pod, which means we are creating a Pod object.

metadata:
  name: my-pod
  labels:
    app: my-app
    type: frontend

metadata contains metadata about the object, such as its name. In this case, we set the Pod name to my-pod.

spec:
    containers:  # list of containers in the Pod
    - name: my-container
        image: my-image # Image on the Docker repository

spec contains the specification of the object. In this case, we define the containers that will run in the Pod. We create a single container named my-container with the image my-image.

Command to create a Pod from a definition file:

kubectl create -f my-pod.yaml

Command to show the list of Pods:

kubectl get pods

Detailed information about a Pod:

kubectl describe pod my-pod