Skip to content

Commit

Permalink
Add docs on rootService for ALB traffic routing
Browse files Browse the repository at this point in the history
  • Loading branch information
dthomson25 committed Aug 13, 2020
1 parent addf2f4 commit d865444
Showing 1 changed file with 2 additions and 1 deletion.
3 changes: 2 additions & 1 deletion docs/features/traffic-management/alb.md
Original file line number Diff line number Diff line change
Expand Up @@ -64,10 +64,11 @@ spec:
alb:
ingress: ingress # required
servicePort: 443 # required
rootService: # optional
annotationPrefix: custom.alb.ingress.kubernetes.io # optional
```

The ingress field is a reference to an Ingress in the same namespace of the Rollout, and the servicePort field refers a port of a service. The Rollout requires the Ingress and servicePort to modify the ALB to route traffic to the stable and canary Services. Within the Ingress, looks for the stableService within the Ingress's rules and adds an action annotation for that the action. As the Rollout progresses through the Canary steps, the controller updates the Ingress's action annotation to reflect the desired state of the Rollout enabling traffic splitting between two different versions.
The ingress field is a reference to an Ingress in the same namespace of the Rollout, and the servicePort field refers a port of a service. The Rollout requires the Ingress and servicePort to modify the ALB to route traffic to the stable and canary Services. Within the Ingress, looks for the stableService (or the optional rootService if specified) within the Ingress's rules and adds an action annotation for that the action. As the Rollout progresses through the Canary steps, the controller updates the Ingress's action annotation to reflect the desired state of the Rollout enabling traffic splitting between two different versions.

Since the ALB Ingress controller allows users to configure the annotation prefix used by the Ingress controller, Rollouts can specify the optional `annotationPrefix` field. The Ingress uses that prefix instead of the default `alb.ingress.kubernetes.io` if the field set.

Expand Down

0 comments on commit d865444

Please sign in to comment.