View a markdown version of this page

Référence de configuration de la passerelle Amazon EKS Hybrid Nodes - Amazon EKS

Aidez à améliorer cette page

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Pour contribuer à ce guide de l'utilisateur, cliquez sur le GitHub lien Modifier cette page sur qui se trouve dans le volet droit de chaque page.

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Référence de configuration de la passerelle Amazon EKS Hybrid Nodes

Cette page décrit tous les paramètres configurables pour la passerelle Amazon EKS Hybrid Nodes. Pour obtenir des instructions d’installation, consultez Commencez avec la passerelle EKS Hybrid Nodes. Pour un aperçu de la passerelle, voirPasserelle Amazon EKS Hybrid Nodes.

Valeurs du graphique Helm

Le tableau suivant répertorie toutes les valeurs du graphique de eks-hybrid-nodes-gateway Helm. Vous pouvez définir ces valeurs à l'aide d'--setindicateurs ou d'un values.yaml fichier personnalisé pendant helm install ouhelm upgrade.

Value Type Par défaut Obligatoire Description

image.repository

chaîne

public.ecr.aws/eks/eks-hybrid-nodes-gateway

Non

Référentiel d'images de conteneur pour l'image de passerelle. Par défaut, c'est le registre public Amazon ECR.

image.tag

chaîne

Graphique appVersion

Non

Balise d'image. La valeur par défaut est appVersion définie dans. Chart.yaml

image.pullPolicy

chaîne

IfNotPresent

Non

Politique d'extraction d'images Valeurs valides : Always, IfNotPresent, Never.

replicas

entier

2

Non

Nombre de répliques de pods de passerelle. Deux répliques sont la configuration recommandée pour une haute disponibilité dans les environnements de production.

nodeLabel

chaîne

hybrid-gateway-node

Non

Clé d'étiquette de nœud utilisée pour sélectionner les nœuds de passerelle. Cette étiquette doit être définie sur les nœuds"true".

vpcCIDR

chaîne

""

Oui

Bloc d'adresse CIDR VPC utilisé pour la configuration VTEP de Cilium. Exemple: 10.0.0.0/16.

podCIDRs

chaîne

""

Oui

Comma-separated liste des pods CIDR utilisés par Cilium sur les nœuds hybrides. Exemple: 10.85.0.0/16,10.86.0.0/16.

routeTableIDs

chaîne

""

Oui

Comma-separated liste des ID de tables de routage VPC à programmer avec des routes de pods hybrides. Exemple: rtb-0123456789abcdef0,rtb-0123456789abcdef1.

autoMode.enabled

boolean

true

Non

Activez l'intégration du mode automatique EKS. Lorsquetrue, le graphique ajoute un sélecteur de eks.amazonaws.com/compute-type: auto nœuds et utilise une stratégie de mise à jour continue sans interruption de service. Défini sur false pour les groupes de nœuds gérés ou les nœuds autogérés.

Exemples de commandes d'installation

Mode automatique EKS (par défaut) :

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

Groupes de nœuds gérés ou nœuds autogérés :

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

Configuration en mode automatique et configuration de groupes de nœuds gérés

La valeur autoMode.enabled Helm contrôle deux comportements dans le modèle de déploiement :

Comportement autoMode.enabled=true (par défaut) autoMode.enabled=false

Sélecteur de nœuds

Ajoute eks.amazonaws.com/compute-type: auto en plus de l'étiquette du nœud de passerelle.

Utilise uniquement l'étiquette du nœud de passerelle (hybrid-gateway-node: "true").

Stratégie de mise à jour continue

maxSurge: 1, maxUnavailable: 0 — garantit l'absence de temps d'arrêt lors des mises à niveau en démarrant un nouveau pod avant de mettre fin à l'ancien.

maxSurge: 0, maxUnavailable: 1 — met fin à l'ancien pod avant d'en démarrer un nouveau, car la capacité du nœud est préprovisionnée.

Lorsque vous utilisez le mode automatique EKS, vous devez créer un NodePool et NodeClass avant d'installer le graphique Helm. Ils NodePool approvisionnent les instances EC2 avec les étiquettes, les taches et source/destination vérifient la configuration appropriées. Pour le code YAML requis, consultezCommencez avec la passerelle EKS Hybrid Nodes. Lorsque vous utilisez des groupes de nœuds gérés ou des nœuds autogérés, vous devez provisionner et étiqueter les nœuds vous-même avant d'installer le graphique.

Pour toutes les cibles de déploiement, le déploiement utilise hostNetwork: true et requiert la NET_ADMIN fonctionnalité. L'anti-affinité des pods garantit que les deux pods de passerelle s'exécutent sur des nœuds distincts.

Réglage de l'élection des leaders

La passerelle utilise l'élection du Lease-based leader de Kubernetes pour maintenir un modèle de veille active. Les paramètres par défaut sont réglés pour un basculement rapide :

Paramètre Par défaut Description

--leader-election-lease-duration

3s

Combien de temps un non-dirigeant attend après le dernier renouvellement de bail observé avant de tenter d'acquérir le bail. Des valeurs plus faibles détectent plus rapidement les défaillances du leader, mais augmentent le risque de faux basculements lors de problèmes réseau transitoires.

--leader-election-renew-deadline

2s

Temps maximum que le dirigeant actif passe à essayer de renouveler le bail avant de renoncer à son leadership. Doit être inférieur à la durée du bail.

--leader-election-retry-period

1s

Fréquence à laquelle les candidats réessayent d'acquérir ou de renouveler le bail.

Avec les valeurs par défaut, le temps de basculement attendu en cas de défaillance de la passerelle active est d'environ 3 à 5 secondes. Cela inclut le temps nécessaire au service de secours pour détecter l'expiration du bail, acquérir le bail et exécuter la séquence de configuration principale (mises à jour de la table de routage VPC et configuration VTEP de Cilium).

Quand ajuster les paramètres d'élection du leader

  • Augmentez la durée du bail si vous observez de fréquentes transitions de leaders causées par une latence réseau transitoire entre les pods de passerelle et le serveur d'API Kubernetes.

  • Réduisez la durée du bail si vous avez besoin d'une détection de basculement plus rapide et si votre réseau entre les nœuds de passerelle et le serveur d'API est fiable et présente une faible latence.

  • Augmentez la période de tentatives pour réduire la charge du serveur d'API due à l'élection du leader dans les grands clusters.

Note

--leader-election-renew-deadlineIl doit toujours être inférieur à--leader-election-lease-duration. Si la date limite de renouvellement dépasse la durée du bail, le dirigeant peut perdre le bail avant qu'il ne puisse le renouveler.