Skip to main content Link Search Menu Expand Document (external link)
Star

Getting started with Gefyra and Docker Desktop Kubernetes on MacOS

This example is really similar to the k3d getting started guide. However, Docker Desktop’s Kubernetes comes with some specialities which must be taken care of to make this guide work.

Note: Gefyra works the same for different Kubernetes distributions. Docker Desktop doesn’t come with an ingress installed which must be added to the cluster to get things working.

You can easily try Gefyra yourself following this small example.

Prerequisites

  1. Follow the installation for MacOS.

  2. Start the Kubernetes cluster that comes with Docker Desktop. This may take moment.

docker desktop kubernetes settings
  1. Tell kubectl to use your docker-desktop cluster:
    kubectl config use-context docker-desktop
    
  2. Install an ingress to enable routing for the cluster. For this guide we use the nginx ingress controller like this:
    kubectl apply -f https://raw.githubusercontent.com/kubernetes/ingress-nginx/controller-v1.2.1/deploy/static/provider/cloud/deploy.yaml
    
  3. Now patch the nginx ingress controller service to make port 8080 available:
    kubectl patch svc -n ingress-nginx ingress-nginx-controller -p '{"spec": {"ports": [{"appProtocol": "http", "name": "http", "port": 8080, "protocol": "TCP", "targetPort": "http"}]}}' --type merge
    
  4. Apply some workload, for example from the testing directory of this repo:
    kubectl apply -f https://raw.githubusercontent.com/gefyrahq/gefyra/main/testing/workloads/hello_dd.yaml
    

    Check out this workload running under: http://hello.127.0.0.1.nip.io:8080/

Running Gefyra

  1. Set up Gefyra with gefyra up
  2. Run a local Docker image with Gefyra in order to make it part of the cluster.
    1. Build your Docker image with a local tag, for example from the testing directory: cd testing/images/ && docker build -f Dockerfile.local . -t pyserver
    2. Execute Gefyra’s run command:
      gefyra run -i pyserver -N mypyserver -n default
    3. Exec into the running container and look around. You will find the container to run within your Kubernetes cluster.
      docker exec -it mypyserver bash
      wget -O- hello-nginx will print out the website of the cluster service hello-nginx from within the cluster.
  3. Create a bridge in order to intercept the traffic to the cluster application with the one running locally:
    gefyra bridge -N mypyserver -n default --deployment hello-nginxdemo --port 8000:80 --container-name hello-nginx -I mypybridge
    Check out the locally running server comes up under: http://hello.127.0.0.1.nip.io:8080/
  4. List all running bridges:
    gefyra list --bridges
  5. Unbridge the local container and reset the cluster to its original state: gefyra unbridge -N mypybridge Check out the initial response from: http://hello.127.0.0.1.nip.io:8080/

Cleaning up

  1. Remove Gefyra’s components from the cluster with gefyra down