Tous les produits
Search
Centre de documentation

Container Service for Kubernetes:Configure per-node network settings in a Terway cluster

Dernière mise à jour :Aug 11, 2026

Par défaut, les nœuds Terway utilisent la ConfigMap eni-config dans le namespace kube-system. Pour attribuer des vSwitches et des groupes de sécurité personnalisés à chaque nœud, créez une ConfigMap dédiée. Terway l'intègre à la configuration par défaut via un MergePatch (RFC 7396).

Cas d'utilisation

Configurez les paramètres réseau par nœud lorsque :

  • Isolation des IP sortantes : certains pods nécessitent des adresses IP NAT dédiées ou des limites de bande passante, distinctes du reste du cluster.

image

Prérequis

Assurez-vous d'avoir :

Considérations

  • Les interfaces réseau élastiques (ENI) existantes ne sont pas mises à jour automatiquement. Seules les ENI créées après la modification de la configuration utilisent les nouveaux vSwitches et groupes de sécurité. Mode ENI partagé (par défaut) : version de terway-eniip >= v1.0.10.237. Mode ENI exclusif : version de terway-eniip >= v1.14.5.

  • Les vSwitches doivent se trouver dans la même zone que le nœud. Un vSwitch situé dans une zone différente n'aura aucun effet.

  • Limite des groupes de sécurité. Attribuez jusqu'à 10 groupes de sécurité par ENI. Ils doivent tous appartenir au même VPC et être du même type. Consultez la rubrique Associer plusieurs groupes de sécurité à une ENI.

Configurer les paramètres réseau par nœud

Créez une ConfigMap avec les paramètres réseau souhaités, ajoutez des libellés aux nœuds cibles pour y faire référence, puis vérifiez que les nouvelles ENI utilisent les paramètres corrects.

Étape 1 : Créer une ConfigMap

Créez une ConfigMap nommée foo dans le namespace kube-system pour définir les vSwitches et les groupes de sécurité pour les nœuds étiquetés.

  1. Connectez-vous à la console ACK. Dans le volet de navigation de gauche, cliquez sur Clusters.

  2. Sur la page Clusters, cliquez sur le nom du cluster cible. Dans le volet de navigation de gauche, sélectionnez Configurations > ConfigMaps.

  3. Sur la page ConfigMap, sélectionnez kube-system dans la liste déroulante Namespace, puis cliquez sur Create.

  4. Dans le panneau Create, définissez le paramètre ConfigMap Name sur foo. Cliquez sur Add, définissez le paramètre Name sur eni_conf, et saisissez le code JSON suivant comme Value. Remplacez vswitches et security_group par vos ID réels.

    {
        "vswitches": {
            "cn-hangzhou-g": [
                "vsw-10000"
            ],
            "cn-hangzhou-i": [
                "vsw-10001"
            ]
        },
        "security_group": "sg-10000",
        "security_groups": [
            "sg-10000",
            "sg-10001"
        ]
    }
    Paramètre Description
    vswitches Une map des ID de zone vers les listes d'ID de vSwitch. Chaque vSwitch doit se trouver dans la même zone que les nœuds cibles. Recherchez les ID de zone et de vSwitch dans la console VPC sous vSwitch.
    security_group Pour attribuer un seul groupe de sécurité, définissez ce paramètre et laissez security_groups sur null.
    security_groups Pour attribuer plusieurs groupes de sécurité, définissez ce paramètre et laissez security_group sur null.
  5. Cliquez sur OK.

Étape 2 : Ajouter des libellés aux nœuds

Appliquez le libellé terway-config=foo aux nœuds qui doivent utiliser cette ConfigMap.

Pour les nœuds existants :

  1. Dans le volet de navigation de gauche de la page des détails du cluster, sélectionnez Nodes > Nodes. Cliquez sur Manage Labels and Taints.

  2. Sous l'onglet Labels, sélectionnez les nœuds cibles et cliquez sur Add Label.

  3. Dans la boîte de dialogue Add, définissez le paramètre Name sur terway-config et le paramètre Value sur foo, puis cliquez sur OK.

  4. Redémarrez les pods Terway pour appliquer la modification.

    1. Dans le volet de navigation de gauche, sélectionnez Workloads > Pods.

    2. Sélectionnez kube-system dans la liste déroulante Namespace, recherchez terway-eniip, sélectionnez tous les pods correspondants et cliquez sur Batch Delete.

    3. Cliquez sur OK. Kubernetes recrée les pods Terway.

    4. Attendez que la colonne Status affiche Running pour tous les pods terway-eniip. Les nouveaux paramètres prennent effet une fois que tous les pods sont en cours d'exécution.

Pour les nouveaux nœuds :

Lors de la création d'un pool de nœuds, ajoutez un libellé avec la key définie sur terway-config et la value définie sur foo.

Étape 3 : Vérifier la configuration

Après le redémarrage des pods Terway, vérifiez que les nouvelles ENI utilisent les vSwitches et les groupes de sécurité corrects.

  1. Connectez-vous à la console ECS. Dans le volet de navigation de gauche, sélectionnez Instances & Images > Instances.

  2. Cliquez sur le nom de l'instance ECS cible. Sur la page des détails, cliquez sur l'onglet ENIs.

  3. Vérifiez que l'ENI utilisée pour l'allocation des IP de pod est associée aux vSwitches et aux groupes de sécurité de la ConfigMap.

Remarque

Si l'adresse IP d'un nouveau pod ne se trouve pas dans le bloc CIDR du vSwitch attendu, consultez la rubrique FAQ sur les réseaux de conteneurs.