Tous les produits
Search
Centre de documentation

Container Compute Service:ALB Ingress Controller

Dernière mise à jour :Sep 25, 2026

L'ALB Ingress Controller utilise Alibaba Cloud Application Load Balancer (ALB) pour gérer le trafic Ingress. Cette rubrique présente une vue d'ensemble du composant, des instructions d'utilisation et les notes de version.

Présentation du composant

L'ALB Ingress Controller s'appuie sur Alibaba Cloud Application Load Balancer (ALB) et offre des fonctionnalités avancées de gestion du trafic Ingress. Compatible avec Nginx Ingress, il prend en charge le routage métier complexe, la découverte automatique des certificats ainsi que les protocoles HTTP, HTTPS et QUIC. Il constitue donc une solution idéale pour les applications cloud natives nécessitant une grande élasticité et un traitement du trafic de couche 7 à grande échelle.

L'ALB Ingress Controller surveille l'API server pour détecter les modifications apportées aux ressources Ingress, génère dynamiquement un AlbConfig, puis crée ou met à jour les instances ALB, les écouteurs, les règles de transfert et les groupes de serveurs backend requis. Déployez ce composant dans votre cluster Container Service for Kubernetes (ACK) afin de gérer le trafic Ingress en configurant des ressources ALB Ingress.

Instructions d'utilisation

Pour savoir comment utiliser l'ALB Ingress Controller, consultez la rubrique Gérer les ALB Ingresses.

Notes de version

Septembre 2026

Numéro de version

Date de modification

Modifications

Impact

v3.1.1

3 septembre 2026

Corrections de bugs :

  • Correction d'un bug entraînant l'utilisation incorrecte des endpoints publics par l'API Application Load Balancer (ALB), ce qui provoquait l'échec des contrôleurs dans les VPC non publics et certaines régions.

Cette mise à niveau n'affecte pas vos services.

Août 2026

Numéro de version

Date de modification

Modifications

Impact

v3.1.0

10 août 2026

Nouvelles fonctionnalités :

  • Ajout de la prise en charge de Gateway API pour la gestion déclarative des extensions de service pour Application Load Balancer (ALB) Extended Edition à l'aide de la ressource AlbServiceExtension. Ces extensions peuvent être référencées dans les règles de transfert ou les groupes de serveurs backend.

  • Ajout de la prise en charge de la configuration des backends de type Fqdn et IpSegment pour ALB Extended Edition à l'aide de la ressource AlbService. Ces backends peuvent être référencés dans une ressource HTTPRoute.

Optimisations :

  • Optimisation de la logique de mise à jour des règles de transfert afin d'éviter les mises à jour invalides déclenchées par un ordre de retour incohérent des groupes de serveurs backend. Ce problème entraînait auparavant l'échec des exécutions à blanc (dry runs).

  • Correction d'un problème empêchant l'analyse ou la transmission correcte des codes d'état de vérification d'état (health check) selon le protocole de vérification dans certains scénarios, ce qui causait l'échec des exécutions à blanc.

Corrections de bugs :

  • Correction d'un problème pouvant empêcher la réconciliation rapide d'un Service après un changement de nœud si externalTrafficPolicy est défini sur le mode Local.

Cette mise à niveau n'affecte pas vos services.

Juillet 2026

Numéro de version

Date de modification

Contenu des modifications

Impact des modifications

v3.0.0

6 juillet 2026

Nouvelles fonctionnalités :

  • Ajout de la prise en charge de la création et de la gestion des instances ALB Extended Edition via Gateway API.

  • Ajout de la prise en charge de l'association des ID d'extension de service aux règles de transfert pour les instances ALB Extended Edition à l'aide d'AlbRule.

  • Ajout de la prise en charge de l'association des ID d'extension de service aux groupes de serveurs pour les instances ALB Extended Edition à l'aide d'AlbServerGroup.

  • Ajout de la prise en charge du CRD personnalisé AlbInstance. Cela vous permet de définir les configurations des instances ALB, telles que le type d'adresse, la zone de disponibilité, les journaux et les packages de bande passante, en référençant infrastructure.parametersRef dans les ressources Gateway. Certaines propriétés ne prennent effet qu'à la création de l'instance.

  • Les instances ALB Standard Edition créées via Gateway API ont le mode de gestion d'instance activé par défaut. Pour ces instances, les configurations des écouteurs et des règles de transfert ne peuvent pas être modifiées manuellement dans la console ALB. Cette restriction s'applique uniquement aux instances ALB créées après la mise à niveau vers cette version. Les instances existantes ne sont pas affectées.

Optimisations :

  • Les connexions persistantes backend sont désormais activées par défaut lors de la création d'un groupe de serveurs via Gateway API. Les groupes de serveurs existants ne sont pas affectés. Avant la mise à niveau, vérifiez si ce changement de comportement impacte vos services.

  • Gateway API utilise désormais EndpointSlice au lieu d'Endpoints pour la découverte des endpoints par défaut.

  • Ajout de la prise en charge des Services multi-ports avec Gateway API.

  • Ajout de la prise en charge de ReadinessGate avec Gateway API. Cette fonctionnalité est uniquement prise en charge par le plugin réseau Terway. Le plugin réseau Flannel n'est pas encore pris en charge.

Corrections de bugs :

  • Correction d'un problème empêchant Gateway API de retenter automatiquement après une erreur de découverte de service.

  • Correction d'un problème bloquant la suppression des ressources Gateway associées à une HTTPRoute.

  • Correction d'un problème entraînant la suppression immédiate d'un écouteur après une erreur de certificat. Désormais, l'opération est bloquée et une erreur est signalée en cas d'erreur de certificat.

  • Correction d'un problème empêchant la vidange rapide du groupe de serveurs après la suppression d'un Service dans les scénarios Gateway API.

Cette mise à niveau n'affecte pas vos services.

Juin 2026

Version

Date

Modifications

Impact

v2.20.1

8 juin 2026

Optimisations :

  • Augmentation du temps d'attente et du nombre de tentatives pour les tâches asynchrones.

Corrections de bugs :

  • Correction d'un bug empêchant les clusters exécutant la version 1.20 ou antérieure de basculer d'EndpointSlice vers Endpoints pour la découverte des endpoints.

Aucun impact sur les services.

Avril 2026

Version

Date de publication

Modifications

Impact

v2.20.0

16 avril 2026

Nouvelles fonctionnalités :

  • Ajout de la prise en charge de la définition de accessLogRecordCustomizedHeadersEnabled sur false en spécifiant accessLogRecordCustomizedHeadersAllowDisable: true dans logConfig de ListenerSpec.

  • Le webhook empêche désormais la suppression d'un Service ou d'un Secret utilisé par un ALB Ingress.

  • Une validation a été ajoutée aux webhooks pour garantir que lorsque le type de path est Prefix, le path ne peut pas contenir le caractère générique *.

Améliorations :

  • Réduction de l'empreinte mémoire du contrôleur.

  • Le contrôleur utilise désormais EndpointSlice au lieu d'Endpoints pour la découverte des endpoints par défaut.

  • Optimisation du temps d'attente pour les tâches asynchrones de groupe de serveurs.

Corrections de bugs :

  • Correction d'un problème empêchant la prise en compte des modifications de l'ID de groupe de ressources ALB dans AlbConfig.

  • Correction d'un problème où une configuration de transfert invalide pour une règle de transfert personnalisée pouvait provoquer un plantage (panic) du contrôleur.

Cette mise à niveau n'a aucun impact sur vos charges de travail.

Janvier 2026

Version

Date de publication

Modifications

Impact

v2.19.0

7 janvier 2026

Nouvelles fonctionnalités :

  • Prise en charge du rechargement à chaud du secret spécifié dans defaultCertificate.

  • Prise en charge de la configuration d'un ingress avec les actions rate limiting + fixed response/redirect + forward.

Améliorations :

  • Amélioration du message d'erreur affiché lors de l'échec de la création d'un écouteur dû à un certificat expiré.

  • Amélioration des performances de réconciliation du contrôleur.

  • Renforcement de la validation webhook pour vérifier les éléments suivants :

    • Le format du champ SourceIP dans les conditions de transfert personnalisées.

    • Si le champ AclType est défini sur black ou white.

    • Les backends Ingress qui spécifient service.name sans service.port.

  • Ajout d'une vérification webhook pour déterminer si un Ingress est un ALB Ingress.

Corrections de bugs :

  • Correction d'un problème empêchant la suppression des tags d'une instance ALB lorsque le champ tags était supprimé d'AlbConfig.

  • Correction d'un plantage rare du contrôleur lors de la suppression d'un service.

Cette mise à niveau n'a aucun impact sur vos charges de travail.

Juillet 2025

Version

Date de publication

Description

Impact

v2.18.0-aliyun.1

4 juillet 2025

  • Le mode de gestion d'instance est activé par défaut. Les configurations des écouteurs et des règles de transfert pour les instances ALB créées automatiquement via un AlbConfig ne peuvent plus être modifiées manuellement dans la console ALB. Cette restriction s'applique uniquement aux nouvelles instances ALB créées après cette mise à niveau ; les instances existantes et réutilisées ne sont pas affectées.

  • Vous pouvez désormais spécifier un certificat par défaut dans un AlbConfig à l'aide du champ defaultCertificate.

  • Optimisation de la logique de tri des priorités pour les règles de transfert et suppression de l'exigence d'unicité globale pour le champ order.

  • Correction d'un problème pouvant provoquer un plantage du contrôleur en raison du contrôle de flux lors de l'interrogation de l'API de tâche asynchrone.

  • Correction d'un problème où une ACL ne s'appliquait qu'à un seul écouteur lorsque les écouteurs HTTPS et QUIC partageaient le même port.

  • Le readinessGate utilise désormais un intervalle fixe lors de l'attente des pods non prêts.

  • Optimisation de la logique de validation du webhook d'admission pour les règles de transfert qui n'incluent pas d'action de terminaison.

Cette mise à niveau n'affectera pas vos services.

Mars 2025

Version

Date de publication

Modifications

Impact

v2.17.2-aliyun.1

31 mars 2025

  • Correction d'un échec de réconciliation du groupe de serveurs provoquant une erreur « port introuvable » lorsque des règles Ingress dans plusieurs namespaces pointaient vers des Services portant le même nom mais utilisant des ports différents.

  • Correction d'une erreur de paramètre invalide lors de l'interrogation des adresses IPv4 dans un cluster à double pile IPv6.

  • Augmentation du nombre maximal de groupes de sécurité pouvant être ajoutés ou supprimés en un seul appel d'API par lot, passant de 4 à 9.

  • Ignorer les appels d'API lorsqu'aucun tag supplémentaire n'est requis.

Cette mise à niveau n'affecte pas vos services.

v2.17.1-aliyun.1

18 mars 2025

  • Ajout de la prise en charge de Gateway API v1.1.0 et versions ultérieures.

Cette mise à niveau n'affecte pas vos services.

v2.16.0-aliyun.1

4 mars 2025

Important

À partir de cette version, les connexions persistantes backend sont activées par défaut pour les nouveaux groupes de serveurs. Les groupes de serveurs existants ne sont pas affectés. Avant la mise à niveau, vérifiez si ce changement impacte vos services.

  • Activation de la connexion persistante par défaut pour les nouveaux groupes de serveurs.

  • Les écouteurs prennent désormais en charge les tags personnalisés.

  • Ajout d'une option pour désactiver la fonctionnalité inter-zones pour les groupes de serveurs.

  • Amélioration des performances globales de réconciliation des Services.

  • Amélioration du timing des mises à jour du statut ReadinessGate pour les Pods. Le statut du Pod n'est mis à jour qu'après la réussite de chaque mise à jour du groupe de serveurs associé.

  • Les déploiements Canary nécessitent désormais deux Ingress distincts ou des actions de transfert personnalisées. Si une annotation canary est ajoutée incorrectement à un Ingress, le système signale une erreur et conserve les règles de transfert d'origine.

Cette mise à niveau n'affecte pas vos services.

Janvier 2025

Version

Date de publication

Modifications

Impact

v2.15.2-aliyun.1

24 janvier 2025

  • Dans la section XForwardedForConfig d'un écouteur, vous pouvez configurer XForwardedForProcessingMode pour définir le mode de traitement de l'en-tête X-Forwarded-For, et définir XForwardedForHostEnabled pour activer l'en-tête de requête X-Forwarded-Host.

  • Correction d'un problème empêchant le démarrage du composant lorsque ValidatingWebhookConfiguration est absent.

  • Correction d'un problème où la validation Webhook échouait lorsque alb.ingress.kubernetes.io/healthcheck-httpcode était configuré avec plusieurs valeurs.

  • Ajout d'une vérification des actions de transfert qui n'incluent pas le type FinalType.

  • Optimisation du calcul de clientToken lors de la création d'une instance ALB.

v2.15.0-aliyun.1

6 janvier 2025

  • ValidatingWebhook est désormais activé par défaut pour prévalider les configurations AlbConfig et Ingress.

  • Prise en charge des scripts programmables AScript.

  • La fonctionnalité de limitation de débit prend désormais en charge les réponses fixes.

  • Les fonctionnalités ssl-redirect et de limitation de débit sont désormais compatibles.

  • La persistance de session pour les groupes de serveurs prend désormais en charge les cookies personnalisés.

  • Prise en charge de la configuration des groupes de sécurité pour les nouvelles instances ALB. (Effectif à partir du 25 février 2025 à 00:00:00, UTC+8)

  • Amélioration des messages d'erreur en cas de conflit d'écouteur.

  • Le contrôleur envoie désormais des notifications d'événement en cas d'incohérence entre les configurations de certificat TLS et les certificats des règles de transfert.

  • Le contrôleur valide désormais les ressources associées, telles que les plans de bande passante.

  • Le protocole gRPC prend désormais en charge la configuration des certificats dans AlbConfig.

  • Correction d'un problème empêchant l'utilisation de la fonctionnalité de tags dans AlbConfig après l'activation de la fonctionnalité de tag de créateur.

  • Correction d'un problème où la réconciliation des Services signalait continuellement des erreurs dans certains scénarios.

  • Correction d'un problème où une configuration AlbConfig incorrecte provoquait l'arrêt du composant.

Cette mise à niveau n'affecte pas vos services.

Mai 2024

Version

Date de publication

Modifications

Impact

v2.13.1-aliyun.1

10 mai 2024

  • Le contrôleur envoie désormais un événement lorsqu'un AlbConfig n'est associé à aucun Ingress.

  • Correction d'un échec de création de groupe de serveurs causé par un namespace commençant par un chiffre ou par un nom de namespace ou de service trop long.

Cette mise à niveau n'affecte pas vos services.