From fc444b259c203f2d144bebc1f19e7b6cdffded71 Mon Sep 17 00:00:00 2001 From: Adrian Stobbe Date: Tue, 11 Jul 2023 18:14:13 +0200 Subject: [PATCH] doc AWS internet LB + add to LB test --- .github/actions/e2e_lb/lb.yml | 2 ++ docs/docs/workflows/aws-lb-service.md | 5 +++++ 2 files changed, 7 insertions(+) create mode 100644 docs/docs/workflows/aws-lb-service.md diff --git a/.github/actions/e2e_lb/lb.yml b/.github/actions/e2e_lb/lb.yml index a5a48fab1..7d0924d26 100644 --- a/.github/actions/e2e_lb/lb.yml +++ b/.github/actions/e2e_lb/lb.yml @@ -3,6 +3,8 @@ kind: Service metadata: name: whoami namespace: lb-test + annotations: + service.beta.kubernetes.io/aws-load-balancer-scheme: internet-facing spec: selector: app: whoami diff --git a/docs/docs/workflows/aws-lb-service.md b/docs/docs/workflows/aws-lb-service.md new file mode 100644 index 000000000..c4894bf12 --- /dev/null +++ b/docs/docs/workflows/aws-lb-service.md @@ -0,0 +1,5 @@ +# Internet-facing LB service on AWS + +To expose your application service externally you might want to use a Kubernetes Service of type `LoadBalancer`. On AWS, load-balancing is achieved through the [AWS Load Balancing Controller](https://kubernetes-sigs.github.io/aws-load-balancer-controller) as in the managed EKS. + +Since recent versions, the controller deploy an internal LB by default requiring to set an annotation `service.beta.kubernetes.io/aws-load-balancer-scheme: internet-facing` in order to have an internet-facing LB. For more details, see the [official docs](https://kubernetes-sigs.github.io/aws-load-balancer-controller/v2.2/guide/service/nlb/).