So konfigurieren Sie UDP-Dienste mit Kong API Gateway

Seit Version 2.2 unterstützt Kong API Gateway UDP-Dienste, aber die Dokumentation illustriert dies mit einer sehr komplexen Kubernetes-Einrichtung. In diesem Blog zeige ich Ihnen den einfachsten Weg, einen UDP-Dienst zu konfigurieren. Ohne Umschweife: Um einen UDP-Dienst in Kong zu konfigurieren, müssen Sie nur drei Dinge tun:

1. einen Kong-Dienst mit dem udp-Protokoll definieren
2. eine Kong-Route mit dem udp-Protokoll definieren
3. Kong so konfigurieren, dass er auf UDP hört. In diesem Setup werde ich die Google DNS-Nameserver als UDP-Dienst konfigurieren und den Datenverkehr von localport 5353 weiterleiten.

kong udp dienst definieren

Um den kong UDP-Dienst zu definieren, geben Sie ein:

$ curl -sS --fail 
     -X POST http://localhost:8001/services 
     -d name=google-dns 
     -d protocol=udp 
     -d host=8.8.8.8 
     -d port=53

kong udp route definieren

Um die kong UDP-Route zum Dienst zu definieren, geben Sie ein:

curl -sS --fail  
     -X POST http://localhost:8001/services/google-dns/routes 
     -H 'Content-Type: application/json' 
     -d '{"protocols": [ "udp"], "destinations": [{"port": 5353}]}'

Kong so konfigurieren, dass er auf UDP hört

Um Kong so zu konfigurieren, dass es auf UDP hört, starten Sie kong mit der Eigenschaft stream_listen:

KONG_STREAM_LISTEN="0.0.0.0:5353 udp" kong ...

Bonus Protokollierung aktivieren

Um die Protokollierung von udp-Anfragen zu aktivieren, müssen Sie auch das udp-Protokoll im Plugin konfigurieren.

curl -sS --fail 
    -X POST http://localhost:8001/plugins 
    --data name=file-log 
    --data protocols=udp 
    --data protocols=http 
    --data protocols=https 
    --data config.path=/tmp/request.log

Fazit

Die Anleitung zur Verwendung von UDP in Kong ist eher eine Anleitung zur Komplexität von Kubernetes. In diesem Blog zeige ich Ihnen, wie einfach es wirklich ist! Bild von Gerd Altmann von Pixabay