Merge pull request #688 from chentao1596/udt-example
Add example of UDP loadbalancing
This commit is contained in:
Manuel Alejandro de Brito Fontes
GitHub
commit
83d8ba8e89
3 changed files with 140 additions and 0 deletions
80
examples/udp/nginx/README.md
Normal file
80
examples/udp/nginx/README.md
Normal file
|
|
@ -0,0 +1,80 @@
|
|||
# UDP loadbalancing
|
||||
|
||||
This example show how to implement UDP loadbalancing throught the Nginx Controller
|
||||
|
||||
## Prerequisites
|
||||
|
||||
You need a [Default Backend service](/examples/deployment/nginx/README.md#default-backend) and a [kube-dns service](https://github.com/kubernetes/kubernetes/tree/master/cluster/addons/dns#kube-dns) for this example
|
||||
```
|
||||
$ kubectl -n kube-system get svc
|
||||
NAMESPACE NAME CLUSTER-IP EXTERNAL-IP PORT(S) AGE
|
||||
kube-system default-http-backend 192.168.3.204 <none> 80/TCP 1d
|
||||
kube-system kube-dns 192.168.3.10 <none> 53/UDP,53/TCP 23h
|
||||
```
|
||||
|
||||
## Config UDP Service
|
||||
|
||||
To configure which services and ports will be exposed:
|
||||
```
|
||||
$ kubectl create -f nginx-udp-ingress-configmap.yaml
|
||||
configmap "nginx-udp-ingress-configmap" created
|
||||
|
||||
$ kubectl -n kube-system get configmap
|
||||
NAME DATA AGE
|
||||
extension-apiserver-authentication 1 1d
|
||||
kube-dns 0 1d
|
||||
nginx-udp-ingress-configmap 1 15m
|
||||
|
||||
$ kubectl -n kube-system describe configmap nginx-udp-ingress-configmap
|
||||
Name: nginx-udp-ingress-configmap
|
||||
Namespace: kube-system
|
||||
Labels: <none>
|
||||
Annotations: <none>
|
||||
|
||||
Data
|
||||
====
|
||||
9001:
|
||||
----
|
||||
kube-system/kube-dns:53
|
||||
```
|
||||
|
||||
The file `nginx-udp-ingress-configmap.yaml` uses a ConfigMap where the key is the external port to use and the value is
|
||||
`<namespace/service name>:<service port>`
|
||||
|
||||
## Deploy
|
||||
```
|
||||
$ kubectl create -f nginx-udp-ingress-controller.yaml
|
||||
replicationcontroller "nginx-udp-ingress-controller" created
|
||||
|
||||
$ kubectl -n kube-system get rc
|
||||
NAME DESIRED CURRENT READY AGE
|
||||
nginx-udp-ingress-controller 1 1 1 13m
|
||||
|
||||
$ kubectl -n kube-system describe rc nginx-udp-ingress-controller
|
||||
Name: nginx-udp-ingress-controller
|
||||
Namespace: kube-system
|
||||
Image(s): gcr.io/google_containers/nginx-ingress-controller:0.9.0-beta.5
|
||||
Selector: k8s-app=nginx-udp-ingress-lb
|
||||
Labels: k8s-app=nginx-udp-ingress-lb
|
||||
Annotations: <none>
|
||||
Replicas: 1 current / 1 desired
|
||||
Pods Status: 1 Running / 0 Waiting / 0 Succeeded / 0 Failed
|
||||
No volumes.
|
||||
Events:
|
||||
FirstSeen LastSeen Count From SubObjectPath Type Reason Message
|
||||
--------- -------- ----- ---- ------------- -------- ------ -------
|
||||
46s 46s 1 replication-controller Normal SuccessfulCreate Created pod: nginx-udp-ingress-controller-m0pjl
|
||||
|
||||
$ kubectl -n kube-system get po -o wide
|
||||
NAME READY STATUS RESTARTS AGE IP
|
||||
NAME READY STATUS RESTARTS AGE IP NODE
|
||||
default-http-backend-2198840601-5j1zc 1/1 Running 0 1d 172.16.45.3 10.114.51.28
|
||||
kube-dns-1874783228-nvs9f 3/3 Running 0 23h 172.16.10.3 10.114.51.217
|
||||
nginx-udp-ingress-controller-m0pjl 1/1 Running 0 1m 172.16.10.2 10.114.51.217
|
||||
```
|
||||
|
||||
## Test
|
||||
```
|
||||
$ nc -uzv 172.16.10.2 9001
|
||||
Connection to 172.16.10.2 9001 port [udp/*] succeeded!
|
||||
```
|
||||
7
examples/udp/nginx/nginx-udp-ingress-configmap.yaml
Normal file
7
examples/udp/nginx/nginx-udp-ingress-configmap.yaml
Normal file
|
|
@ -0,0 +1,7 @@
|
|||
apiVersion: v1
|
||||
kind: ConfigMap
|
||||
metadata:
|
||||
name: nginx-udp-ingress-configmap
|
||||
namespace: kube-system
|
||||
data:
|
||||
9001: "kube-system/kube-dns:53"
|
||||
53
examples/udp/nginx/nginx-udp-ingress-controller.yaml
Normal file
53
examples/udp/nginx/nginx-udp-ingress-controller.yaml
Normal file
|
|
@ -0,0 +1,53 @@
|
|||
apiVersion: v1
|
||||
kind: ReplicationController
|
||||
metadata:
|
||||
name: nginx-udp-ingress-controller
|
||||
labels:
|
||||
k8s-app: nginx-udp-ingress-lb
|
||||
namespace: kube-system
|
||||
spec:
|
||||
replicas: 1
|
||||
selector:
|
||||
k8s-app: nginx-udp-ingress-lb
|
||||
template:
|
||||
metadata:
|
||||
labels:
|
||||
k8s-app: nginx-udp-ingress-lb
|
||||
name: nginx-udp-ingress-lb
|
||||
spec:
|
||||
terminationGracePeriodSeconds: 60
|
||||
containers:
|
||||
- image: gcr.io/google_containers/nginx-ingress-controller:0.9.0-beta.5
|
||||
name: nginx-udp-ingress-lb
|
||||
readinessProbe:
|
||||
httpGet:
|
||||
path: /healthz
|
||||
port: 10254
|
||||
scheme: HTTP
|
||||
livenessProbe:
|
||||
httpGet:
|
||||
path: /healthz
|
||||
port: 10254
|
||||
scheme: HTTP
|
||||
initialDelaySeconds: 10
|
||||
timeoutSeconds: 1
|
||||
env:
|
||||
- name: POD_NAME
|
||||
valueFrom:
|
||||
fieldRef:
|
||||
fieldPath: metadata.name
|
||||
- name: POD_NAMESPACE
|
||||
valueFrom:
|
||||
fieldRef:
|
||||
fieldPath: metadata.namespace
|
||||
ports:
|
||||
- containerPort: 80
|
||||
hostPort: 80
|
||||
- containerPort: 443
|
||||
hostPort: 443
|
||||
- containerPort: 9001
|
||||
hostPort: 9001
|
||||
args:
|
||||
- /nginx-ingress-controller
|
||||
- --default-backend-service=$(POD_NAMESPACE)/default-http-backend
|
||||
- --udp-services-configmap=$(POD_NAMESPACE)/nginx-udp-ingress-configmap
|
||||
Loading…
Reference in a new issue