组件介绍
ALB Ingress Controller基于阿里云应用型负载均衡 ALB ,提供了更为强大的Ingress流量管理方式。它兼容Nginx Ingress,具备处理复杂业务路由和证书自动发现的能力,支持HTTP、HTTPS和QUIC协议,完全满足在云原生应用场景下对超强弹性和大规模七层流量处理能力的需求。
ALB Ingress Controller通过API Server获取Ingress资源的变化,动态生成AlbConfig,然后依次创建ALB实例、监听、路由转发规则以及后端服务器组。您可以在ACS集群中部署该组件,通过配置ALB Ingress实现Ingress流量管理。
变更记录
2026年10月
版本号 | 变更时间 | 变更内容 | 变更影响 |
v3.2.1 | 2026年10月20日 | 新增功能: Gateway API 支持在 Gateway.status.addresses 中展示关联的 ALB 实例 ID。 组件升级预检支持 ALB Gateway API 资源。 Gateway API 支持通过 AlbInstance.spec.listeners 按协议和端口配置监听描述、超时时间、Gzip、TLS 安全策略、双向认证、XFF、日志及标签。 Gateway API 支持通过 AlbRule 配置插入请求头动作。 Gateway API 支持通过 AlbInstance 配置 ALB 实例关联的安全组。 支持通过证书 ID 为 Gateway HTTPS 监听配置服务端证书和 CA 证书。 支持为 HTTPS 监听配置多个 CA 证书。
优化: 为 Gateway 和 AlbServiceExtension 增加调谐 Hash,Controller 重启后配置未变化的资源将跳过重复调谐。 增加 ALBReconciled 和 ALBAppliedHash 状态,用于查看调谐结果和最近一次成功应用的 Hash。 优化 ALB GatewayClass 的引用保护。仍被 Gateway 使用的 GatewayClass 将受到 Finalizer 保护。 新建 Gateway 监听默认开启 XFF;已有监听未指定处理模式时保留云端 XFF 开关状态。 组件升级预检支持识别双向认证开关及 CA 证书变更。
缺陷修复: 修复 Namespace 标签变化未触发相关 Gateway 调谐的问题。 修复更新 ReferenceGrant 或 AlbServerGroup 的引用目标后,原关联 Gateway 未及时重新调谐的问题。 修复 TCP 健康检查未忽略 HTTP 专属参数导致预检误报问题。 修复非 HTTPS 监听未忽略 QuicConfig 导致预检误报问题。 修复 XForwardedForClientCertSubjectDNAlias 被错误设置为 XForwardedForClientCertIssuerDNAlias 的问题。 修复同一 HTTPRoute 引用不同 Namespace 下同名、同端口 Service 时,服务器组 Resource ID 冲突导致后端服务器组错误复用的问题。
| 此次升级不会对业务造成影响。 |
2026年09月
版本号 | 变更时间 | 变更内容 | 变更影响 |
v3.1.1 | 2026年09月03日 | 缺陷修复: | 此次升级不会对业务造成影响。 |
2026年08月
版本号 | 变更时间 | 变更内容 | 变更影响 |
v3.1.0 | 2026年08月10日 | 新增功能: 优化: 缺陷修复: | 此次升级不会对业务造成影响。 |
2026年07月
版本号 | 变更时间 | 变更内容 | 变更影响 |
v3.0.0 | 2026年07月06日 | 新增功能: 支持通过 Gateway API 创建和管理 ALB 扩展版实例。 支持通过 AlbRule 为 ALB 扩展版实例的转发规则关联服务扩展 ID。 支持通过 AlbServerGroup 为 ALB 扩展版实例的服务器组关联服务扩展 ID。 支持 AlbInstance 自定义 CRD,允许用户通过 Gateway 资源的 infrastructure.parametersRef 引用定义 ALB 实例配置,例如地址类型、可用区、日志、带宽包等,部分属性仅实例创建时生效。 通过 Gateway API 创建出的 ALB 标准版实例默认启用实例托管模式。对于通过 Gateway API 新建的 ALB 标准版实例,其监听和转发规则配置将无法在 ALB 控制台手动修改。该限制仅适用于升级到本版本后新建的 ALB 实例,已有实例不受影响。
优化: 通过 Gateway API 新建服务器组时默认启用后端长连接。已经创建的服务器组不受影响,请在升级前确认该行为变化是否会对业务产生影响。 Gateway API 默认使用 EndpointSlice 代替 Endpoints 进行端点发现。 支持通过 Gateway API 使用多端口 Service。 支持通过 Gateway API 使用 ReadinessGate。当前仅 Terway 网络插件支持,Flannel 网络插件暂不支持。
缺陷修复: 修复 Gateway API 服务发现异常后未自动重试的问题。 修复关联有 HTTPRoute 的 Gateway 资源删除阻塞问题。 修复监听证书异常后直接删除监听的问题,调整为证书异常时阻塞并报错。 修复 Gateway API 场景下 Service 删除后服务器组未及时清空的问题。
| 此次升级不会对业务造成影响。 |
2026年06月
版本号 | 变更时间 | 变更内容 | 变更影响 |
v2.20.1 | 2026年06月08日 | 优化: 缺陷修复: | 此次升级不会对业务造成影响。 |
2026年04月
版本号 | 变更时间 | 变更内容 | 变更影响 |
v2.20.0 | 2026年04月16日 | 新增功能: 支持在ListenerSpec的logConfig中通过accessLogRecordCustomizedHeadersAllowDisable: true允许将accessLogRecordCustomizedHeadersEnabled设置为false。 Webhook中新增对仍在被ALB Ingress使用的Service/Secret资源的删除拦截。 Webhook中新增对path类型为Prefix时,path中不能包含通配符*的校验。
优化: 缺陷修复: | 此次升级不会对业务造成影响。 |
2026年01月
版本号 | 变更时间 | 变更内容 | 变更影响 |
v2.19.0 | 2026年01月07日 | 新增功能: 优化: 缺陷修复: | 此次升级不会对业务造成影响。 |
2025年07月
版本号 | 变更时间 | 变更内容 | 变更影响 |
v2.18.0-aliyun.1 | 2025年07月04日 | 默认启用实例托管模式。对于通过 AlbConfig自动新建的ALB实例,其监听和转发规则配置将无法在ALB控制台手动修改。该限制仅适用于升级到本版本后新建的ALB实例,已有实例和复用的实例不受影响。 支持在AlbConfig中通过defaultCertificate手动指定默认证书。 优化转发规则的优先级排序逻辑,取消order全局唯一限制。 修复在查询异步任务接口时,因流控可能导致Controller Panic的问题。 修复当HTTPS和QUIC监听共用同个端口时,ACL仅在一个监听上生效的问题。 在readinessGate等待未就绪Pod时,采用固定等待间隔。 优化Admission Webhook中对不包含终结型转发动作的校验逻辑。
| 此次升级不会对业务造成影响。 |
2025年03月
版本号 | 变更时间 | 变更内容 | 变更影响 |
v2.17.2-aliyun.1 | 2025年03月31日 | 修复当多个命名空间Ingress规则指向的Service名称相同,但端口不同时,服务器组调谐报错端口不存在的问题。 修复IPv6双栈集群下,查询IPv4类型地址参数错误的问题。 分批调用加入或移出安全组API时,单次最大安全组数量由4调整为9。 当无需添加额外标签时,跳过API调用。
| 此次升级不会对业务造成影响。 |
v2.17.1-aliyun.1 | 2025年03月18日 | | 此次升级不会对业务造成影响。 |
v2.16.0-aliyun.1 | 2025年03月04日 |
重要 自该版本起,新建服务器组将默认开启后端长连接能力,已经创建的服务器组不受影响。请在升级前确认该行为变化是否会对业务产生影响。 | 此次升级不会对业务造成影响。 |
2025年01月
版本号 | 变更时间 | 变更内容 | 变更影响 |
v2.15.2-aliyun.1 | 2025年01月24日 | 支持在监听的XForwardedForConfig中配置XForwardedForProcessingMode设置X-Forwarded-For的处理模式,XForwardedForHostEnabled设置开启X-Forwarded-Host请求头。 修复当ValidatingWebhookConfiguration不存在时组件无法启动的问题。 修复alb.ingress.kubernetes.io/healthcheck-httpcode配置多个值时Webhook校验不通过的问题。 添加对转发动作不包含FinalType类型时的检查。 优化创建ALB实例时clientToken的计算方式。
| |
v2.15.0-aliyun.1 | 2025年01月06日 | 默认开启ValidatingWebhook,对AlbConfig和Ingress配置进行预检。 支持配置AScript可编程脚本。 限速能力支持设置固定响应。 兼容ssl-redirect与限速能力同时使用。 服务器组会话保持支持自定义Cookie。 支持为新建的ALB实例配置安全组。(从北京时间2025年2月25日00:00:00起) 优化监听冲突时的报错。 添加TLS证书配置与转发规则证书不一致时的事件通知。 添加对关联资源(如带宽包)有效性的校验。 gRPC协议支持通过AlbConfig配置证书。 修复开启创建者标签功能后不能使用AlbConfig中tag功能的问题。 修复部分场景下Service调谐持续报错的问题。 修复AlbConfig配置错误时导致组件崩溃的问题。
| 此次升级不会对业务造成影响。 |
2024年05月
版本号 | 变更时间 | 变更内容 | 变更影响 |
v2.13.1-aliyun.1 | 2024年05月10日 | | 此次升级不会对业务造成影响。 |