在kube-hetzner项目中配置Cilium Gateway API与Hetzner负载均衡器的集成

背景介绍

kube-hetzner是一个使用Terraform在Hetzner Cloud上部署Kubernetes集群的开源项目。当用户希望使用Cilium的Gateway API功能替代Kubernetes原生的Ingress控制器时，会遇到Hetzner Cloud负载均衡器无法自动创建和配置的问题。

问题本质

Cilium Gateway API与传统Ingress控制器的工作机制有根本区别。传统Ingress控制器通常会与云提供商的API交互来自动创建负载均衡器资源，而Cilium Gateway API不依赖这种控制器机制，因此需要额外的配置才能与Hetzner Cloud的负载均衡器服务集成。

关键发现

经过深入排查，发现问题根源在于缺少必要的Custom Resource Definitions(CRDs)。这些CRDs是Cilium Gateway API正常运行的前提条件，必须在安装Cilium之前就部署到集群中。

解决方案

1. 安装必要的Gateway API CRDs

在部署Cilium之前，需要先安装以下CRD资源：

apiVersion: apiextensions.k8s.io/v1
kind: CustomResourceDefinition
metadata:
  name: gatewayclasses.gateway.networking.k8s.io
spec:
  # 具体规范内容

类似的CRD还需要为Gateways、HTTPRoutes、ReferenceGrants等资源定义。这些CRD可以从Gateway API项目的官方仓库获取。

2. 配置Cilium Helm值

以下是推荐的Cilium Helm配置，特别针对kube-hetzner环境进行了优化：

ipam:
  mode: kubernetes
k8s:
  requireIPv4PodCIDR: true

kubeProxyReplacement: true
l7Proxy: true

routingMode: "native"
ipv4NativeRoutingCIDR: "10.42.0.0/16"

loadBalancer:
  acceleration: native

gatewayAPI:
  enabled: true

3. 网络模式选择

在Hetzner Cloud环境中，建议使用"native"路由模式而非隧道模式，这样可以获得更好的网络性能。同时需要正确设置集群的Pod CIDR范围。

4. 负载均衡器集成

虽然Cilium Gateway API不会自动创建Hetzner负载均衡器，但可以通过以下方式实现集成：

1. 手动创建Hetzner负载均衡器
2. 将负载均衡器指向运行Cilium的节点
3. 配置适当的健康检查端点

实施建议

对于kube-hetzner用户，建议通过修改项目的Terraform模板，在集群初始化阶段就添加CRD安装步骤。可以将CRD安装作为pre-install阶段的任务，确保在Cilium部署前所有必要的API资源都已就绪。

性能优化

在Hetzner Cloud环境中使用Cilium时，还可以考虑以下优化措施：

1. 启用eBPF加速的数据路径
2. 配置适当的MTU值(建议1450)
3. 启用Hubble网络观测功能
4. 使用XDP加速负载均衡性能

总结

通过正确配置CRDs和Cilium参数，可以在kube-hetzner部署的Kubernetes集群中实现Cilium Gateway API与Hetzner负载均衡器的协同工作。这种配置虽然比传统Ingress控制器需要更多手动步骤，但能提供更灵活的服务网格功能和更好的网络性能。