Tous les produits
Search
Centre de documentation

Container Service for Kubernetes:Deploy the NGINX Ingress Controller

Dernière mise à jour :Sep 29, 2026

Déployez ack-ingress-nginx-v1 dans les pools de nœuds cloud et edge d'un cluster ACK Edge afin de fournir un équilibrage de charge indépendant pour chaque edge unit.

Important

Le projet open source Ingress NGINX ne sera plus maintenu après mars 2026. Par conséquent, Container Service for Kubernetes cessera de maintenir le composant NGINX Ingress Controller. Prenez conscience des risques associés. Consultez l'annonce [[Product Announcement] End of Maintenance for the NGINX Ingress Controller Component](t3212739.xdita#)[Annonce produit] Fin de maintenance du Nginx Ingress Controller.

Contexte

Alibaba Cloud ACK Edge offre des fonctionnalités telles que l'autonomie en périphérie, les edge units, la gestion du trafic et la prise en charge native des API. Il permet une gestion unifiée du cycle de vie des applications et un ordonnancement des ressources adaptés aux scénarios d'informatique en périphérie (edge computing).

Notes d'utilisation

Tenez compte des points suivants lors du déploiement d'ack-ingress-nginx-v1 dans les pools de nœuds cloud et edge :

  • Le ACK Edge cluster doit être en version 1.19 ou ultérieure.

  • Déployez le composant plusieurs fois au sein du même ACK Edge cluster , mais utilisez un nom de release unique pour chaque déploiement. Utilisez un namespace distinct pour chaque déploiement afin de faciliter la gestion.

  • Avec les paramètres par défaut, ack-ingress-nginx-v1 est déployé dans le pool de nœuds par défaut du ACK Edge cluster.

Procédure

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

  2. Sous l'onglet Marketplace de la page App Catalog, recherchez et sélectionnez ack-ingress-nginx-v1.

  3. Sur la page du composant ack-ingress-nginx-v1, cliquez sur Deploy.

  4. Dans le panneau, sélectionnez un Cluster et un Namespace, puis saisissez un Release Name.

    Remarque

    Lors du déploiement d'ack-ingress-nginx-v1 dans un pool de nœuds, nommez la release selon le format ack-ingress-nginx-v1-{node-pool-name}. Par exemple : ack-ingress-nginx-v1-edge-hangzhou.

  5. Cliquez sur Next et configurez les paramètres sur la page Parameters.

    Depuis la console ACK, accédez à la page de gestion de votre cluster et choisissez Nodes > Node Pools dans le volet de navigation de gauche. Identifiez les ID de vos pools de nœuds cloud et edge pour la configuration nodeSelector.

    • Pour déployer dans un pool de nœuds cloud, configurez les paramètres suivants :

      • Dans le paramètre nodeSelector, ajoutez le libellé du pool de nœuds cloud : alibabacloud.com/nodepool-id: {node-pool-id}.

        Remarque

        Dans le champ nodeSelector, conservez uniquement alibabacloud.com/nodepool-id: {node-pool-id}.

        label

      • Dans le paramètre ingressClassResource, définissez name et controllerValue.

        Remarque

        Si vous déployez ack-ingress-nginx-v1 plusieurs fois dans le même ACK Edge cluster, assurez-vous que les valeurs name et controllerValue sont uniques pour chaque déploiement. Conventions de nommage recommandées :

        • name : ack-nginx-{node-pool-name}. Par exemple : ack-nginx-edge-hangzhou.

        • controllerValue : "k8s.io/ack-ingress-nginx-{node-pool-name}". Par exemple : "k8s.io/ack-ingress-nginx-edge-hangzhou".

        para

    • Pour déployer dans un pool de nœuds edge, configurez les paramètres suivants :

      • Dans le paramètre nodeSelector, ajoutez le libellé du pool de nœuds edge : alibabacloud.com/nodepool-id: {node-pool-id}.

        Remarque

        Dans le champ nodeSelector, conservez uniquement alibabacloud.com/nodepool-id: {node-pool-id}.

        label

      • Définissez global. edgeNodePool sur true. Cette action déclenche les effets suivants :

        • Le type de service du NGINX Ingress Controller passe de LoadBalancer à NodePort. Pour exposer les services edge à Internet, configurez séparément un équilibreur de charge avec une adresse IP publique.

        • L'image du NGINX Ingress Controller bascule vers un registre public afin d'éviter les échecs de pull d'image sur les nœuds edge.

        shezhi

      • Dans le paramètre ingressClassResource, définissez name et controllerValue.

        Remarque

        Si vous déployez ack-ingress-nginx-v1 plusieurs fois dans le même ACK Edge cluster, assurez-vous que les valeurs name et controllerValue sont uniques pour chaque déploiement. Conventions de nommage recommandées :

        • name : ack-nginx-{node-pool-name}. Par exemple : ack-nginx-edge-hangzhou.

        • controllerValue : "k8s.io/ack-ingress-nginx-{node-pool-name}". Par exemple : "k8s.io/ack-ingress-nginx-edge-hangzhou".

        para

  6. Cliquez sur OK.

  7. Dans le volet de navigation de gauche de la page de gestion du cluster, choisissez Applications > Helm.

    La page Helm confirme que le NGINX Ingress Controller est déployé.