0Pricing
Docker & Kubernetes for Developers · Lesson

Deploying Your First Pod

Learn to define and deploy a simple application as a Pod in a Kubernetes cluster using YAML manifests and `kubectl`.

Deploying Your First Pod is a free Docker & Kubernetes for Developers lesson on CoddyKit — lesson 3 of 4. You can read the complete lesson below for free — then practise it hands-on in the browser with a built-in code editor and a 24/7 AI tutor. It is part of the Docker & Kubernetes for Developers learning path, one of 4 lessons in the course, and your progress syncs across the web and the CoddyKit app.

Pods: Smallest K8s Unit

In Kubernetes, the smallest deployable unit is a Pod. Think of a Pod as a logical host for one or more containers.

While Docker deals with individual containers, Kubernetes orchestrates Pods. A Pod encapsulates application containers, storage resources, a unique network IP, and options that govern how containers run.

Why Pods, Not Just Containers?

Why do we need Pods when we already have containers?

  • Shared Resources: Containers within the same Pod share the same network namespace and IP address. They can communicate using localhost.
  • Co-location: Pods ensure that co-located containers (like an app and a helper 'sidecar') are always scheduled together on the same node.
  • Abstraction: Pods provide an abstraction layer over individual containers, making orchestration simpler.

Anatomy of a Pod

A Pod is more than just a container. It includes:

  • Application Containers: One or more containers (e.g., your app, a logging agent).
  • Storage: Shared storage volumes for data persistence.
  • Network: A unique IP address and network namespace.
  • Configuration: Information on how to run the containers.

Pods are designed to be ephemeral. If a Pod dies, Kubernetes creates a new one (often managed by a higher-level object).

Defining Pods with YAML

Kubernetes resources, including Pods, are defined using YAML (YAML Ain't Markup Language) files. YAML is a human-readable data serialization standard.

These files act as blueprints, telling Kubernetes what you want to create and how.

Every Kubernetes object needs these top-level fields: apiVersion, kind, metadata, and spec.

Basic Pod YAML Structure

Let's look at the basic structure of a Pod definition in YAML:

apiVersion: v1
kind: Pod
metadata:
  name: my-first-pod
  labels:
    app: webserver
spec:
  containers:
    - name: my-container
      image: nginx:latest
      ports:
        - containerPort: 80

Our First Pod: Nginx

We'll deploy a simple Nginx web server as our first Pod. Nginx is a popular open-source HTTP server.

This manifest describes a Pod named nginx-pod, running a single container based on the nginx:latest Docker image, exposing port 80.

apiVersion: v1
kind: Pod
metadata:
  name: nginx-pod
  labels:
    app: nginx
spec:
  containers:
    - name: nginx-container
      image: nginx:latest
      ports:
        - containerPort: 80

Introducing `kubectl`

To interact with your Kubernetes cluster, you'll use the command-line tool called kubectl (pronounced "kube-control" or "kube-cuddle").

kubectl allows you to run commands against Kubernetes clusters, including deploying applications, inspecting and managing cluster resources, and viewing logs.

Ensure your kubectl is configured to point to your cluster.

Deploying Your Pod

Once you have your Pod definition in a YAML file (e.g., nginx-pod.yaml), you can deploy it to your Kubernetes cluster using the kubectl apply command.

This command tells Kubernetes to create or update resources based on the provided configuration.

Try running this:

kubectl apply -f nginx-pod.yaml

Checking Pod Status

After deploying, you'll want to check if your Pod is running correctly. Use kubectl get pods to see a list of all Pods in the current namespace.

To get more detailed information about a specific Pod, use kubectl describe pod <pod-name>.

  • Pending: Pod accepted, but containers not yet created.
  • Running: Pod has been bound to a node and all containers have been created.
  • Error: At least one container terminated in failure.
kubectl get pods
kubectl describe pod nginx-pod

Accessing Pod Logs

When debugging applications inside your Pod, checking the container logs is crucial. Use the kubectl logs command to retrieve logs from a container within a Pod.

This helps you see what your application is doing or if any errors occurred during startup or runtime.

kubectl logs nginx-pod

Pod Deployment Question

You've just learned how to define and deploy a Pod using YAML and kubectl. Imagine you've created my-app.yaml and deployed it.

Which command would you use to check the detailed status and events of your newly deployed Pod named my-app-pod?

Recap: Your First Pod

Congratulations! You've deployed your first Kubernetes Pod.

  • Pods are the smallest deployable units in Kubernetes, encapsulating containers, storage, and network.
  • You define Pods using YAML manifests with fields like apiVersion, kind, metadata, and spec.
  • The kubectl command-line tool is used to manage Kubernetes resources.
  • You deploy Pods with kubectl apply -f <filename>, check status with kubectl get pods and kubectl describe pod, and view logs with kubectl logs.

Next, we'll explore how Deployments manage Pods at scale!

Frequently asked questions

Is the “Deploying Your First Pod” lesson free?

Yes — the full text of “Deploying Your First Pod” is free to read here on the web, and the Docker & Kubernetes for Developers course includes 4 lessons in total. To practise it interactively (a built-in code editor and a 24/7 AI tutor) and unlock the rest of the Docker & Kubernetes for Developers course, upgrade to CoddyKit PRO.

What will I learn in “Deploying Your First Pod”?

Learn to define and deploy a simple application as a Pod in a Kubernetes cluster using YAML manifests and `kubectl`. You practise Docker & Kubernetes for Developers with hands-on code you run directly in the browser, and a 24/7 AI tutor answers your questions as you work through the lesson.

Do I need any experience to start Docker & Kubernetes for Developers?

No prior experience is required. Docker & Kubernetes for Developers on CoddyKit is structured for beginners through advanced learners; this is — lesson 3 of 4, so you can start here or from the beginning and move at your own pace.

How long does the “Deploying Your First Pod” lesson take?

Most CoddyKit lessons take about 5–10 minutes. Each one is bite-sized and interactive, so you make steady progress and pick up exactly where you left off across the web and the app.

Can I write and run code in this Docker & Kubernetes for Developers lesson?

Yes. Every Docker & Kubernetes for Developers lesson includes a built-in code editor, so you write and run real code right in your browser and get instant AI feedback — no local setup required.

All lessons in this course

  1. Introduction to Kubernetes & Why It Matters
  2. Kubernetes Architecture & Components
  3. Deploying Your First Pod
  4. Working with kubectl: Your Cluster Control Tool
← Back to Docker & Kubernetes for Developers