Remote Clouds

Gefyra on SysEleven MetaKube

Use Gefyra with SysEleven MetaKube — European managed Kubernetes with OpenStack/Octavia load balancers for WireGuard connectivity.

Prerequisites

  1. You have a MetaKube account and privileges to create a new cluster
  2. Follow the installation of Gefyra for your preferred platform

Setup a cluster

You may follow this guide to create a cluster using the MetaKube management console.

This guide assumes you are running an OpenStack-based Kubernetes cluster on SysEleven.

Important: Before Gefyra can connect from outside the cluster, you must set the security group of the nodes to allow UDP traffic on port 31820.

Please set the direction to Ingress and the protocol to UDP. The port range should be set to 31820 and the source CIDR to 0.0.0.0/0. That way, Gefyra can connect to any data plane node of the cluster using a Floating-IP.

After all of the MetaKube components are ready, you can download the kubeconfig to access the cluster using kubectl. Just click on the "Download Config" button in the MetaKube management console and save the file to your local machine.

Running Gefyra

  1. You may apply some workload, for example from Gefyra's testing directory:
kubectl apply -f https://raw.githubusercontent.com/gefyrahq/gefyra/main/testing/workloads/hello_dd.yaml
  1. At first, we need a host IP of one of our nodes. You can get it by running:
kubectl get nodes -o wide |  awk {'print $1" " $2 " " $7'} | column -t

Pick one of them from the EXTERNAL-IP column.

  1. Now you can run
gefyra up --host <IP>

using the IP you just picked. This will create the Gefyra components in your cluster and local host.

  1. Run a local container with Gefyra (Zero Image Build):
# 1. Create a local response file
mkdir -p /tmp/local-server
echo "<h1>Hello from Gefyra. Live local code served directly into SysEleven!</h1>" > /tmp/local-server/index.html

# 2. Run the local container in Gefyra
gefyra run \
  -i python:3.12-alpine \
  -N mypyserver \
  -v /tmp/local-server:/app \
  -c "python3 -m http.server 8000 -d /app" \
  -d
  1. Exec into the running container and verify cluster access:
docker exec -it mypyserver sh
wget -O- hello-nginx
exit
  1. Mount the workload and create a bridge to redirect traffic to your local container:
# 1. Mount the deployment with Carrier2
gefyra mount create --target deployment/hello-nginxdemo/hello-nginx --name mymount

# 2. Bridge traffic to your local container
gefyra bridge create --mount mymount -p 80:8000 -t mypyserver --match-path-prefix /
  1. List active mounts and bridges:
gefyra bridge list
gefyra mount list
  1. Remove the bridge and unmount the workload to reset the cluster:
# Delete the bridge
gefyra bridge delete <bridge-id>

# Unmount the workload and restore original container image
gefyra mount delete mymount

Cleaning up

Remove Gefyra's components from the cluster with gefyra down