Inizia a usare il gateway EKS Hybrid Nodes

Questa pagina illustra i prerequisiti, la preparazione dell'ambiente, l'installazione, la verifica e la rimozione del gateway Amazon EKS Hybrid Nodes. Per un'introduzione al gateway e alla sua architettura, consultaGateway Amazon EKS Hybrid Nodes.

Prerequisiti

Prima di installare il gateway Hybrid Nodes, verifica che l'ambiente soddisfi i seguenti requisiti:

Preparare i nodi gateway

Il gateway richiede almeno due nodi EC2 per un'elevata disponibilità. Esistono due opzioni di configurazione dei nodi supportate per il gateway:

Modalità EKS Auto (consigliata)

Quando si utilizza la modalità automatica EKS, è necessario creare un NodePool e NodeClass prima di installare il grafico Helm. Fornisce NodePool alle istanze EC2 le etichette e i colori corretti e verifica la configurazione. source/destination Non è necessario effettuare il provisioning o configurare manualmente i nodi.

Applica le seguenti risorse al cluster, sostituendo i valori segnaposto:

apiVersion: eks.amazonaws.com/v1
kind: NodeClass
metadata:
  name: hybrid-gateway
spec:
  advancedNetworking:
    sourceDestCheck: DisabledPrimaryENI
  role: YOUR_NODE_ROLE
  securityGroupSelectorTerms:
    - tags:
        aws:eks:cluster-name: YOUR_CLUSTER_NAME
  subnetSelectorTerms:
    - id: SUBNET_ID_1
    - id: SUBNET_ID_2
---
apiVersion: karpenter.sh/v1
kind: NodePool
metadata:
  name: hybrid-gateway
spec:
  template:
    metadata:
      labels:
        hybrid-gateway-node: "true"
    spec:
      expireAfter: 336h
      nodeClassRef:
        group: eks.amazonaws.com
        kind: NodeClass
        name: hybrid-gateway
      requirements:
        - key: karpenter.sh/capacity-type
          operator: In
          values:
            - on-demand
        - key: eks.amazonaws.com/instance-category
          operator: In
          values:
            - c
            - m
            - r
        - key: eks.amazonaws.com/instance-generation
          operator: Gt
          values:
            - "4"
        - key: kubernetes.io/arch
          operator: In
          values:
            - amd64
        - key: kubernetes.io/os
          operator: In
          values:
            - linux
      taints:
        - key: hybrid-gateway-node
          effect: NoSchedule
      terminationGracePeriod: 24h0m0s
  disruption:
    budgets:
      - nodes: 10%
    consolidateAfter: 30s
    consolidationPolicy: WhenEmptyOrUnderutilized

Campi chiave di questa configurazione:

Gruppi di nodi gestiti

Quando utilizzi gruppi di nodi gestiti, crea un gruppo di nodi dedicato per il gateway con le etichette e i taint richiesti e un modello di avvio personalizzato che disabiliti il source/destination controllo all'avvio.

Fase 1: creazione di un modello di avvio

Crea un modello di lancio con i dati utente che disabiliti il source/destination controllo sull'ENI principale all'avvio dell'istanza:

# Create the launch template with user data to disable source/dest check
USERDATA=$(cat <<'SCRIPT' | base64 -w 0
MIME-Version: 1.0
Content-Type: multipart/mixed; boundary="==BOUNDARY=="

--==BOUNDARY==
Content-Type: text/x-shellscript; charset="us-ascii"

#!/bin/bash
TOKEN=$(curl -s -X PUT "http://169.254.169.254/latest/api/token" \
  -H "X-aws-ec2-metadata-token-ttl-seconds: 60")
MAC=$(curl -s -H "X-aws-ec2-metadata-token: $TOKEN" \
  http://169.254.169.254/latest/meta-data/mac)
ENI_ID=$(curl -s -H "X-aws-ec2-metadata-token: $TOKEN" \
  "http://169.254.169.254/latest/meta-data/network/interfaces/macs/${MAC}/interface-id")
REGION=$(curl -s -H "X-aws-ec2-metadata-token: $TOKEN" \
  http://169.254.169.254/latest/meta-data/placement/region)

aws ec2 modify-network-interface-attribute \
  --network-interface-id "$ENI_ID" \
  --no-source-dest-check \
  --region "$REGION"

--==BOUNDARY==--
SCRIPT
)

aws ec2 create-launch-template \
  --launch-template-name YOUR_CLUSTER_NAME-gateway-lt \
  --launch-template-data "{\"UserData\":\"${USERDATA}\",\"MetadataOptions\":{\"HttpTokens\":\"required\",\"HttpPutResponseHopLimit\":2}}"

Fase 2: Creare il gruppo di nodi gestito

Crea un gruppo di nodi gestiti dedicato con l'etichetta del gateway, taint e il modello di avvio del passaggio 1:

aws eks create-nodegroup \
  --cluster-name YOUR_CLUSTER_NAME \
  --nodegroup-name YOUR_CLUSTER_NAME-gateway-nodes \
  --subnets SUBNET_ID_1 SUBNET_ID_2 \
  --node-role YOUR_NODE_ROLE_ARN \
  --instance-types INSTANCE_TYPE \
  --ami-type AL2023_x86_64_STANDARD \
  --scaling-config desiredSize=2,maxSize=2,minSize=2 \
  --labels hybrid-gateway-node=true \
  --taints "key=hybrid-gateway-node,effect=NO_SCHEDULE" \
  --launch-template "name=YOUR_CLUSTER_NAME-gateway-lt,version=1"

Questo crea un gruppo di nodi gestiti a 2 nodi in cui:

Utilizza sottoreti in diverse zone di disponibilità per un'elevata disponibilità.

Installa con Helm

Modalità automatica di EKS

Esegui il seguente comando per installare il gateway con EKS Auto Mode:

helm install eks-hybrid-nodes-gateway \
  oci://public.ecr.aws/eks/eks-hybrid-nodes-gateway \
  --version 1.0.0 \
  --namespace eks-hybrid-nodes-gateway \
  --create-namespace \
  --set vpcCIDR=VPC_CIDR \
  --set podCIDRs=POD_CIDRS \
  --set routeTableIDs=ROUTE_TABLE_IDS
         

Gruppi di nodi gestiti o nodi autogestiti

Per gruppi di nodi gestiti o nodi autogestiti, imposta: autoMode.enabled=false

helm install eks-hybrid-nodes-gateway \
  oci://public.ecr.aws/eks/eks-hybrid-nodes-gateway \
  --version 1.0.0 \
  --namespace eks-hybrid-nodes-gateway \
  --create-namespace \
  --set autoMode.enabled=false \
  --set vpcCIDR=VPC_CIDR \
  --set podCIDRs=POD_CIDRS \
  --set routeTableIDs=ROUTE_TABLE_IDS
         

Valori Helm obbligatori

I seguenti valori sono obbligatori per tutte le installazioni:

Per un elenco completo dei valori configurabili, vedere. Riferimento alla configurazione del gateway Amazon EKS Hybrid Nodes

Verifica dell'installazione

Dopo aver installato il gateway, verifica che sia funzionante e integro.

Controlla lo stato del pod

Verifica che due gateway pod siano in funzione:

kubectl get pods -n eks-hybrid-nodes-gateway

Dovresti vedere un risultato simile a:

NAME                                        READY   STATUS    RESTARTS   AGE
eks-hybrid-nodes-gateway-5d4f6a7b8c-abc12   1/1     Running   0          2m
eks-hybrid-nodes-gateway-5d4f6a7b8c-def34   1/1     Running   0          2m

Controlla l'elezione del leader

Verifica che un pod abbia acquisito il contratto di locazione elettorale per il leader:

kubectl get lease -n eks-hybrid-nodes-gateway

L'output mostra il leader corrente nella HOLDER colonna:

NAME                     HOLDER                                      AGE
hybrid-gateway-leader    eks-hybrid-nodes-gateway-5d4f6a7b8c-abc12   2m

Controlla l'endpoint di integrità

Verifica che l'endpoint di integrità risponda sul leader pod utilizzando il port forwarding:

kubectl port-forward -n eks-hybrid-nodes-gateway LEADER_POD_NAME 8088:8088 &
curl -s http://localhost:8088/healthz

Un gateway sano restituisce una risposta HTTP 200.

Verifica le voci della tabella di routing VPC

Nella console Amazon VPC o utilizzando l'interfaccia a riga di comando, verifica che le tabelle di routing VPC contengano voci per AWS i pod ibridi CIDR che puntano all'ENI dell'istanza gateway leader:

aws ec2 describe-route-tables \
  --route-table-ids ROUTE_TABLE_ID \
  --query "RouteTables[].Routes[?DestinationCidrBlock=='[.replaceable]`POD_CIDR`']"

Ogni pod ibrido CIDR deve avere un percorso NetworkInterfaceId impostato verso l'ENI primario dell'istanza leader.

Disinstallazione

Per rimuovere il gateway Hybrid Nodes, esegui:

helm uninstall eks-hybrid-nodes-gateway --namespace eks-hybrid-nodes-gateway

aws ec2 delete-route \
  --route-table-id ROUTE_TABLE_ID \
  --destination-cidr-block POD_CIDR
         

Fasi successive