Skip to main content

🧩 Pods

A Pod is the smallest unit of Kubernetes: an "envelope" that holds your container (for example, a website on NGINX) and keeps it running in the cluster.

info

Pods are created and managed with kubectl. The Nuvion Panel manages the cluster (nodes, workers and access), but does not have a Pods screen.


🚀 Before you start​

🚀 1. List the cluster pods​

kubectl get pods -A

You will see the system pods (such as CoreDNS and Metrics Server). The STATUS column shows the state of each pod.

🚀 2. Create a test pod​

kubectl run nginx-teste --image=nginx --port=80

Expected output: pod/nginx-teste created

🚀 3. Check that it is running​

kubectl get pods

Wait for the STATUS to change to Running.

🚀 4. See details and logs​

kubectl describe pod nginx-teste
kubectl logs nginx-teste

At the end of describe, the Events section tells what happened to the pod (image pulled, container started, errors).

🚀 5. Enter the pod​

kubectl exec -it nginx-teste -- sh

You will be inside the container. Type exit to leave.

🚀 6. Delete the pod​

kubectl delete pod nginx-teste
warning

A pod created on its own is not recreated if deleted. For real applications, use a Workload (see Workloads).

✅ How to know it worked​

The pod appears with STATUS Running in step 3 and logs shows the NGINX requests.

❗ Common problems​

STATUSWhat it meansWhat to do
PendingNo resources available on the nodesSee the Events section of describe and the node capacity
ImagePullBackOffCould not pull the imageCheck the image name and tag
CrashLoopBackOffThe container starts and failsCheck kubectl logs pod-name
CompletedThe container finished its taskNormal for one-off tasks

➡️ Next step: Services

🧠 Questions?​

Talk to our SaveinCloud technical support team!