Bird
Raised Fist0
Kubernetesdevops~5 mins

Sidecar proxy concept (Envoy) in Kubernetes - Commands & Configuration

Choose your learning style10 modes available

Start learning this pattern below

Jump into concepts and practice - no test required

or
Recommended
Test this pattern10 questions across easy, medium, and hard to know if this pattern is strong
Introduction
Sometimes applications need help managing network traffic and security. A sidecar proxy like Envoy runs alongside your app to handle these tasks without changing your app code.
When you want to add secure communication between microservices without changing their code
When you need to monitor and control traffic going in and out of your application
When you want to add retries or timeouts to your app's network calls easily
When you want to collect detailed logs and metrics about your app's network traffic
When you want to isolate network features from your app for easier updates and maintenance
Config File - pod.yaml
pod.yaml
apiVersion: v1
kind: Pod
metadata:
  name: my-app-pod
spec:
  containers:
  - name: my-app
    image: nginx:1.23
    ports:
    - containerPort: 80
  - name: envoy-proxy
    image: envoyproxy/envoy:v1.23.0
    ports:
    - containerPort: 9901 # Envoy admin port
    - containerPort: 10000 # Envoy listener port
    command:
    - /usr/local/bin/envoy
    - -c
    - /etc/envoy/envoy.yaml
    - --service-node
    - sidecar-proxy
    - --service-cluster
    - my-app-cluster
    volumeMounts:
    - name: envoy-config
      mountPath: /etc/envoy
  volumes:
  - name: envoy-config
    configMap:
      name: envoy-config

This YAML defines a Kubernetes Pod with two containers: your app container running nginx and a sidecar container running Envoy proxy.

The Envoy container uses a ConfigMap for its configuration, listens on ports 9901 (admin) and 10000 (proxy traffic), and runs with command-line arguments to identify itself.

This setup allows Envoy to intercept and manage network traffic for your app without changing the app itself.

Commands
This command creates the Pod with both your app and the Envoy sidecar proxy running together.
Terminal
kubectl apply -f pod.yaml
Expected OutputExpected
pod/my-app-pod created
Check that the Pod is running and both containers are ready.
Terminal
kubectl get pods
Expected OutputExpected
NAME READY STATUS RESTARTS AGE my-app-pod 2/2 Running 0 10s
View logs from the Envoy sidecar to see how it is managing traffic and if it started correctly.
Terminal
kubectl logs my-app-pod -c envoy-proxy
Expected OutputExpected
[2024-06-01T12:00:00.000Z] [info] Envoy proxy starting up [2024-06-01T12:00:01.000Z] [info] Listener started on 0.0.0.0:10000
-c - Specify the container name inside the Pod
Test that Envoy is listening on the proxy port inside the Pod by curling it from the app container.
Terminal
kubectl exec my-app-pod -c my-app -- curl -s http://localhost:10000
Expected OutputExpected
<!DOCTYPE html> <html> <head><title>Envoy Proxy</title></head> <body> <h1>Envoy Proxy is running</h1> </body> </html>
-c - Run command inside the app container
Key Concept

If you remember nothing else from this pattern, remember: a sidecar proxy runs alongside your app to handle network tasks without changing your app code.

Common Mistakes
Not defining both the app and Envoy containers in the same Pod spec
The sidecar proxy must run in the same Pod to intercept traffic properly; separate Pods won't work as a sidecar.
Always include the Envoy container alongside your app container in the same Pod YAML.
Forgetting to expose or map the ports Envoy listens on
Without exposing Envoy's ports, traffic cannot be routed through the proxy.
Define the necessary container ports for Envoy in the Pod spec.
Not mounting the Envoy configuration file correctly
Envoy needs its config file to know how to route and manage traffic; missing config causes startup failure.
Use a ConfigMap and mount it properly into the Envoy container.
Summary
Create a Pod with both your app and Envoy sidecar proxy containers defined together.
Use kubectl commands to deploy the Pod, check its status, and view Envoy logs.
Test Envoy's proxy port from inside the Pod to confirm it is running and managing traffic.

Practice

(1/5)
1. What is the main purpose of a sidecar proxy like Envoy in a Kubernetes pod?
easy
A. To manage network traffic for the application without changing its code
B. To replace the main application container
C. To store application data persistently
D. To run database services inside the pod

Solution

  1. Step 1: Understand the role of sidecar proxies

    Sidecar proxies like Envoy run alongside the main app to handle network tasks such as routing, security, and monitoring.
  2. Step 2: Identify what sidecars do not do

    They do not replace the app, store data, or run databases; they only assist with traffic management.
  3. Final Answer:

    To manage network traffic for the application without changing its code -> Option A
  4. Quick Check:

    Sidecar proxy = traffic manager [OK]
Hint: Sidecar proxies help apps with traffic, not replace them [OK]
Common Mistakes:
  • Thinking sidecar replaces the app container
  • Confusing sidecar with storage or database
  • Assuming sidecar changes app code
2. Which of the following is the correct way to define a sidecar container for Envoy in a Kubernetes pod spec?
easy
A. containers: - name: app - image: envoyproxy/envoy
B. containers: - name: envoy - image: envoyproxy/envoy
C. containers: - name: envoy - image: nginx
D. containers: - name: envoyproxy - image: envoyproxy/envoy

Solution

  1. Step 1: Identify the correct container name and image

    The sidecar container should be named clearly (e.g., 'envoy') and use the official Envoy image 'envoyproxy/envoy'.
  2. Step 2: Check the options for correctness

    containers: - name: envoy - image: envoyproxy/envoy correctly names the container 'envoy' and uses the right image. containers: - name: app - image: envoyproxy/envoy misnames the container as 'app'. containers: - name: envoy - image: nginx uses the wrong image 'nginx'. containers: - name: envoyproxy - image: envoyproxy/envoy uses a different container name but correct image.
  3. Final Answer:

    containers: - name: envoy - image: envoyproxy/envoy -> Option B
  4. Quick Check:

    Envoy container name and image must match [OK]
Hint: Sidecar container name 'envoy' with image 'envoyproxy/envoy' [OK]
Common Mistakes:
  • Using wrong container name for Envoy
  • Using incorrect image like nginx
  • Mixing app container with sidecar container
3. Given a pod with two containers: an app and an Envoy sidecar proxy, what happens when the app sends a request to an external service?
medium
A. The request goes directly from the app container to the external service without passing Envoy.
B. The request is duplicated and sent twice, once by the app and once by Envoy.
C. The request is blocked by Kubernetes and never leaves the pod.
D. The request is intercepted and routed through the Envoy sidecar proxy before reaching the external service.

Solution

  1. Step 1: Understand Envoy's role as a sidecar proxy

    Envoy intercepts outbound requests from the app container to manage traffic, security, and monitoring.
  2. Step 2: Trace the request flow

    The app's request is routed through Envoy before reaching the external service, enabling control and visibility.
  3. Final Answer:

    The request is intercepted and routed through the Envoy sidecar proxy before reaching the external service. -> Option D
  4. Quick Check:

    Envoy intercepts outbound traffic [OK]
Hint: Envoy sidecar intercepts app traffic to external services [OK]
Common Mistakes:
  • Assuming app bypasses Envoy for external calls
  • Thinking Kubernetes blocks outbound requests
  • Believing requests are duplicated
4. You notice that your Envoy sidecar proxy is not forwarding traffic correctly. Which of the following is the most likely cause?
medium
A. The Kubernetes node is running out of CPU resources.
B. The app container image is outdated.
C. The Envoy container is missing required network permissions or capabilities.
D. The pod has only one container defined.

Solution

  1. Step 1: Analyze Envoy sidecar traffic issues

    Envoy needs proper network permissions (like NET_ADMIN) to intercept and forward traffic.
  2. Step 2: Evaluate other options

    App image version or node CPU issues may affect performance but not specifically Envoy forwarding. A pod with one container means no sidecar exists.
  3. Final Answer:

    The Envoy container is missing required network permissions or capabilities. -> Option C
  4. Quick Check:

    Envoy needs network permissions to forward traffic [OK]
Hint: Check Envoy network permissions if traffic not forwarded [OK]
Common Mistakes:
  • Blaming app container image for Envoy issues
  • Ignoring network capabilities needed by Envoy
  • Assuming pod must have one container only
5. You want to add an Envoy sidecar proxy to an existing Kubernetes deployment without changing the app code. Which approach is best to achieve this?
hard
A. Modify the deployment YAML to add an Envoy container in the pod spec as a sidecar
B. Replace the app container image with one that includes Envoy inside
C. Create a separate pod running Envoy and route traffic through it externally
D. Add an init container that installs Envoy inside the app container at startup

Solution

  1. Step 1: Understand sidecar pattern in Kubernetes

    Sidecars run as additional containers in the same pod, so modifying the pod spec to add Envoy is the standard way.
  2. Step 2: Evaluate alternatives

    Replacing app image changes code, separate pods lose pod-local benefits, and init containers run before app start and can't run sidecars.
  3. Final Answer:

    Modify the deployment YAML to add an Envoy container in the pod spec as a sidecar -> Option A
  4. Quick Check:

    Add Envoy as sidecar container in pod spec [OK]
Hint: Add Envoy container to pod spec, no app code change needed [OK]
Common Mistakes:
  • Replacing app image instead of adding sidecar
  • Using separate pods losing sidecar benefits
  • Misusing init containers for sidecar functionality