Link Search Menu Expand Document
Star

Getting started with Gefyra and kind

This guide will show you how to use Gefyra for the local development of a Kubernetes application running in kind.

Prerequisites

  1. Follow the installation for your preferred platform.

  2. Create a local Kubernetes cluster with kind like this: Create a file kind-config.yaml:

kind: Cluster
apiVersion: kind.x-k8s.io/v1alpha4
nodes:
- role: control-plane
  extraPortMappings:
  - containerPort: 31820
    hostPort: 31820
    protocol: udp

Run:

kind create cluster --config kind-config.yaml

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 --port 8000:80 --target deploy/hello-nginxdemo/hello-nginx
    

    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
    
  2. Remove the locally running Kubernetes cluster with kind delete cluster