OpenShift — Beginner’s guide to debug a pod

5 beginner tips for debugging a Failing pod and bringing it to the Running state.

OpenShift pods are the smallest units that can be deployed on an OpenShift cluster. Often, when deploying a pod directly or as part of the deployment, we observe that pods are not successfully deployed.

How to find the current status of the pod :

Once you have deployed the deployment or the pod, run the below command to confirm that the pod is deployed successfully :

oc get pods -n namespace

A list of deployed pods will be displayed (depending on the pods deployed in the namespace):

From the pod list, check the status of the pod deployed by you.

If the pod status is not Running, it means that pod deployment has failed. Run the below command to describe the pod :

oc describe pod <podname> -n namespace

Go to the Events section at the bottom of the screen

In the events section, read the error message and the reason for the error.

Now, let's have a quick look at the 5 most common errors and how to resolve those:

ErrImagePull , ErrImagePullBackOff, or an error related to the image :