**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 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
<a name="hybrid-nodes-gateway-configuration"></a>

Cette page décrit tous les paramètres configurables pour la passerelle Amazon EKS Hybrid Nodes. Pour obtenir des instructions d’installation, consultez [Démarrez avec la passerelle EKS Hybrid Nodes](hybrid-nodes-gateway-getting-started.md). Pour un aperçu de la passerelle, voir[Passerelle Amazon EKS Hybrid Nodes](hybrid-nodes-gateway-overview.md).

## Valeurs du graphique Helm
<a name="hybrid-nodes-gateway-helm-values"></a>

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'`--set`indicateurs ou d'un `values.yaml` fichier personnalisé pendant `helm install` ou`helm 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. Lorsque`true`, 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
<a name="hybrid-nodes-gateway-install-examples"></a>

 **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
<a name="hybrid-nodes-gateway-auto-vs-mng"></a>

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, consultez[Démarrez avec la passerelle EKS Hybrid Nodes](hybrid-nodes-gateway-getting-started.md). 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
<a name="hybrid-nodes-gateway-leader-tuning"></a>

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
<a name="hybrid-nodes-gateway-leader-tuning-guidance"></a>
+  **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-deadline`Il 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.

## Rubriques en relation
<a name="hybrid-nodes-gateway-configuration-related"></a>
+  [Passerelle Amazon EKS Hybrid Nodes](hybrid-nodes-gateway-overview.md) 
+  [Démarrez avec la passerelle EKS Hybrid Nodes](hybrid-nodes-gateway-getting-started.md) 
+  [Opérations de la passerelle Amazon EKS Hybrid Nodes](hybrid-nodes-gateway-operations.md) 
+  [Résolution des problèmes de passerelle Amazon EKS Hybrid Nodes](hybrid-nodes-gateway-troubleshooting.md)