Creating Deployments with YAML in Kubernetes - Why You Should Know This

The Big Idea

What if you could launch or fix your entire app with just one simple file?

The Scenario

Imagine you have a website that needs to run on several computers to handle many visitors. You try to start each copy by typing commands on each computer one by one.

The Problem

This manual way is slow and tiring. You might forget a step or make a typo. If you want to change something, you have to repeat the slow process again. It's easy to make mistakes that break your website.

The Solution

Using YAML files to create deployments lets you write down exactly how your website should run. Then, with one command, Kubernetes reads the file and sets up all the copies correctly and quickly. It's like giving clear instructions to a robot that never forgets.

Before vs After

✗ Before

kubectl create deployment myapp --image=myimage
kubectl scale deployment myapp --replicas=3

✓ After

apiVersion: apps/v1
kind: Deployment
metadata:
  name: myapp
spec:
  replicas: 3
  selector:
    matchLabels:
      app: myapp
  template:
    metadata:
      labels:
        app: myapp
    spec:
      containers:
      - name: myapp
        image: myimage

What It Enables

You can quickly and safely create, update, or fix your applications on many computers with a simple text file.

Real Life Example

A company launches a new online store. They use a YAML deployment file to run many copies of their store app. When traffic grows, they just change the file to add more copies instantly.

Key Takeaways

Manual setup is slow and error-prone.

YAML files give clear, repeatable instructions.

Deployments become fast, safe, and easy to manage.

Practice

1. What is the main purpose of a Deployment in Kubernetes when defined using a YAML file?

easy

A. To manage and update multiple copies of an application smoothly

B. To store data persistently across pods

C. To expose an application to the internet

D. To define network policies between pods

Solution

1. Step 1: Understand Deployment role

   A Deployment manages the lifecycle of pods, ensuring the desired number of replicas run and updates happen smoothly.

2. Step 2: Compare options

   Options B, C, and D describe other Kubernetes resources (PersistentVolume, Service, NetworkPolicy), not Deployment.

3. Final Answer:

   To manage and update multiple copies of an application smoothly -> Option A

4. Quick Check:

   Deployment = Manage app replicas and updates [OK]

Hint: Deployments control app copies and updates, not storage or networking [OK]

Common Mistakes:

• Confusing Deployment with Service or PersistentVolume
• Thinking Deployment exposes apps externally
• Assuming Deployment manages network policies

2. Which of the following YAML snippets correctly sets the number of pod replicas to 3 in a Deployment?

easy

A. replicas: 3

B. replicaCount: 3

C. count: 3

D. podReplicas: 3

Solution

1. Step 1: Identify correct replicas field

   The correct field to specify pod count in Deployment YAML is replicas.

2. Step 2: Check other options

   Fields like replicaCount, count, or podReplicas are invalid and will cause errors.

3. Final Answer:

   replicas: 3 -> Option A

4. Quick Check:

   Use 'replicas' to set pod count [OK]

Hint: Use 'replicas' exactly to set pod count in Deployment YAML [OK]

Common Mistakes:

• Using incorrect field names like replicaCount
• Misspelling 'replicas' or using camelCase
• Placing replicas under wrong YAML level

3. Given this Deployment YAML snippet, what will be the label selector used to match pods?

selector:
  matchLabels:
    app: myapp
    tier: frontend

medium

A. Pods with any label app or tier

B. Pods with label app=myapp only

C. Pods with label tier=frontend only

D. Pods with labels app=myapp and tier=frontend

Solution

1. Step 1: Understand matchLabels selector

   The matchLabels requires all listed labels to match exactly for pod selection.

2. Step 2: Analyze given labels

   Both app: myapp and tier: frontend must be present on pods to match.

3. Final Answer:

   Pods with labels app=myapp and tier=frontend -> Option D

4. Quick Check:

   matchLabels means all labels must match [OK]

Hint: matchLabels requires all labels to match exactly [OK]

Common Mistakes:

• Assuming matchLabels matches any one label
• Confusing matchLabels with matchExpressions
• Ignoring one of the labels in selector

4. You wrote this Deployment YAML but your pods are not created. What is the error?

apiVersion: apps/v1
kind: Deployment
metadata:
  name: webapp
spec:
  replicas: 2
  selector:
    matchLabels:
      app: webapp
  template:
    metadata:
      labels:
        app: frontend
    spec:
      containers:
      - name: webapp
        image: nginx

medium

A. No container ports defined

B. Incorrect apiVersion for Deployment

C. Selector labels do not match template labels

D. Missing container image tag

Solution

1. Step 1: Check selector and template labels

   The selector matchLabels: app: webapp does not match template labels: app: frontend. Labels must match exactly or Deployment creation fails.

2. Step 2: Verify other fields

   Ports are optional for pod creation; apiVersion is correct; image tag defaults to latest.

3. Final Answer:

   Selector labels do not match template labels -> Option C

4. Quick Check:

   Selector must match template labels [OK]

Hint: Selector labels must exactly match template labels [OK]

Common Mistakes:

• Assuming container ports are required for pod creation
• Thinking image tag is mandatory
• Confusing apiVersion for Deployment

5. You want to update your Deployment to run 5 replicas and change the container image to 'nginx:1.21'. Which YAML snippet correctly applies both changes?

hard

A. spec:
replicas: 5
template:
spec:
containers:
- name: nginx
image: nginx:1.21

B. spec:
replicas: 5
template:
metadata:
labels:
app: nginx
spec:
containers:
- name: nginx
image: nginx:1.21

C. spec:
replicas: 5
containers:
- name: nginx
image: nginx:1.21

D. spec:
template:
spec:
containers:
- name: nginx
image: nginx:1.21
replicas: 5

Solution

1. Step 1: Understand Deployment spec structure

   The replicas field is directly under spec. The pod template is under spec.template, which must include metadata.labels and spec.containers.

2. Step 2: Check each option's correctness

   spec:
     replicas: 5
     template:
       spec:
         containers:
         - name: nginx
           image: nginx:1.21

   misses metadata.labels under template, which is required for selector matching.

   spec:
     replicas: 5
     containers:
     - name: nginx
       image: nginx:1.21

   places containers directly under spec, which is invalid.

   spec:
     template:
       spec:
         containers:
         - name: nginx
           image: nginx:1.21
     replicas: 5

   places replicas after template, which is allowed but missing labels in template metadata.

   spec:
     replicas: 5
     template:
       metadata:
         labels:
           app: nginx
       spec:
         containers:
         - name: nginx
           image: nginx:1.21

   correctly includes replicas, template metadata labels, and container spec with updated image.

3. Final Answer:

   spec: replicas: 5, template with metadata.labels app: nginx, containers image: nginx:1.21 -> Option B

4. Quick Check:

   replicas under spec, labels in template metadata, containers in template spec [OK]

Hint: Always include labels in template metadata for selector matching [OK]

Common Mistakes:

• Omitting labels in pod template metadata
• Placing containers outside template spec
• Misplacing replicas field