• Prerequisites
• Getting Started
  • Run a Docker Registry Locally
  • Enable Kubernetes on Docker Desktop for Mac/Windows
  • (Optional) Download the VSCode Kubernetes Extension
• How to Deploy an Application
  • Containerize Your Application
  • Write a Kubernetes Deployment
  • Write a Kubernetes Service
  • Deploy
    • Apply the Deployment and Service Manifests
    • Check if Service is Running
  • 🎉 Congratulations 🎉
• Cleanup
• Useful Commands
  • Set your default namespace so you don't accidentally push to default
  • View your current contexts (you probably have docker-desktop and a cloud provider)
  • Switch to the docker-desktop context
  • Run an Ubuntu container in the cluster to debug
• FAQ
  • I enabled Kubernetes in Docker for Desktop (Mac), but I can't access my NodePort. What do I do?

• Have Docker Desktop installed

First things first, startup your own local Docker Registry on localhost:5000 by doing:

docker-compose up

1. Click the Docker Desktop icon in the tray and select "preferences"
2. Click Kubernetes
3. Check "Enable Kubernetes"
4. Click "Apply & Restart"

If you use VS Code, download the Kubernetes extension. It provides you with documentation on hover for each of the fields in a Kubernetes manifest.

1. Write a Dockerfile for your app.
2. Build and tag your image and remember to:
   1. Prefix it with the domain name/port if you want to deploy to a registry that isn't docker.io.
   2. Version it with a git tag or the commit hash.
3. docker push the built image to a container registry.

1. Copy the frontend.deployment.yml for now since it is pretty basic and has comments describing it.
2. In the deployment.yml, make sure the container image name is set to the same name of the image that was sent to the container registry via docker push.
3. Ensure that there is a label called app and it has a name representing this deployment.

Note: VS Code users who've installed the Kubernetes extension have access to snippets for generating Kubernetes yaml manifests.

1. Copy the frontend.service.yml.
2. Ensure that the selector has the app label that was given to the deployment.

kubectl apply -f your-app.deployment.yml
kubectl apply -f your-app.service.yml

kubectl get svc

Your application is deployed! You may now access it on your own host.

Let's delete the Kubernetes objects that were created in the above steps.

The service can be deleted by doing:

kubectl delete service yourservicename

Note: If you are unsure of the service name, you can use kubectl get svc to find it.

You can delete the deployment by doing:

kubectl delete deployment yourdeploymentname

Note: If you are unsure of the deployment name, you can use kubectl get deployments to find it.

Kubernetes Cheatsheet

This is useful when you have a shared cluster in the cloud, and you have an assigned namespace that you wish to use.

kubectl config set-context --current --namespace=joe

Verify it!

kubectl config view | grep namespace

kubectl config get-contexts

kubectl config use-context docker-desktop

kubectl run -i --tty --rm debug --image=ubuntu --restart=Never -- bash

Restart your computer.