You are looking at the documentation of a prior release. To read the documentation of the latest release, please
visit here.
New to Voyager? Please start here.
Forward Traffic to StatefulSet
Forward Traffic to all Pods of a StatefulSet
There is the usual way of forwarding traffic to a Service matching a StatefulSet. Create a Service with the pods label selector as selector, and use the service name as Backend ServiceName.
apiVersion: apps/v1
kind: StatefulSet
metadata:
name: http
spec:
serviceName: "nginx-set"
replicas: 2
template:
metadata:
labels:
app: nginx
spec:
containers:
- name: nginx
image: gcr.io/google_containers/nginx-slim:0.8
ports:
- containerPort: 80
name: http
----
apiVersion: v1
kind: Service
metadata:
name: nginx-set
labels:
app: nginx
spec:
ports:
- port: 80
name: http
clusterIP: None
selector:
app: nginx
Create another service for StatefulSets pods with selector.
apiVersion: v1
kind: Service
metadata:
name: nginx-service
labels:
app: nginx
spec:
ports:
- port: 80
name: http
selector:
app: nginx
And Use the service in the ingress Backend service name, as:
backend:
serviceName: nginx-service
servicePort: '80'
That will forward traffic to your StatefulSets Pods.
Forward Traffic to specific Pods of a StatefulSet
There is a way to send traffic to all or specific pod of a StatefulSet using voyager. You can set hostNames field in Backend, traffic will only forwarded to those pods.
For Example the above StatefulSet will create two pod.
web-0
web-1
Those are the host names.
Now Create a ingress that will only forward traffic to web-0
apiVersion: voyager.appscode.com/v1beta1
kind: Ingress
metadata:
name: test-ingress
namespace: default
spec:
rules:
- host: appscode.example.com
http:
paths:
- path: '/testPath'
backend:
hostNames:
- web-0
serviceName: nginx-set #! There is no extra service. This
servicePort: '80' # is the Statefulset's Headless Service
Viola. Now all /testPath traffic will be sent to pod web-0 only. There is no extra service also.
The StatefulSet’s Headless Service is enough. By using all the hostNames You can forward traffic to all pods.