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

Stellen Sie vor der Installation des Hybrid Nodes Gateways sicher, dass Ihre Umgebung die folgenden Anforderungen erfüllt:

Bereiten Sie Gateway-Knoten vor

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

Automatischer EKS-Modus (empfohlen)

Wenn Sie den EKS-Automatikmodus verwenden, müssen Sie NodeClass vor der Installation des Helm-Diagramms ein NodePool und erstellen. Dadurch werden NodePool EC2-Instances mit den richtigen Labels, Taints und der korrekten source/destination Prüfkonfiguration ausgestattet. 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

Schlüsselfelder in dieser Konfiguration:

Verwaltete Knotengruppen

Wenn Sie verwaltete Knotengruppen verwenden, erstellen Sie eine spezielle 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 auf der primären ENI beim Starten 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, Taint 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 dem EKS-Automatikmodus 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

Legen Sie für verwaltete Knotengruppen oder selbstverwaltete Knoten Folgendes fest: 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 Vorsitzenden

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

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

Die Ausgabe zeigt den aktuellen Leader in der HOLDER Spalte:

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

Überprüfen Sie den Integritätsendpunkt

Stellen Sie mithilfe von 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-Routentabelle

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=='[.replaceable]`POD_CIDR`']"

Jeder Hybrid-Pod-CIDR sollte über eine Route verfügen, auf der die Verbindung zur primären ENI der Leader-Instance NetworkInterfaceId festgelegt ist.

Deinstallieren

Um das Hybrid Nodes Gateway zu entfernen, führen Sie folgenden Befehl 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