Usa Service Annotations per configurare Network Load Balancer

Scopri come configurare Network Load Balancer (NLB) in Amazon EKS utilizzando le annotazioni del servizio Kubernetes. Questo argomento spiega le annotazioni supportate da EKS Auto Mode per personalizzare il comportamento NLB, tra cui accessibilità Internet, controlli di integrità, terminazione SSL/TLS e modalità di targeting IP.

Quando crei un servizio Kubernetes di tipo LoadBalancer in modalità automatica EKS, EKS effettua automaticamente il provisioning e configura un AWS Network Load Balancer in base alle annotazioni specificate. Questo approccio dichiarativo consente di gestire le configurazioni del bilanciamento del carico direttamente tramite i manifesti di Kubernetes, mantenendo l'infrastruttura come prassi di codice.

EKS Auto Mode gestisce il provisioning di Network Load Balancer per impostazione predefinita per tutti i servizi di tipo LoadBalancer : non è richiesta alcuna installazione o configurazione di controller aggiuntivi. La loadBalancerClass: eks.amazonaws.com/nlb specifica viene impostata automaticamente come impostazione predefinita del cluster, semplificando il processo di implementazione e mantenendo la compatibilità con i carichi di lavoro Kubernetes esistenti.

Nota

La modalità automatica EKS richiede i tag di sottorete per identificare le sottoreti pubbliche e private.

Se hai creato il cluster coneksctl, hai già questi tag.

Scopri come effettuare il Etichetta le sottoreti per la modalità automatica EKS.

Servizio di esempio

Per ulteriori informazioni sulla Service risorsa Kubernetes, consulta la documentazione di Kubernetes.

Consulta la risorsa di esempio riportata di seguito: Service

apiVersion: v1
kind: Service
metadata:
  name: echoserver
  annotations:
    # Specify the load balancer scheme as internet-facing to create a public-facing Network Load Balancer (NLB)
    service.beta.kubernetes.io/aws-load-balancer-scheme: internet-facing
spec:
  selector:
    app: echoserver
  ports:
    - port: 80
      targetPort: 8080
      protocol: TCP
  type: LoadBalancer
  # Specify the new load balancer class for NLB as part of EKS Auto Mode feature
  # For clusters with Auto Mode enabled, this field can be omitted as it's the default
  loadBalancerClass: eks.amazonaws.com/nlb

Annotazioni di uso comune

La tabella seguente elenca le annotazioni di uso comune supportate da EKS Auto Mode. Nota che EKS Auto Mode potrebbe non supportare tutte le annotazioni.

Suggerimento

Tutte le seguenti annotazioni devono avere il prefisso service.beta.kubernetes.io/

Campo	Descrizione	Esempio
aws-load-balancer-type	Speciifica il tipo di bilanciamento del carico. Utilizzare external per nuove distribuzioni.	external
aws-load-balancer-nlb-target-type	Speciifica se indirizzare il traffico verso le istanze del nodo o direttamente verso il pod. IPs Utilizzalo instance per implementazioni standard o ip per il routing diretto dei pod.	instance
aws-load-balancer-scheme	Controlla se il load balancer è interno o connesso a Internet.	internet-facing
aws-load-balancer-healthcheck-protocol	Protocollo Health check per il gruppo target. Le opzioni più comuni sono TCP (impostazione predefinita) oHTTP.	HTTP
aws-load-balancer-healthcheck-path	Il percorso HTTP per i controlli di integrità quando si utilizza il protocollo HTTP/HTTPS.	/healthz
aws-load-balancer-healthcheck-port	Porta utilizzata per i controlli sanitari. Può essere un numero di porta specifico otraffic-port.	traffic-port
aws-load-balancer-subnets	Speciifica in quali sottoreti creare il sistema di bilanciamento del carico. Può usare sottoreti o nomi. IDs	subnet-xxxx, subnet-yyyy
aws-load-balancer-ssl-cert	ARN del certificato SSL di Certificate Manager for AWS HTTPS/TLS.	arn:aws:acm:region:account:certificate/cert-id
aws-load-balancer-ssl-ports	Speciifica quali porte devono utilizzare SSL/TLS.	443, 8443
load-balancer-source-ranges	Intervalli CIDR autorizzati ad accedere al load balancer.	10.0.0.0/24, 192.168.1.0/24
aws-load-balancer-additional-resource-tags	AWS Tag aggiuntivi da applicare al load balancer e alle risorse correlate.	Environment=prod,Team=platform
aws-load-balancer-ip-address-type	Speciifica se il load balancer utilizza IPv4 o dual-stack (+). IPv4 IPv6	ipv4 o dualstack

Considerazioni

• È necessario aggiornare il ruolo Cluster IAM per abilitare la propagazione dei tag dalle risorse Kubernetes alle risorse Load AWS Balancer. Per ulteriori informazioni, consulta Tag personalizzati per le risorse EKS Auto AWS.

• Per informazioni sull'associazione di risorse a EKS Auto Mode o al Load AWS Balancer Controller autogestito, vedere. Riferimento per la migrazione

• Per informazioni sulla risoluzione dei problemi con i sistemi di bilanciamento del carico, consulta. Risoluzione dei problemi relativi alla modalità automatica EKS

• Per ulteriori considerazioni sull'utilizzo della funzionalità di bilanciamento del carico di EKS Auto Mode, vedere. Bilanciamento del carico

Durante la migrazione alla modalità automatica EKS per il bilanciamento del carico, sono necessarie diverse modifiche nelle annotazioni dei servizi e nelle configurazioni delle risorse. Le tabelle seguenti descrivono le differenze principali tra le implementazioni precedenti e quelle nuove, incluse le opzioni non supportate e le alternative consigliate.

Annotazioni di servizio

Precedente	Novità	Descrizione
service.beta.kubernetes.io/load-balancer-source-ranges	Non supportato	Usa spec.loadBalancerSourceRanges sul servizio
service.beta.kubernetes.io/aws-load-balancer-type	Non supportato	Uso spec.loadBalancerClass sul servizio
service.beta.kubernetes.io/aws-load-balancer-internal	Non supportato	Utilizzare service.beta.kubernetes.io/aws-load-balancer-scheme
Vari attributi del sistema di bilanciamento del carico	Non supportato	Utilizzare service.beta.kubernetes.io/aws-load-balancer-attributes
service.beta.kubernetes.io/aws-load-balancer-proxy-protocol	Non supportato	Usa invece service.beta.kubernetes.io/aws-load-balancer-attributes
service.beta.kubernetes.io/aws-load-balancer-access-log-enabled	Non supportato	Usa service.beta.kubernetes.io/aws-load-balancer-attributes invece
service.beta.kubernetes.io/aws-load-balancer-access-log-s3-bucket-name	Non supportato	Usa service.beta.kubernetes.io/aws-load-balancer-attributes invece
service.beta.kubernetes.io/aws-load-balancer-access-log-s3-bucket-prefix	Non supportato	Usa service.beta.kubernetes.io/aws-load-balancer-attributes invece
service.beta.kubernetes.io/aws-load-balancer-cross-zone-load-balancing-enabled	Non supportato	Usa service.beta.kubernetes.io/aws-load-balancer-attributes invece

Per migrare dalle annotazioni degli attributi di bilanciamento del carico obsolete, consolida queste impostazioni nell'annotazione. service.beta.kubernetes.io/aws-load-balancer-attributes Questa annotazione accetta un elenco separato da virgole di coppie chiave-valore per vari attributi del bilanciamento del carico. Ad esempio, per specificare il protocollo proxy, la registrazione degli accessi e il bilanciamento del carico tra zone, utilizzate il seguente formato:

service.beta.kubernetes.io/aws-load-balancer-attributes: |
  access_logs.s3.enabled=true
  access_logs.s3.bucket=my-bucket
  access_logs.s3.prefix=my-prefix
  load_balancing.cross_zone.enabled=true

service.beta.kubernetes.io/aws-load-balancer-target-group-attributes: |
  proxy_protocol_v2.enabled=true

Questo formato consolidato offre un modo più coerente e flessibile per configurare gli attributi del bilanciamento del carico riducendo al contempo il numero di singole annotazioni necessarie. Rivedi le configurazioni del servizio esistenti e aggiornale per utilizzare questo formato consolidato.

TargetGroupBinding

Precedente	Novità	Descrizione
elbv2.k8s.aws/v1beta1	eks.amazonaws.com/v1	Modifica della versione dell'API
spec.targetTypeopzionale	spec.targetTyperichiesto	Specificazione esplicita del tipo di destinazione
spec.networking.ingress.from	Non supportato	Non supporta più NLB senza gruppi di sicurezza