Azure AKS中Application Gateway for Containers的ALB控制器注解使用指南

Azure AKS中Application Gateway for Containers的ALB控制器注解使用指南

AKS Azure Kubernetes Service 项目地址: https://gitcode.com/gh_mirrors/ak/AKS

背景概述

在Azure Kubernetes Service(AKS)环境中，Application Gateway for Containers作为新一代负载均衡解决方案，提供了两种主要的部署策略：托管部署(Managed)和自带部署(BYO)。这两种策略在使用ALB控制器进行Ingress配置时，需要特别注意注解(annotations)的正确使用方式。

核心注解解析

ALB控制器目前支持四个关键注解，这些注解构成了与Application Gateway for Containers交互的基础：

1. alb.networking.azure.io/alb-namespace
   专门用于引用ApplicationLoadBalancer自定义资源(CR)，指定资源所在的命名空间。

2. alb.networking.azure.io/alb-name
   配合alb-namespace使用，共同定位特定的ApplicationLoadBalancer CR，适用于托管部署模式。

3. alb.networking.azure.io/alb-id
   自带部署(BYO)模式下的核心注解，用于将Ingress与已存在的Application Gateway for Containers资源关联。需要提供完整的Azure资源ID。

4. alb.networking.azure.io/alb-ingress-extension
   当需要引用IngressExtension自定义资源时使用，用于扩展Ingress功能。

部署策略与注解选择

托管部署模式

在Azure完全托管的部署场景中，主要使用：

• alb-name + alb-namespace组合 这种方式允许ALB控制器自动创建和管理相关资源。

自带部署模式

当企业需要自主控制资源命名和配置时，应采用：

• alb-id注解 这种方式需要预先创建好Application Gateway for Containers资源，并通过资源ID进行绑定。

实践建议

1. 避免策略混用
   两种部署策略的注解不应混合使用，这会导致配置失效。

2. 文档查阅技巧
   Azure官方文档已按部署策略分类，通过选项卡区分不同场景的配置示例，查阅时需注意选择正确的策略标签。

3. 注解演进
   与传统的Application Gateway Ingress Controller(AGIC)不同，ALB控制器有意保持精简的注解集，更多功能通过自定义资源实现。

典型问题排查

若发现Ingress无法正确关联负载均衡器，应检查：

• 部署策略与注解是否匹配
• BYO模式下资源ID格式是否正确
• 托管模式下CR资源是否存在

通过理解这些核心注解的适用场景和限制，可以更高效地在AKS环境中配置Application Gateway for Containers，实现灵活的流量管理需求。

AKS Azure Kubernetes Service 项目地址: https://gitcode.com/gh_mirrors/ak/AKS