Skip to content

Commit a8c1ff3

Browse files
committed
Documented additional AWS Service annotations
1 parent b6ed75c commit a8c1ff3

File tree

1 file changed

+33
-2
lines changed

1 file changed

+33
-2
lines changed

docs/concepts/services-networking/service.md

Lines changed: 33 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -466,9 +466,9 @@ metadata:
466466
{% capture azure %}
467467
```yaml
468468
[...]
469-
metadata:
469+
metadata:
470470
name: my-service
471-
annotations:
471+
annotations:
472472
service.beta.kubernetes.io/azure-load-balancer-internal: "true"
473473
[...]
474474
```
@@ -512,6 +512,37 @@ ELB at the other end of its connection) when forwarding requests.
512512
TCP and SSL will select layer 4 proxying: the ELB will forward traffic without
513513
modifying the headers.
514514

515+
In a mixed-use environment where some ports are secured and others are left unencrypted,
516+
the following annotations may be used:
517+
518+
```yaml
519+
metadata:
520+
name: my-service
521+
annotations:
522+
service.beta.kubernetes.io/aws-load-balancer-backend-protocol: http
523+
service.beta.kubernetes.io/aws-load-balancer-ssl-ports: "443,8443"
524+
```
525+
526+
In the above example, if the service contained three ports, `80`, `443`, and
527+
`8443`, then `443` and `8443` would use the SSL certificate, but `80` would just
528+
be proxied HTTP.
529+
530+
#### PROXY protocol support on AWS
531+
532+
To enable [PROXY protocol](https://www.haproxy.org/download/1.8/doc/proxy-protocol.txt)
533+
support for clusters running on AWS, you can use the following service
534+
annotation:
535+
536+
```yaml
537+
metadata:
538+
name: my-service
539+
annotations:
540+
service.beta.kubernetes.io/aws-load-balancer-proxy-protocol: "*"
541+
```
542+
543+
Since version 1.3.0 the use of this annotation applies to all ports proxied by the ELB
544+
and cannot be configured otherwise.
545+
515546
### External IPs
516547

517548
If there are external IPs that route to one or more cluster nodes, Kubernetes services can be exposed on those

0 commit comments

Comments
 (0)