Erste Schritte mit dem EKS Hybrid Nodes Gateway

Diese Seite führt Sie durch die Voraussetzungen, die Vorbereitung der Umgebung, die Installation, Überprüfung und Deinstallation des Amazon EKS Hybrid Nodes Gateways. Eine Einführung in das Gateway und seine Architektur finden Sie unterAmazon EKS-Gateway für Hybridknoten.

Voraussetzungen

Bevor Sie das Hybrid Nodes Gateway installieren, stellen Sie sicher, dass Ihre Umgebung die folgenden Anforderungen erfüllt:

Bereiten Sie Gateway-Knoten vor

Das Gateway benötigt mindestens zwei EC2-Knoten für eine hohe Verfügbarkeit. Es gibt zwei unterstützte Knotenkonfigurationsoptionen für das Gateway:

EKS-Automatikmodus (empfohlen)

Wenn Sie den EKS-Automatikmodus verwenden, müssen Sie NodeClass vor der Installation des Helm-Diagramms ein NodePool Band erstellen. Das stellt NodePool EC2-Instances die richtigen Labels, Taints und source/destination Checkkonfigurationen zur Verfügung. Sie müssen Knoten nicht manuell bereitstellen oder konfigurieren.

Wenden Sie die folgenden Ressourcen auf Ihren Cluster an und ersetzen Sie dabei die Platzhalterwerte:

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

Wichtige Felder in dieser Konfiguration:

Verwaltete Knotengruppen

Wenn Sie verwaltete Knotengruppen verwenden, erstellen Sie eine dedizierte Knotengruppe für das Gateway mit den erforderlichen Labels, Taints und einer benutzerdefinierten Startvorlage, die die source/destination Überprüfung beim Start deaktiviert.

Schritt 1: Eine Startvorlage erstellen

Erstellen Sie eine Startvorlage mit Benutzerdaten, die die source/destination Überprüfung der primären ENI beim Booten der Instance deaktiviert:

# 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}}"

Schritt 2: Erstellen Sie die verwaltete Knotengruppe

Erstellen Sie eine dedizierte verwaltete Knotengruppe mit dem Gateway-Label, dem Tint und der Startvorlage aus Schritt 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"

Dadurch wird eine verwaltete Knotengruppe mit 2 Knoten erstellt, in der:

Verwenden Sie Subnetze in verschiedenen Availability Zones für hohe Verfügbarkeit.

Installation mit Helm

EKS Auto Mode

Führen Sie den folgenden Befehl aus, um das Gateway mit EKS Auto Mode zu installieren:

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
         

Verwaltete Knotengruppen oder selbstverwaltete Knoten

Stellen Sie für verwaltete Knotengruppen oder selbstverwaltete Knoten Folgendes ein: 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
         

Erforderliche Helm-Werte

Die folgenden Werte sind für alle Installationen erforderlich:

Eine vollständige Liste der konfigurierbaren Werte finden Sie unterReferenz zur Konfiguration des Amazon EKS Hybrid Nodes Gateways.

Überprüfen der Installation

Stellen Sie nach der Installation des Gateways sicher, dass es läuft und fehlerfrei ist.

Überprüfen Sie den Pod-Status

Vergewissern Sie sich, dass zwei Gateway-Pods laufen:

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

Sie sollten eine Ausgabe sehen, die der folgenden ähnelt:

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

Überprüfen Sie die Wahl des Führers

Vergewissern Sie sich, dass ein Team den Leasingvertrag für die Wahl des Leaders erworben hat:

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

Die Ausgabe zeigt den aktuellen Leader in der folgenden HOLDER Spalte an:

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

Überprüfen Sie den Gesundheitsendpunkt

Stellen Sie mithilfe der Portweiterleitung sicher, dass der Integritätsendpunkt auf dem Leader-Pod reagiert:

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

Ein fehlerfreies Gateway gibt eine HTTP 200-Antwort zurück.

Überprüfen Sie die Einträge in der VPC-Routing-Tabelle

Vergewissern Sie sich in der Amazon VPC-Konsole oder mithilfe der AWS CLI, dass Ihre VPC-Routing-Tabellen Einträge für die Hybrid-Pod-CIDRs enthalten, die auf die ENI der Leader-Gateway-Instance verweisen:

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

Jeder Hybrid-Pod-CIDR sollte eine Route haben, bei der die primäre ENI der NetworkInterfaceId Leader-Instance angegeben ist.

Deinstallieren

Um das Hybrid Nodes Gateway zu entfernen, führen Sie Folgendes aus:

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
         

Nächste Schritte