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.
Sticky Session
Voyager 3.2.0+ can configure sticky connections in 2 modes. By applying annotation to an Ingress resource, you can configure all backends in that ingress to use sticky session. Or you can apply annotation to a service and configure backends using that service to use sticky session.
ingress.appscode.com/sticky-session annotations is deprecated in voyager 4.0.0+ and removed in 7.1.1+. Use ingress.appscode.com/affinity instead.
Sticky Ingress
Applying annotation ingress.appscode.com/affinity to Ingress will configure all backends to support sticky session.
apiVersion: voyager.appscode.com/v1beta1
kind: Ingress
metadata:
name: test-ingress
namespace: default
annotation:
ingress.appscode.com/affinity: 'cookie'
spec:
rules:
- host: foo.bar.com
http:
paths:
- backend:
serviceName: s1
servicePort: '80'
- host: bar.foo.com
http:
paths:
- backend:
serviceName: s2
servicePort: '80'
- host: tcp.bar.com
tcp:
port: '9898'
backend:
serviceName: tcp-service
servicePort: '50077'
For the above ingress, all three backend connections will be sticky.
Sticky Service
Applying annotation ingress.appscode.com/affinity to a service will configures any backend
that uses that service to use sticky connection. As an example, the following Ingress will only
configure sticky connections for backends that use s1 Service.
kind: Service
apiVersion: v1
metadata:
name: s1
namespace: default
annotations:
ingress.appscode.com/affinity: 'cookie'
spec:
selector:
app: app
ports:
- name: http
protocol: TCP
port: 80
targetPort: 9376
- name: ops
protocol: TCP
port: 5050
targetPort: 5089
apiVersion: voyager.appscode.com/v1beta1
kind: Ingress
metadata:
name: test-ingress
namespace: default
spec:
rules:
- host: foo.bar.com
http:
paths:
- path: /admin
backend:
serviceName: s1 # Sticky, since service s1 is annotated
servicePort: '5050'
- path: /
backend:
serviceName: s1 # Sticky, since service s1 is annotated
servicePort: '80'
- host: bar.foo.com
http:
paths:
- backend:
serviceName: s2 # Not sticky
servicePort: '80'
- host: tcp.bar.com
tcp:
port: '9898'
backend:
serviceName: tcp-service # Not sticky
servicePort: '50077'
Other Annotations
ingress.appscode.com/session-cookie-name: When affinity is set tocookie, the name of the cookie to use.ingress.appscode.com/session-cookie-hash: When affinity is set tocookie, the hash algorithm used: md5, sha, index.